sumulige-claude 1.2.0 → 1.3.0

package/.claude/.kickoff-hint.txt

@@ -42,10 +42,11 @@
 ✅ 生成 PROJECT_KICKOFF.md
 ✅ 生成 TASK_PLAN.md
 ✅ 生成 PROJECT_PROPOSAL.md
-✅ 等待你的确认后开始执行
+✅ 🆕 自动创建任务到 development/todos/backlog/
+✅ 🆕 刷新任务索引
 
 ═══════════════════════════════════════════════════════════════════════
 
 💡 提示: 你也可以直接说 "跳过启动" 使用传统开发模式
 
-生成日期: 2026-01-14
+生成日期: 2026-01-22

package/.claude/AGENTS.md

@@ -6,10 +6,6 @@
 
 This project uses **Sumulige Claude** for multi-agent collaboration.
 
-### conductor
-- **Model**: claude-opus-4-5-20251101
-- **Role**: Task coordination and decomposition
-
 ### architect
 - **Model**: claude-opus-4-5-20251101
 - **Role**: Architecture design and decisions
@@ -18,14 +14,18 @@ This project uses **Sumulige Claude** for multi-agent collaboration.
 - **Model**: claude-opus-4-5-20251101
 - **Role**: Code implementation and testing
 
-### reviewer
+### conductor
 - **Model**: claude-opus-4-5-20251101
-- **Role**: Code review and quality check
+- **Role**: Task coordination and decomposition
 
 ### librarian
 - **Model**: claude-opus-4-5-20251101
 - **Role**: Documentation and knowledge
 
