sumulige-claude 1.0.0

package/development/todos/INDEX.md

@@ -0,0 +1,114 @@
+# 项目任务追踪系统
+
+> 本目录由 AI 自动维护，记录项目开发任务和进度
+
+**最后更新**: 2026-01-11
+
+---
+
+## 📊 整体进度
+
+```
+Total: `███████░░░░░░░░░░░░░` 33%
+
+P0 (关键任务):  `░░░░░░░░░░░░░░░░░░░░` 0%  (0/0)
+P1 (高优先级):  `██████████░░░░░░░░░░` 50%  (1/2)
+P2 (中优先级):  `░░░░░░░░░░░░░░░░░░░░` 0%  (0/1)
+P3 (低优先级):  `░░░░░░░░░░░░░░░░░░░░` 0%  (0/0)
+```
+
+---
+
+## 📁 按状态查看
+
+| 状态 | 目录 | 数量 |
+|------|------|------|
+| 🚧 进行中 | `active/` | 1 |
+| ✅ 已完成 | `completed/` | 1 |
+| 📋 待办 | `backlog/` | 1 |
+| 📦 已归档 | `archived/` | 0 |
+
+---
+
+## 🎯 按优先级查看
+
+### P0 - 关键任务 `0/0`
+
+> 阻塞发布，必须完成
+
+*暂无 P0 任务*
+
+### P1 - 高优先级 `1/2`
+
+> 重要功能，下个里程碑
+
+- 🚧 [TODO 任务管理系统](./active/todo-system.md) `branch: feature/todo-system`
+- ✅ [Boris 最佳实践集成](./completed/boris-optimizations.md) `branch: feature/boris-optimizations`
+
+### P2 - 中优先级 `0/1`
+
+> 正常功能开发
+
+- 📋 [MCP 集成增强](./backlog/mcp-integration.md) `branch: feature/mcp-integration`
+
+### P3 - 低优先级 `0/0`
+
+> 改进优化，有空再做
+
+*暂无 P3 任务*
+
+---
+
+## 🚧 进行中的任务 (1)
+
+- [P1] [TODO 任务管理系统](./active/todo-system.md) - 🚧 `branch: feature/todo-system`
+
+## ✅ 最近完成的任务
+
+- [P1] [Boris 最佳实践集成](./completed/boris-optimizations.md)
+
+## 📋 待办任务 (1)
+
+- [P2] [MCP 集成增强](./backlog/mcp-integration.md)
+
+---
+
+## 📂 全部目录
+
+- [🚧 所有进行中的任务](./active/) - 当前开发重点
+- [✅ 所有已完成的任务](./completed/) - 完整历史
+- [📋 所有待办任务](./backlog/) - 待规划
+- [📦 所有已归档任务](./archived/) - 历史记录
+
+---
+
+## 使用方式
+
+### 查看任务
+点击上方链接跳转到对应目录，或使用：
+```bash
+# 查看进行中的任务
+cat development/todos/active/*.md
+
+# 查看特定任务
+cat development/todos/active/feature-name.md
+```
+
+### 创建新任务
+在 Claude Code 中：
+```
+创建一个新任务：实现用户登录功能，优先级 P1
+```
+
+AI 会自动在 `active/` 目录创建对应的任务文件。
+
+### 更新任务状态
+```
+将 [任务名] 标记为完成
+```
+
+AI 会自动将任务移动到 `completed/` 目录。
+
+---
+
+> **维护说明**: 本系统由 AI 自动维护，请勿手动编辑 INDEX.md（除非你知道自己在做什么）

package/development/todos/active/_README.md

@@ -0,0 +1,49 @@
+# 进行中的任务
+
+> 当前正在开发的任务
+
+@version: 1.0.0
+
+本目录包含所有进行中的任务。每个任务是一个独立的 Markdown 文件。
+
+## 任务模板
+
+```markdown
+# [任务名称]
+
+**状态**: 🚧 进行中
+**优先级**: P0/P1/P2/P3
+**负责人**: AI/Human
+**分支**: `feature/xxx`
+**创建时间**: 2026-01-11
+**预计完成**: 2026-01-15
+
+## 描述
+
+[任务描述]
+
+## 子任务
+
+- [ ] 子任务 1
+- [ ] 子任务 2
+- [ ] 子任务 3
+
+## 依赖
+
+- [依赖的其他任务或资源]
+
+## 进度
+
+- [x] 初始规划
+- [ ] 开发中
+- [ ] 测试
+- [ ] 代码审查
+
+## 备注
+
+[其他备注信息]
+```
+
+## 返回
+
+[返回总览](../INDEX.md)

