sumulige-claude 1.1.2 → 1.2.1

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-18

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/boris-optimizations.md

@@ -0,0 +1,167 @@
+# Boris 优化指南
+
+本指南基于 Claude Code 创造者 Boris Cherny 的最佳实践，为 oh-my-claude 项目提供优化建议。
+
+## 已实现的优化
+
+### 1. 验证反馈循环 🔍
+
+**文件**: `.claude/hooks/verify-work.cjs`
+
+**重要性**: ⭐⭐⭐⭐⭐ (最重要！质量提升 2-3 倍)
+
+**功能**:
+- 在关键操作后自动提醒验证
+- 记录待验证任务列表
+- 生成验证日志
+
+**使用方式**:
+```bash
+# 手动触发验证流程
+/verify-work
+```
+
+**验证时机**:
+- git commit 后 - 运行测试确保功能正常
+- git push 后 - 检查 CI/CD 状态
+- deploy 后 - 在预发布环境验证
+- build 后 - 检查构建产物
+
+---
+
+### 2. Slash Commands ⚡
+
+**目录**: `.claude/commands/`
+
+**可用命令**:
+
+| 命令 | 功能 |
+|------|------|
+| `/commit-push-pr` | 提交代码、推送、创建 PR |
+| `/commit` | 创建 git commit |
+| `/pr` | 创建或更新 PR |
+| `/test` | 运行测试套件 |
+| `/review` | 审查当前更改 |
+| `/verify-work` | 查看待验证任务 |
+| `/sessions` | 管理并行会话 |
+
+**使用方式**:
+```bash
+# 快速提交并创建 PR
+/commit-push-pr
+
+# 审查更改后再提交
+/review
+/commit
+
+# 运行测试
+/test
+```
+
+---
+
+### 3. 代码格式化 Hook 🎨
+
+**文件**: `.claude/hooks/code-formatter.cjs`
+
+**功能**:
+- 在代码编辑后自动格式化
+- 支持多种语言和格式化工具
+- 静默运行，不打扰工作流
+
+**支持的语言**:
+- JavaScript/TypeScript (Prettier)
+- Python (Black)
+- Rust (rustfmt)
+- Go (gofmt)
+- JSON/YAML/Markdown (Prettier)
+
+**调试模式**:
+```bash
+export DEBUG_FORMATTER=1
+```
+
+---
+
+### 4. 并行多会话支持 🔄
+
+**文件**: `.claude/hooks/multi-session.cjs`
+
+**功能**:
+- 跟踪活跃的并行会话
+- 为每个会话分配编号 (1-10)
+- 自动清理过期会话
+
+**Boris 的工作流**:
+```
+终端标签 1: Conductor (协调/规划)
+终端标签 2: Architect (设计/架构)
+终端标签 3: Builder (实现)
+终端标签 4: Reviewer (审查)
+终端标签 5: Explorer (研究)
+
++ 5-10 个 claude.ai/code Web 会话
+```
+
+**使用方式**:
+```bash
+# 查看所有活跃会话
+/sessions
+
+# 或直接运行
+node .claude/hooks/multi-session.cjs --status
+```
+
+---
+
+## 配置更新
+
+所有 hooks 已添加到 `.claude/settings.json`:
+
+```json
+{
+  "matcher": "UserPromptSubmit|PreToolUse|PostToolUse|AgentStop",
+  "hooks": [
+    { "command": "...project-kickoff.cjs", "timeout": 1 },
+    { "command": "...thinking-silent.cjs", "timeout": 1 },
+    { "command": "...rag-skill-loader.cjs", "timeout": 1 },
+    { "command": "...code-formatter.cjs", "timeout": 5 },
+    { "command": "...verify-work.cjs", "timeout": 1 },
+    { "command": "...multi-session.cjs", "timeout": 1 }
+  ]
+}
+```
+
+---
+
+## 最佳实践总结
+
+### 启动会话
+1. **Plan 模式开始** (Shift+Tab 两次)
+2. 批准计划后切换到 auto-accept 模式
+3. 使用 `/commit-push-pr` 完成工作流
+
+### 并行工作
+1. 开启 5 个终端标签页
+2. 每个标签运行不同的 agent/任务
+3. 使用系统通知跟踪进度
+4. 同时使用 claude.ai/code Web 会话
+
+### 验证工作
+1. 每次提交前 `/review`
+2. 提交后 `/test` 验证
+3. 定期 `/verify-work` 查看待验证项
+4. 使用 background agent 验证长时间任务
+
+### 团队协作
+1. 共享 CLAUDE.md 到 git
+2. PR 审查时使用 @.claude 添加规范
+3. 定期更新团队知识库
+
+---
+
+## 额外资源
+
+- [Claude Code 文档](https://code.claude.com)
+- [Boris 的 Twitter Thread](https://twitter-thread.com/t/2007179832300581177)
+- [Claude Chrome Extension](https://code.claude.com/docs/en/chrome)

package/.claude/commands/todos.md

@@ -14,37 +14,12 @@ cat development/todos/INDEX.md
 
 ## Task Operations
 
-### Task Types (v2.0)
-
-任务管理系统支持 R-D-T 三阶段生命周期：
-
-```
-Research (研究) → Develop (开发) → Test (测试) → Done (完成)
-```
-
-| 类型 | 图标 | 目录 | 说明 |
-|------|------|------|------|
-| Research | 📊 | `active/research/` | 调研/设计/探索 |
-| Develop | 💻 | `active/develop/` | 实现/编码/重构 |
-| Test | 🧪 | `active/test/` | 测试/验证/QA |
-
-### Task Templates
-
-使用 `.claude/templates/tasks/` 中的模板创建任务：
-
-- **研究任务**: `.claude/templates/tasks/research.md`
-- **开发任务**: `.claude/templates/tasks/develop.md`
-- **测试任务**: `.claude/templates/tasks/test.md`
-
 ### Create a New Task
 
 When user asks to create a task:
-1. Determine the task type (research/develop/test)
-2. Create file in `development/todos/active/{type}/`
-3. Use kebab-case for filename (e.g., `user-authentication.md`)
-4. Copy from the corresponding template
-
-#### Task Template (Legacy Format)
+1. Create file in `development/todos/active/`
+2. Use kebab-case for filename (e.g., `user-login.md`)
+3. Use the template format:
 
 ```markdown
 # [Task Name]
@@ -84,19 +59,9 @@ When user asks to create a task:
 ### Update Task Status
 
 To move a task:
-- **Complete**: Move from `active/{type}/` to `completed/{type}/`
-- **Backlog**: Move from `active/{type}/` to `backlog/{type}/`
-- **Archive**: Move from `completed/{type}/` to `archived/{type}/`
-
-Example: Move `active/develop/auth.md` → `completed/develop/auth.md`
-
-### Auto-Transition Suggestions
-
-When a develop task is completed, the todo-manager will suggest creating a corresponding test task. Check with:
-
-```bash
-node .claude/hooks/todo-manager.cjs --suggest
-```
+- **Complete**: Move from `active/` to `completed/`
+- **Backlog**: Move from `active/` to `backlog/`
+- **Archive**: Move from `completed/` to `archived/`
 
 ### Update Task Progress