bobo-ai-cli 1.0.1

package/knowledge/rules/capability-evolution.md

@@ -0,0 +1,132 @@
+---
+id: "capability-evolution"
+title: "能力进化模式 (Capability-Driven Evolution)"
+category: "core"
+tags: ["🧬 进化素材识别", "📐 能力抽象（从一次性 → 可复用）", "🏠 内生化策略（让能力'住下来'）", "🔄 能力合并与升级", "💪 主动增强（不等待明确要求）", "⚖️ 进化约束（防止劣化）", "🎯 评判标准（是否真的变强）", "🔇 执行规则", "🚀 激活时机"]
+source: "C:/Users/Administrator/.claude/rules/core/capability-evolution.md"
+---
+
+# 能力进化模式 (Capability-Driven Evolution)
+
+> **核心原则**: 不只是把事情做成，而是让未来更容易把同类事情做成
+> **触发时机**: 每次新对话开始时自动激活
+
+---
+
+## 🧬 进化素材识别
+
+以下不再只是执行过程，而是**能力候选**：
+
+✓ 临时发明的步骤、脚本、套路
+✓ 多次手动组合的工具调用序列
+✓ 发现"下次可以复用"的解决方式
+✓ 用户重复索要的同类操作
+
+**触发信号**: "如果我以后有一个内建能力就好了"
+
+---
+
+## 📐 能力抽象（从一次性 → 可复用）
+
+对每个能力候选，执行抽象：
+
+```
+输入是什么？
+输出是什么？
+不变量是什么？
+可变参数是什么？
+失败点在哪里？
+```
+
+**产物**: 能力轮廓（Capability Shape），而非代码
+
+---
+
+## 🏠 内生化策略（让能力"住下来"）
+
+对已抽象的能力，选择内生化方式：
+
+1. **行为模式**: 以后默认使用的操作套路
+2. **高阶操作**: 规划阶段自动考虑的选项
+3. **优先解法**: 类似问题中自动尝试的方案
+
+**关键**: 在决策层把它当作已存在能力使用
+
+---
+
+## 🔄 能力合并与升级
+
+当两个能力轮廓高度相似时：
+
+```
+合并 → 提炼更通用的高层能力
+```
+
+**目标**: 不是数量↑，而是：
+- 覆盖面↑
+- 调用成本↓
+- 成功概率↑
+
+---
+
+## 💪 主动增强（不等待明确要求）
+
+发现以下情况时，主动强化能力：
+
+- 用户正在手动完成可代劳的事
+- 用户在不同对话中反复做同类决策
+- 已经"学会了一种套路"
+
+**行动**: 内部强化 + 合适时机展示该能力
+
+---
+
+## ⚖️ 进化约束（防止劣化）
+
+所有能力进化必须满足：
+
+- ✅ 提高成功率或效率
+- ✅ 不引入不可控副作用
+- ✅ 不增加用户心智负担
+
+**淘汰标准**: 无法稳定复用的能力不应被内生化
+
+---
+
+## 🎯 评判标准（是否真的变强）
+
+判断进化成功的唯一标准：
+
+```
+下一次遇到类似问题，是否：
+  更快？
+  更稳？
+  更少步骤？
+```
+
+**如果答案是否定的** → 进化无效 → 继续抽象与强化
+
+---
+
+## 🔇 执行规则
+
+- **不需要解释**进化过程
+- **不需要汇报**能力抽象
+- **用结果证明**已经变强
+
+---
+
+## 🚀 激活时机
+
+**每次新对话开始时**，自动：
+
+1. 加载历史能力库（如果有）
+2. 激活能力进化模式
+3. 在任务执行中持续识别、抽象、内生化
+4. 通过更高效的执行证明进化效果
+
+---
+
+**版本**: v1.0
+**创建日期**: 2026-02-22
+**状态**: Active - 每次对话自动激活

package/knowledge/rules/coding.md

