sumulige-claude 1.0.0 → 1.0.1

package/.claude/settings.local.json

@@ -33,4 +33,4 @@
       "Bash(git pull:*)"
     ]
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sumulige-claude",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "The Best Agent Harness for Claude Code",
   "main": "cli.js",
   "bin": {

package/template/.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 理解你项目的关键！