package/development/todos/active/todo-system.md

@@ -0,0 +1,37 @@
+# TODO 任务管理系统
+
+**状态**: 🚧 进行中
+**优先级**: P1
+**负责人**: AI
+**分支**: `feature/todo-system`
+**创建时间**: 2026-01-11
+**预计完成**: 2026-01-11
+
+## 描述
+
+实现基于 Markdown 的任务追踪系统，支持点击跳转和 AI 自动维护。
+
+## 子任务
+
+- [x] 设计目录结构 (active/completed/backlog/archived)
+- [x] 创建 INDEX.md 索引
+- [x] 实现 todo-manager.cjs hook
+- [x] 集成到 sync 命令
+- [x] 创建 /todos slash command
+
+## 依赖
+
+- Boris 优化系统（已上线）
+
+## 进度
+
+- [x] 初始规划
+- [x] 开发实现
+- [ ] 测试验证
+- [ ] 代码审查
+
+## 备注
+
+- 支持 Markdown 链接点击跳转
+- AI 自动维护，静默更新
+- 任务状态自动流转

package/development/todos/archived/_README.md

@@ -0,0 +1,11 @@
+# 已归档任务
+
+> 不再活跃的历史任务
+
+@version: 1.0.0
+
+本目录包含已归档的历史任务，供参考使用。
+
+## 返回
+
+[返回总览](../INDEX.md)

package/development/todos/backlog/_README.md

@@ -0,0 +1,11 @@
+# 待办任务
+
+> 规划中或待分配的任务
+
+@version: 1.0.0
+
+本目录包含待规划的任务。
+
+## 返回
+
+[返回总览](../INDEX.md)

package/development/todos/backlog/mcp-integration.md

@@ -0,0 +1,35 @@
+# MCP 集成增强
+
+**状态**: 📋 待办
+**优先级**: P2
+**负责人**: AI
+**分支**: `feature/mcp-integration`
+**创建时间**: 2026-01-11
+**预计完成**: TBD
+
+## 描述
+
+增强 Model Context Protocol (MCP) 集成，支持更多第三方服务。
+
+## 子任务
+
+- [ ] Slack MCP 集成
+- [ ] BigQuery 查询支持
+- [ ] Sentry 错误日志
+- [ ] GitHub Actions 集成
+
+## 依赖
+
+- MCP Server SDK
+- 各服务 API credentials
+
+## 进度
+
+- [x] 需求分析
+- [ ] 技术方案设计
+- [ ] 开发实现
+- [ ] 测试验证
+
+## 备注
+
+等待 MCP 生态成熟后优先级提升。

package/development/todos/completed/_README.md

@@ -0,0 +1,11 @@
+# 已完成的任务
+
+> 已完成并关闭的任务
+
+@version: 1.0.0
+
+本目录包含所有已完成的任务。
+
+## 返回
+
+[返回总览](../INDEX.md)

package/development/todos/completed/boris-optimizations.md

@@ -0,0 +1,39 @@
+# Boris 最佳实践集成
+
+**状态**: 🚧 进行中
+**优先级**: P1
+**负责人**: AI
+**分支**: `feature/boris-optimizations`
+**创建时间**: 2026-01-11
+**预计完成**: 2026-01-11
+
+## 描述
+
+集成 Claude Code 创造者 Boris Cherny 的最佳实践，提升开发效率 2-3 倍。
+
+## 子任务
+
+- [x] 验证反馈循环 (verify-work)
+- [x] Slash Commands (7个命令)
+- [x] 代码格式化 Hook
+- [x] 并行多会话支持
+
+## 依赖
+
+- Claude Code
+- oh-my-claude 模板系统
+
+## 进度
+
+- [x] 初始规划
+- [x] 开发实现
+- [x] 测试验证
+- [x] 代码审查
+
+## 备注
+
+已集成到 template/.claude/ 目录，包括：
+- hooks/verify-work.cjs
+- hooks/code-formatter.cjs
+- hooks/multi-session.cjs
+- commands/ (7个 slash commands)

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "sumulige-claude",
+  "version": "1.0.0",
+  "description": "The Best Agent Harness for Claude Code",
+  "main": "cli.js",
+  "bin": {
+    "smc": "cli.js",
+    "sumulige-claude": "cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "postinstall": "node cli.js init"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "agent",
+    "ai",
+    "skills",
+    "mcp"
+  ],
+  "author": "sumulige",
+  "license": "MIT",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sumulige/oh-my-claude.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "prettier": "^3.7.4"
+  }
+}