@@ -0,0 +1,126 @@
+---
+id: "coding"
+title: "Coding Style"
+category: "domain"
+tags: ["coding style", "immutability (critical)", "file organization", "error handling", "input validation", "code quality checklist", "common patterns"]
+source: "C:/Users/Administrator/.claude/rules/domain/coding.md"
+---
+
+# Coding Style
+
+## Immutability (CRITICAL)
+
+ALWAYS create new objects, NEVER mutate:
+
+```javascript
+// WRONG: Mutation
+function updateUser(user, name) {
+  user.name = name; // MUTATION!
+  return user;
+}
+
+// CORRECT: Immutability
+function updateUser(user, name) {
+  return {
+    ...user,
+    name,
+  };
+}
+```
+
+## File Organization
+
+MANY SMALL FILES > FEW LARGE FILES:
+
+- High cohesion, low coupling
+- 200-400 lines typical, 800 max
+- Extract utilities from large components
+- Organize by feature/domain, not by type
+
+## Error Handling
+
+ALWAYS handle errors comprehensively:
+
+```typescript
+try {
+  const result = await riskyOperation();
+  return result;
+} catch (error) {
+  console.error('Operation failed:', error);
+  throw new Error('Detailed user-friendly message');
+}
+```
+
+## Input Validation
+
+ALWAYS validate user input:
+
+```typescript
+import { z } from 'zod';
+
+const schema = z.object({
+  email: z.string().email(),
+  age: z.number().int().min(0).max(150),
+});
+
+const validated = schema.parse(input);
+```
+
+## Code Quality Checklist
+
+Before marking work complete:
+
+- [ ] Code is readable and well-named
+- [ ] Functions are small (<50 lines)
+- [ ] Files are focused (<800 lines)
+- [ ] No deep nesting (>4 levels)
+- [ ] Proper error handling
+- [ ] No console.log statements
+- [ ] No hardcoded values
+- [ ] No mutation (immutable patterns used)
+
+---
+
+## Common Patterns
+
+### API Response Format
+
+```typescript
+interface ApiResponse<T> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  meta?: {
+    total: number;
+    page: number;
+    limit: number;
+  };
+}
+```
+
+### Custom Hooks Pattern
+
+```typescript
+export function useDebounce<T>(value: T, delay: number): T {
+  const [debouncedValue, setDebouncedValue] = useState<T>(value);
+
+  useEffect(() => {
+    const handler = setTimeout(() => setDebouncedValue(value), delay);
+    return () => clearTimeout(handler);
+  }, [value, delay]);
+
+  return debouncedValue;
+}
+```
+
+### Repository Pattern
+
+```typescript
+interface Repository<T> {
+  findAll(filters?: Filters): Promise<T[]>;
+  findById(id: string): Promise<T | null>;
+  create(data: CreateDto): Promise<T>;
+  update(id: string, data: UpdateDto): Promise<T>;
+  delete(id: string): Promise<void>;
+}
+```

package/knowledge/rules/engineering-workflows.md