+### reviewer
+- **Model**: claude-opus-4-5-20251101
+- **Role**: Code review and quality check
+
 ## Usage
 
 ```bash

package/.claude/CLAUDE.md

@@ -0,0 +1,138 @@
+# [项目名称] - AI 协作配置
+
+> 本文件由 AI 自动维护，定义 AI 协作方式和项目规范
+> 最后更新：YYYY-MM-DD
+
+---
+
+## 🚀 AI 启动检查清单（每次任务开始前执行）
+
+1. **加载锚点索引**：`.claude/ANCHORS.md` → 快速定位模块
+2. **阅读项目范式**：`prompts/project-paradigm.md` → 理解协作方式 ⭐
+3. **阅读项目日志**：`.claude/PROJECT_LOG.md` → 了解完整构建历史
+4. **加载增量记忆**：`.claude/MEMORY.md` → 获取最新变更
+5. **确认当前阶段**：`todo.md` → 了解待办任务
+
+**记忆加载优先级**：
+```
+ANCHORS.md → project-paradigm.md → PROJECT_LOG.md → MEMORY.md → 具体文件
+  (索引)         (协作范式)         (历史)      (变更)      (实现)
+```
+
+---
+
+## 📁 受保护目录（不可删除）
+
+以下目录包含核心基础设施，**严禁删除或清理**：
+
+| 目录 | 说明 |
+|------|------|
+| `prompts/` | Prompt 教学库（包含项目范式）⭐ |
+| `.claude/` | AI 自治记忆系统核心 ⭐ |
+| `.claude/thinking-routes/` | 思维轨迹系统 ⭐ |
+| `.claude/skills/` | 知识库 |
+| `.claude/hooks/` | 自动化钩子 |
+
+---
+
+## 项目信息
+
+- **项目名称**：[填写项目名称]
+- **技术栈**：[填写技术栈，如 React, TypeScript, Node.js]
+- **测试命令**：[如 npm test]
+- **构建命令**：[如 npm run build]
+
+---
+
+## 项目愿景
+
+[一句话描述项目的核心价值]
+
+---
+
+## 核心架构
+
+[简要描述项目的核心架构和设计理念]
+
+---
+
+## 代码风格
+
+遵循 **Linus Torvalds** 的编程哲学：
+
+### 1. 消除特殊情况
+- 通过优雅的数据结构让边界情况自然消失
+- 避免用 if/else 打补丁
+
+### 2. 极简主义
+- 函数只做一件事
+- 命名直白、精准
+
+### 3. 实用主义
+- 解决真实问题，拒绝过度设计
+
+### 质量指标
+- 单文件不超过 800 行
+- 单目录不超过 8 个文件
+- 零循环依赖
+- 零代码重复
+
+---
+
+## Communication Guidelines
+
+### 与用户交流规范
+
+当提供多个选项或步骤时，**必须使用序号**方便用户快速回复：
+
+```
+请选择下一步：
+1. 选项 A
+2. 选项 B
+3. 选项 C
+4. 跳过
+```
+
+用户只需回复 `1` `2` `3` 即可，无需打字。
+
+### 适用场景
+- 多个选项选择
+- 分步骤的引导
+- 浏览多个功能/文件
+- 需要用户确认的分支
+
+---
+
+## 关键规则
+
+[填写项目特定的关键规则和约束]
+
+---
+
+## 人类确认点
+
+AI 在以下情况必须暂停并请求人类确认：
+
+- 架构设计变更
+- 数据模型变更
+- 新增外部依赖
+- 质量标准定义
+- 安全与隐私相关变更
+
+---
+
+## 常用命令
+
+```bash
+# 开发
+npm run dev
+
+# 测试
+npm test
+
+# 构建
+npm run build
+
+# 类型检查
+npm run check
+```

package/.claude/README.md

@@ -1,10 +1,53 @@
-# Claude Code 使用指南
+# Sumulige Claude 使用指南
 
-> 本文档说明如何在项目中使用 Claude Code
+> 本文档说明如何使用 Sumulige Claude (smc) 和 Claude Code
 
 @version: 1.0.0
 
-## 快速开始
+---
+
+## 🚀 安装与初始化
+
+### 1. 全局安装
+
+```bash
+npm install -g sumulige-claude
+```
+
+### 2. 首次初始化
+
+```bash
+smc init
+```
+
+这会创建全局配置 `~/.claude/config.json`
+
+### 3. 在新项目中使用
+
+```bash
+cd your-project
+smc template    # 复制模板到项目
+smc status      # 查看状态
+```
+
+---
+
+## 📋 SMC 命令速查
+
+| 命令 | 功能 | 说明 |
+|------|------|------|
+| `smc init` | 初始化 | 创建全局配置 |
+| `smc status` | 查看状态 | 显示 Agents、Skills 状态 |
+| `smc template` | 项目模板 | 复制 `.claude/` 到当前项目 |
+| `smc sync` | 同步配置 | 更新当前项目配置 |
+| `smc agent "任务"` | Agent 协作 | 启动多 Agent 模式 |
+| `smc skill:list` | 技能列表 | 查看可用技能 |
+| `smc skill:create <name>` | 创建技能 | 创建新技能模板 |
+| `smc kickoff` | 项目启动 | 生成项目规划文档 |
+
+---
+
+## 🎯 快速开始
 
 ### 1. 启动 Claude Code
 
@@ -46,28 +89,34 @@ Claude: 开始执行...
 | `/review` | 审查当前更改 | 提交前自查 |
 | `/verify-work` | 查看待验证任务 | 检查是否有遗漏 |
 | `/sessions` | 查看并行会话 | 多终端协作时 |
+| `/todos` | 查看任务列表 | 查看 TODO 进度 |
+| `/skill-create` | 创建新技能 | 扩展 Claude 能力 |
 
 ### 4. 典型工作流程
 
 ```
-1. Plan 模式开始 (Shift+Tab 两次)
-   ↓
-2. Claude 分析项目，制定计划
-   ↓
-3. 你审查并确认计划
-   ↓
-4. Claude 执行任务
-   ↓
-5. /review 审查更改
-   ↓
-6. /test 运行测试
-   ↓
-7. /commit 创建提交
-   ↓
-8. /commit-push-pr 推送并创建 PR
+┌─────────────────────────────────────────────────┐
+│ 1. Plan 模式开始 (Shift+Tab 两次)               │
+│    ↓                                            │
+│ 2. Claude 分析项目，制定计划                    │
+│    ↓                                            │
+│ 3. 你审查并确认计划                             │
+│    ↓                                            │
+│ 4. Claude 执行任务                              │
+│    ↓                                            │
+│ 5. /review 审查更改                             │
+│    ↓                                            │
+│ 6. /test 运行测试                               │
+│    ↓                                            │
+│ 7. /commit 创建提交                             │
+│    ↓                                            │
+│ 8. /commit-push-pr 推送并创建 PR                │
+└─────────────────────────────────────────────────┘
 ```
 
-## 进阶技巧
+---
+
+## 🧠 进阶技巧
 
 ### 并行多会话工作
 
@@ -84,6 +133,13 @@ Claude: 开始执行...
 # 可以用 & 符号将会话传递到 Web
 ```
 