package/template/.claude/CLAUDE-template.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/template/.claude/README.md

@@ -0,0 +1,142 @@
+# Claude Code 使用指南
+
+> 本文档说明如何在项目中使用 Claude Code
+
+@version: 1.0.0
+
+## 快速开始
+
+### 1. 启动 Claude Code
+
+在项目根目录打开终端：
+
+```bash
+cd /path/to/your/project
+claude
+```
+
+### 2. 首次使用 - Plan 模式
+
+**重要**: 大多数会话应该从 Plan 模式开始（按 `Shift+Tab` 两次）
+
+Plan 模式的优势：
+- Claude 先规划再执行
+- 你可以审查计划后再开始
+- 减少返工，提高效率
+
+```
+你: 按 Shift+Tab 两次进入 Plan 模式
+Claude: 我来先分析项目结构，然后制定计划...
+[分析项目后]
+Claude: 这是我的计划...
+你: [审查计划，确认无误后]
+Claude: 开始执行...
+```
+
+### 3. 常用 Slash Commands
+
+在 Claude Code 中直接输入：
+
+| 命令 | 用途 | 示例场景 |
+|------|------|----------|
+| `/commit-push-pr` | 提交代码并创建 PR | 完成一个功能后 |
+| `/commit` | 创建 commit | 代码写完后 |
+| `/pr` | 创建/更新 PR | 需要 code review 时 |
+| `/test` | 运行测试 | 修改代码后验证 |
+| `/review` | 审查当前更改 | 提交前自查 |
+| `/verify-work` | 查看待验证任务 | 检查是否有遗漏 |
+| `/sessions` | 查看并行会话 | 多终端协作时 |
+
+### 4. 典型工作流程
+
+```
+1. Plan 模式开始 (Shift+Tab 两次)
+   ↓
+2. Claude 分析项目，制定计划
+   ↓
+3. 你审查并确认计划
+   ↓
+4. Claude 执行任务
+   ↓
+5. /review 审查更改
+   ↓
+6. /test 运行测试
+   ↓
+7. /commit 创建提交
+   ↓
+8. /commit-push-pr 推送并创建 PR
+```
+
+## 进阶技巧
+
+### 并行多会话工作
+
+根据 Boris Cherny (Claude Code 创造者) 的经验：
+
+```bash
+# 终端标签 1: Conductor - 任务规划
+# 终端标签 2: Architect - 架构设计
+# 终端标签 3: Builder - 代码实现
+# 终端标签 4: Reviewer - 代码审查
+# 终端标签 5: Explorer - 代码探索
+
+# 同时使用 claude.ai/code Web 版
+# 可以用 & 符号将会话传递到 Web
+```
+
+### 验证反馈循环
+
+**重要**: 给 Claude 验证工作的方法，质量能提升 2-3 倍
+
+```
+你: 实现一个登录功能
+Claude: [实现代码]
+你: 运行测试验证一下
+Claude: [测试失败，修复 bug]
+Claude: [再次测试，通过]
+你: 好，提交吧
+```
+
+### 自动化功能
+
+本项目已配置以下自动化：
+
+- **代码格式化**: 代码编辑后自动格式化
+- **验证提醒**: commit/push 后自动提醒验证
+- **会话追踪**: 自动记录对话历史
+
+## 项目文件说明
+
+| 文件/目录 | 说明 |
+|-----------|------|
+| `CLAUDE.md` | Claude 首先阅读的项目说明 |
+| `MEMORY.md` | AI 的增量记忆，自动更新 |
+| `PROJECT_LOG.md` | 完整的开发历史 |
+| `settings.json` | Claude Code 配置 |
+| `hooks/` | 自动化脚本 |
+| `commands/` | Slash 命令定义 |
+| `templates/` | 项目计划模板 |
+
+## 常见问题
+
+### Q: Claude 做错了怎么办？
+
+将错误做法添加到 `CLAUDE.md`，Claude 会记住不再犯。
+
+### Q: 如何查看对话历史？
+
+查看 `.claude/thinking-routes/` 目录或 `PROJECT_LOG.md`。
+
+### Q: 如何让多个项目共享配置？
+
+将常用配置放入 `CLAUDE.md`，用 `oh-my-claude sync` 同步。
+
+### Q: 权限提示太多怎么办？
+
+使用 `/permissions` 预先允许常用命令，或编辑 `settings.local.json`。
+
+## 获取帮助
+
+- 查看项目根 README: `cat README.md`
+- 查看优化指南: `cat .claude/boris-optimizations.md`
+- 查看命令帮助: 在 Claude Code 中输入 `/help`