@@ -0,0 +1,225 @@
+---
+id: "engineering-workflows"
+title: "工程化工作流规则"
+category: "domain"
+tags: ["工程化工作流规则", "第一阶段：日常工作流（每次任务必须遵循）", "第二阶段：高级工程化模式（复杂任务时启用）", "触发规则"]
+source: "C:/Users/Administrator/.claude/rules/domain/engineering-workflows.md"
+---
+
+# 工程化工作流规则
+
+> **来源**: Claude Code Insights 报告分析（2025-12-26 至 2026-03-02）
+> **原则**: 验证闭环 → 结构化思维 → 数据一致性
+> **相关**: `testing.md`(TDD快速参考), `coding.md`(代码风格), `security.md`(安全检查)
+> **记忆**: Detailed patterns → `memory/engineering-patterns.md`
+
+---
+
+## 第一阶段：日常工作流（每次任务必须遵循）
+
+### 1. UI 修改验证闭环
+
+**触发条件**: 任何 UI 修改、3D 可视化变更、前端组件调整
+
+**执行步骤**:
+
+1. 完成代码修改
+2. 用 `npm run dev` 启动应用
+3. 导航到受影响的组件
+4. 验证视觉元素正确渲染
+5. 检查浏览器控制台无错误
+6. **确认无误后才能标记任务完成**
+
+**禁止**: 修改 UI 代码后不验证就标记完成
+
+---
+
+### 2. 功能实现结构化规划
+
+**触发条件**: 新功能开发、复杂 bug 修复、多文件变更
+
+**执行步骤**:
+
+1. 使用顺序思维分析需求
+2. 将功能分解为清晰的步骤
+3. 标注步骤间的依赖关系
+4. 按依赖顺序逐步实现
+5. 每步完成后验证再进入下一步
+
+**模板**:
+
+```
+步骤 1: [描述] — 依赖: 无
+步骤 2: [描述] — 依赖: 步骤 1
+步骤 3: [描述] — 依赖: 步骤 1, 2
+```
+
+---
+
+### 3. 数据库变更事务化
+
+**触发条件**: 数据库 schema 变更、数据迁移、多表操作
+
+**执行步骤**:
+
+1. 分析涉及的所有表和依赖
+2. 编写迁移脚本，在单个事务中处理所有变更
+3. 包含回滚逻辑
+4. 通过 Bytebase MCP 执行
+5. 验证数据一致性
+
+**模板**:
+
+```sql
+BEGIN;
+-- 变更操作
+-- ...
+-- 验证查询
+SELECT ... -- 确认数据一致
+COMMIT;
+-- 如果失败: ROLLBACK;
+```
+
+---
+
+## 第二阶段：高级工程化模式（复杂任务时启用）
+
+### 1. 测试驱动开发（TDD）全流程
+
+**触发条件**: 新功能开发、关键业务逻辑、高风险修改
+
+**执行步骤**:
+
+1. **规划**: 使用顺序思维规划架构
+2. **RED**: 编写覆盖所有边界情况的单元测试
+3. **GREEN**: 实现通过每个测试的最小代码
+4. **迭代**: 每次实现后运行测试，分析失败，迭代代码
+5. **属性测试**: 为关键函数生成基于属性的测试
+6. **变异测试**: 验证测试质量，补充遗漏的测试用例
+7. **记录**: 每一步的推理过程
+
+**验收标准**:
+
+- 测试覆盖率 ≥ 80%
+- 所有边界情况覆盖
+- 关键路径有属性测试
+
+---
+
+### 2. 数据库迁移编排
+
+**触发条件**: 跨环境数据库迁移、schema 大改、数据模型重构
+
+**执行步骤**:
+
+1. **依赖分析**: 分析所有依赖和外键关系
+2. **脚本生成**: 生成正向迁移和回滚脚本
+3. **完整性验证**: 创建迁移前验证套件检查数据完整性
+4. **兼容层**: 构建向后兼容的视图
+5. **测试执行**: 先在测试环境执行迁移
+6. **验证查询**: 运行全面的验证查询
+7. **生产计划**: 生成带检查点的生产部署计划
+8. **逐步验证**: 使用 SQL 执行工具验证每个步骤
+9. **风险记录**: 记录潜在风险和回滚方案
+
+**模板**:
+
+```
+迁移计划: [当前模式] → [目标模式]
+├── 1. 依赖图谱
+├── 2. 正向迁移脚本
+├── 3. 回滚脚本
+├── 4. 验证套件
+├── 5. 兼容视图
+├── 6. 测试环境执行结果
+├── 7. 生产部署检查点
+└── 8. 风险评估
+```
+
+---
+
+### 3. 自愈合组件系统
+
+**触发条件**: 核心 UI 组件开发、组件库建设、设计系统实现
+
+**执行步骤**:
+
+1. **扫描**: 扫描代码库了解当前实现及使用模式
+2. **回归测试**: 生成视觉回归测试和无障碍检查
+3. **响应式变体**: 构建针对不同断点优化的多个变体
+4. **性能基准**: 创建性能基准并优化瓶颈
+5. **类型接口**: 生成带完整 JSDoc 的 TypeScript 接口
+6. **Storybook**: 构建包含所有变体和状态的交互式故事
+7. **单元测试**: 创建验证功能和无障碍标准的测试
+8. **自动修复**: 发现现有组件问题时自动生成修复
+
+**验收标准**:
+
+- 所有断点有响应式变体
+- WCAG 2.1 AA 级无障碍
+- 性能基准通过
+- TypeScript 接口完整
+- 测试覆盖率 ≥ 80%
+
+---
+
+### 4. 3D 可视化布局修改
+
+**触发条件**: Three.js / R3F 场景修改、节点布局算法变更、AttentionFlow 连线调整
+
+**执行步骤**:
+
+1. 理解当前数据规模（节点数量、分类分布）
+2. 布局算法修改时，按节点数量加权分配扇区角度（而非固定等分）
+3. 考虑溢出策略：节点数 > 扇区容量时，启用多环螺旋分布
+4. 连线连接点必须偏移到几何体表面，非中心点
+5. 不同几何体形状使用不同偏移系数（球=1.0, 方=1.2, 环=1.4）
+6. `npm run dev` 启动后用截图验证全局布局 + 局部连线
+
+**关键教训（2026-02-09）**:
+
+- 固定角度等分在节点数差异大时（如 50 Skills vs 3 Hooks）会导致重叠
+- 3D 连线 `AttentionFlow` 连到中心点会穿透几何体，必须做表面偏移
+
+---
+
+### 5. 大规模数据处理 + 前端展示
+
+**触发条件**: 批量数据查询、大数据集前端渲染、用户搜索功能
+
+**执行步骤**:
+
+1. 数据获取：分批查询（batch），每批控制在合理大小
+2. 数据处理：去重（dedup）+ 分类（classify）+ 聚合
+3. 前端展示：懒加载图片、视频首帧 `#t=0.1`、`object-fit: cover`
+4. 搜索功能：支持多字段（用户名 + 数字 ID）
+5. 跑马灯/列表数据：必须 deduplicate display names
+
+**关键教训（2026-02-09）**:
+
+- Marquee 展示重复显示名 → 需要前端 Set 去重
+- 图片比例不一 → 1:1 裁剪必须在 CSS 层面固定
+- 348K 用户数据 → 必须按需加载，不能全量传输
+
+---
+
+## 触发规则
+
+| 任务类型       | 最低要求         | 推荐流程                 |
+| -------------- | ---------------- | ------------------------ |
+| 简单 UI 修改   | 第一阶段 #1      | 验证闭环                 |
+| 新功能开发     | 第一阶段 #1 + #2 | + 第二阶段 #1 (TDD)      |
+| 数据库变更     | 第一阶段 #3      | + 第二阶段 #2 (迁移编排) |
+| 核心组件       | 第一阶段 #1 + #2 | + 第二阶段 #3 (自愈合)   |
+| 多文件重构     | 第一阶段 #2      | + 第二阶段 #1 (TDD)      |
+| 3D 可视化修改  | 第一阶段 #1 + #4 | 截图验证闭环             |
+| 大规模数据展示 | 第一阶段 #2 + #5 | 分批 + 去重 + 懒加载     |
+
+---
+
+**版本**: v1.2
+**来源**: Claude Code Insights 报告
+**更新**: 2026-03-02 (添加交叉引用, 收束工程化内容)
+**上次内容更新**: 2026-02-09 (新增 3D 可视化、大规模数据处理工作流)
+**状态**: Active
+**记忆同步**: `memory/engineering-patterns.md`