+使用 `smc agent` 可以自动协调多个 Agent：
+
+```bash
+smc agent "重构用户认证模块"
+# Claude 会自动分配 Conductor/Architect/Builder 任务
+```
+
 ### 验证反馈循环
 
 **重要**: 给 Claude 验证工作的方法，质量能提升 2-3 倍
@@ -97,46 +153,181 @@ Claude: [再次测试，通过]
 你: 好，提交吧
 ```
 
-### 自动化功能
+### 自动化功能 (Hooks)
 
-本项目已配置以下自动化：
+项目已配置以下自动化脚本：
 
-- **代码格式化**: 代码编辑后自动格式化
-- **验证提醒**: commit/push 后自动提醒验证
-- **会话追踪**: 自动记录对话历史
+| Hook | 功能 |
+|------|------|
+| `code-formatter.cjs` | 代码编辑后自动格式化 |
+| `todo-manager.cjs` | TODO 任务自动管理 |
+| `verify-work.cjs` | commit/push 后自动提醒验证 |
+| `thinking-silent.cjs` | ThinkingLens 静默思考 |
+| `rag-skill-loader.cjs` | 动态加载技能 |
+| `multi-session.cjs` | 多会话追踪 |
 
-## 项目文件说明
+---
 
-| 文件/目录 | 说明 |
-|-----------|------|
-| `CLAUDE.md` | Claude 首先阅读的项目说明 |
-| `MEMORY.md` | AI 的增量记忆，自动更新 |
-| `PROJECT_LOG.md` | 完整的开发历史 |
-| `settings.json` | Claude Code 配置 |
-| `hooks/` | 自动化脚本 |
-| `commands/` | Slash 命令定义 |
-| `templates/` | 项目计划模板 |
+## 📁 项目文件说明
 
-## 常见问题
+```
+your-project/
+├── .claude/
+│   ├── CLAUDE.md           # ⭐ Claude 首先阅读，描述项目
+│   ├── MEMORY.md           # AI 增量记忆（自动更新）
+│   ├── ANCHORS.md          # 重要参考点
+│   ├── settings.json       # Claude Code 配置
+│   ├── settings.local.json # 本地配置（不提交）
+│   ├── hooks/              # 自动化脚本
+│   ├── commands/           # Slash 命令定义
+│   ├── skills/             # 技能模块
+│   ├── templates/          # 项目模板
+│   ├── rag/                # 技能索引
+│   └── thinking-routes/    # 思考路线记录
+├── development/
+│   └── todos/              # TODO 任务管理
+│       ├── INDEX.md        # 任务索引
+│       ├── active/         # 进行中
+│       ├── completed/      # 已完成
+│       └── backlog/        # 待办
+└── prompts/                # Prompt 模板
+```
+
+### 关键文件
+
+| 文件 | 重要性 | 说明 |
+|------|--------|------|
+| `CLAUDE.md` | ⭐⭐⭐ | Claude 首先阅读，定义项目规范 |
+| `MEMORY.md` | ⭐⭐ | AI 自动记录的项目记忆 |
+| `settings.json` | ⭐⭐ | Claude Code 配置 |
+| `hooks/` | ⭐⭐ | 自动化脚本 |
+| `commands/` | ⭐ | 自定义 Slash 命令 |
+
+---
+
+## ❓ 常见问题
 
 ### Q: Claude 做错了怎么办？
 
-将错误做法添加到 `CLAUDE.md`，Claude 会记住不再犯。
+将错误做法添加到 `CLAUDE.md`，Claude 会记住不再犯：
+
+```markdown
+## 禁止事项
+- 不要在循环中使用 await
+- 不要直接修改 state
+```
 
 ### Q: 如何查看对话历史？
 
-查看 `.claude/thinking-routes/` 目录或 `PROJECT_LOG.md`。
+```bash
+# 方法 1: 查看思考路线
+cat .claude/thinking-routes/QUICKREF.md
+
+# 方法 2: 查看项目日志
+cat PROJECT_LOG.md
+
+# 方法 3: 使用 smc
+smc status
+```
 
 ### Q: 如何让多个项目共享配置？
 
-将常用配置放入 `CLAUDE.md`，用 `oh-my-claude sync` 同步。
+```bash
+# 更新 sumulige-claude 模板
+cd ~/your-project
+smc sync    # 同步最新配置
+```
 
 ### Q: 权限提示太多怎么办？
 
-使用 `/permissions` 预先允许常用命令，或编辑 `settings.local.json`。
+编辑 `.claude/settings.local.json`：
+
+```json
+{
+  "permissions": {
+    "allow": ["npm test", "npm run *", "git *"]
+  }
+}
+```
+
+### Q: 如何创建自定义技能？
+
+```bash
+smc skill:create my-skill
+
+# 或在 Claude Code 中
+/skill-create my-skill
+```
+
+### Q: 如何更新 sumulige-claude？
+
+```bash
+npm update -g sumulige-claude
+smc sync    # 同步新配置到项目
+```
+
+---
+
+## 🔗 获取帮助
+
+```bash
+# 查看 SMC 帮助
+smc --help
+
+# 查看项目 README
+cat README.md
+
+# 查看优化指南
+cat .claude/boris-optimizations.md
+
+# Claude Code 内置帮助
+/help
+```
+
+---
+
+## 📊 使用流程图
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    首次安装                                  │
+├─────────────────────────────────────────────────────────────┤
+│  npm install -g sumulige-claude                              │
+│       ↓                                                      │
+│  smc init                                                    │
+│       ↓                                                      │
+│  smc status  ← 验证安装成功                                  │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│                    每个新项目                                │
+├─────────────────────────────────────────────────────────────┤
+│  cd my-project                                               │
+│       ↓                                                      │
+│  smc template  ← 复制模板                                    │
+│       ↓                                                      │
+│  编辑 .claude/CLAUDE.md  ← 描述项目信息                      │
+│       ↓                                                      │
+│  claude  ← 启动 Claude Code                                  │
+│       ↓                                                      │
+│  Shift+Tab 两次  ← Plan 模式                                 │
+│       ↓                                                      │
+│  开始工作...                                                 │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│                    日常开发                                  │
+├─────────────────────────────────────────────────────────────┤
+│  claude                    # 启动                            │
+│  /commit                   # 提交代码                        │
+│  /test                     # 运行测试                        │
+│  /review                   # 审查更改                        │
+│  /commit-push-pr           # 推送 + 创建 PR                  │
+│  /todos                    # 查看任务                        │
+│  smc agent "任务描述"      # 多 Agent 协作                   │
+└─────────────────────────────────────────────────────────────┘
+```
 
-## 获取帮助
+---
 
-- 查看项目根 README: `cat README.md`
-- 查看优化指南: `cat .claude/boris-optimizations.md`
-- 查看命令帮助: 在 Claude Code 中输入 `/help`
+> 💡 **提示**: 记得经常更新 `CLAUDE.md`，它是 Claude 理解你项目的关键！

package/.claude/USAGE.md

@@ -0,0 +1,175 @@
+# Skills 系统使用手册
+
+> 版本: 2.0.0 | 更新日期: 2026-01-22
+
+---
+
+## 核心 Skills
+
+| Skill | 命令 | 触发时机 | 作用 | 模型 |
+|-------|------|---------|------|------|
+| `quality-guard` | `/review` | 提交前、PR 审查 | 代码质量 + 安全检查 + 清理建议 | sonnet |
+| `test-master` | `/test` | 实现功能后 | TDD + E2E + 覆盖率分析 | sonnet |
+| `design-brain` | `/plan` | 开始新任务前 | 规划 + 架构设计 | opus |
+| `quick-fix` | `/fix` | 构建失败时 | 快速修复错误 | haiku |
+
+---
+
+## 命令速查表
+
+### /review - 代码审查
+
+```bash
+/review              # 标准代码审查
+/review --security   # 安全深度扫描 (OWASP Top 10)
+/review --clean      # 死代码清理建议
+/review --all        # 完整审查
+```
+
+**触发时机**:
+- 准备提交代码前
+- PR 审查时
+- 怀疑有安全问题时
+
+### /test - 测试
+
+```bash
+/test                # 运行单元测试
+/test --tdd          # TDD 开发模式 (RED→GREEN→REFACTOR)
+/test --e2e          # E2E 测试 (Playwright)
+/test --coverage     # 覆盖率报告
+/test --all          # 完整测试套件
+```
+
+**触发时机**:
+- 完成功能实现后
+- 修复 bug 后
+- 提交前验证
+
+### /plan - 规划
+
+```bash
+/plan                # 快速规划（默认）
+/plan --deep         # 深度设计（架构决策）
+/plan --arch         # 仅架构设计
+```
+
+**触发时机**:
+- 开始新功能开发前
+- 重大重构前
+- 技术选型时
+
+### /fix - 快速修复
+
+```bash
+/fix                 # 自动检测并修复
+/fix --build         # 修复构建错误
+/fix --lint          # 修复 lint 错误
+/fix --type          # 修复类型错误
+/fix --all           # 修复所有错误
+```
+
+**触发时机**:
+- `npm run build` 失败
+- `tsc` 报类型错误
+- ESLint 报错
+
+### /refactor - 重构
+
+```bash
+/refactor            # 分析并建议清理
+/refactor --dead     # 查找死代码
+/refactor --deps     # 查找未使用依赖
+/refactor --duplicate # 查找重复代码
+/refactor --execute  # 执行清理（需确认）
+```
+
+**触发时机**:
+- 代码库变大需要清理
+- 发现重复代码
+- 依赖需要整理
+
+---
+
+## 模型成本策略
+
+| 模型 | 使用场景 | 相对成本 | 速度 |
+|------|---------|---------|------|
+| **haiku** | `/fix` 快速修复 | 1x (最低) | 最快 |
+| **sonnet** | `/review`, `/test` 标准任务 | 5x | 中等 |
+| **opus** | `/plan --deep` 复杂架构 | 15x | 较慢 |
+
+**自动选择规则**:
+- 简单修复 → haiku（节省成本）
+- 代码审查/测试 → sonnet（平衡性价比）
+- 架构设计 → opus（仅在需要深度分析时）
+
+---
+
+## 工作流示例
+
+### 新功能开发
+
+```
+1. /plan              # 规划实现步骤
+2. 编写代码           # 实现功能
+3. /fix               # 修复编译错误
+4. /test --tdd        # 补充测试
+5. /review            # 代码审查
+6. /commit            # 提交代码
+```
+
+### Bug 修复
+
+```
+1. /test              # 确认失败的测试
+2. 修复代码           # 实现修复
+3. /fix               # 确保编译通过
+4. /test              # 验证测试通过
+5. /review --security # 安全检查
+6. /commit            # 提交修复
+```
+
+### 代码清理
+
+```
+1. /refactor          # 分析代码库
+2. /refactor --dead   # 找死代码
+3. /refactor --deps   # 找未用依赖
+4. /refactor --execute # 执行清理
+5. /test              # 确保不破坏功能
+6. /commit            # 提交清理
+```
+
+---
+
+## 自动加载
+
+Skills 会根据用户输入自动加载：
+
+```json
+{
+  "auto_load": {
+    "enabled": true,
+    "confidence_threshold": 0.7,
+    "max_skills_per_task": 3
+  }
+}
+```
+
+**关键词触发示例**:
+- "review code" → `quality-guard`
+- "fix build error" → `quick-fix`
+- "plan architecture" → `design-brain`
+- "run tests" → `test-master`
+
+---
+
+## 配置文件
+
+| 文件 | 说明 |
+|------|------|
+| `.claude/rag/skill-index.json` | Skill 索引和模型策略 |
+| `.claude/skills/*/metadata.yaml` | 各 Skill 配置 |
+| `.claude/skills/*/SKILL.md` | Skill 详细指令 |
+| `.claude/commands/*.md` | 命令定义 |