sumulige-claude 1.0.0

package/template/.claude/commands/todos.md

@@ -0,0 +1,99 @@
+---
+description: Manage project todos and tasks
+---
+
+Manage project tasks in the development/todos directory.
+
+## Show Task Overview
+
+Display the task overview:
+
+```bash
+cat development/todos/INDEX.md
+```
+
+## Task Operations
+
+### Create a New Task
+
+When user asks to create a task:
+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]
+
+**状态**: 🚧 进行中
+**优先级**: P0/P1/P2/P3
+**负责人**: AI/Human
+**分支**: `feature/xxx`
+**创建时间**: YYYY-MM-DD
+**预计完成**: YYYY-MM-DD
+
+## 描述
+
+[Task description]
+
+## 子任务
+
+- [ ] Subtask 1
+- [ ] Subtask 2
+
+## 依赖
+
+- [Dependencies]
+
+## 进度
+
+- [x] Planning
+- [ ] In progress
+- [ ] Testing
+- [ ] Review
+
+## 备注
+
+[Notes]
+```
+
+### Update Task Status
+
+To move a task:
+- **Complete**: Move from `active/` to `completed/`
+- **Backlog**: Move from `active/` to `backlog/`
+- **Archive**: Move from `completed/` to `archived/`
+
+### Update Task Progress
+
+Edit the task file and update:
+- Subtask checkboxes
+- Progress checklist
+- Add notes
+
+## Refresh Task Index
+
+After any task changes, refresh the index:
+
+```bash
+node .claude/hooks/todo-manager.cjs --force
+```
+
+## Task Priority Levels
+
+| Priority | Usage |
+|----------|-------|
+| P0 | Critical - blocks release |
+| P1 | High - important for next milestone |
+| P2 | Medium - normal feature work |
+| P3 | Low - nice to have |
+
+## Examples
+
+User says: "Create a task for implementing user authentication"
+→ Create `active/user-authentication.md`
+
+User says: "Mark the login task as complete"
+→ Move `active/login.md` to `completed/login.md`
+
+User says: "Show all active tasks"
+→ List all files in `development/todos/active/`

package/template/.claude/commands/verify-work.md

@@ -0,0 +1,63 @@
+---
+description: View and manage pending verification tasks
+---
+
+You are helping the user review and verify completed work.
+
+## Check Pending Tasks
+
+First, read the verification log:
+
+```bash
+cat .claude/verify/verify-log.md 2>/dev/null || echo "No verification log found"
+```
+
+And check pending tasks:
+
+```bash
+cat .claude/verify/.pending-verify.json 2>/dev/null || echo "No pending tasks"
+```
+
+## Verification Process
+
+For each pending task, guide the user through:
+
+1. **What was done** - Summarize the action
+2. **How to verify** - Run appropriate verification commands:
+   - For code changes: run tests, linters
+   - For deployments: check staging environment
+   - For commits: verify CI/CD status
+
+## Common Verification Commands
+
+```bash
+# Run tests
+npm test
+
+# Check test coverage
+npm run test:coverage
+
+# Run linter
+npm run lint
+
+# Type check
+npm run type-check
+
+# Build verification
+npm run build
+
+# Check CI status (if using GitHub)
+gh run list --limit 5
+
+# Check PR status
+gh pr status
+```
+
+## Mark as Complete
+
+After verification is successful, ask the user if they want to:
+- Mark the task as verified (remove from pending)
+- Keep it for later verification
+- Add additional verification steps
+
+To mark as complete, edit `.claude/verify/.pending-verify.json` to remove the completed task.

package/template/.claude/hooks/code-formatter.cjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+/**
+ * Code Formatter Hook - 自动代码格式化
+ *
+ * 根据 Boris Cherny 的最佳实践，Claude 通常能生成格式良好的代码，
+ * 但这个 hook 处理最后 10% 的格式问题，避免 CI 中的格式错误。
+ *
+ * 触发时机：PostToolUse 事件
+ * 支持语言：JavaScript, TypeScript, Python, Rust, Go, JSON, Markdown
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 支持的格式化器配置
+const FORMATTERS = {
+  // JavaScript/TypeScript
+  '.js': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.jsx': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.ts': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.tsx': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.mjs': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.cjs': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+
+  // Python
+  '.py': { cmd: 'black', args: ['--quiet'] },
+
+  // Rust
+  '.rs': { cmd: 'rustfmt', args: [] },
+
+  // Go
+  '.go': { cmd: 'gofmt', args: ['-w'] },
+
+  // JSON
+  '.json': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+
+  // Markdown
+  '.md': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+
+  // CSS/SCSS
+  '.css': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.scss': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.less': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+
+  // HTML
+  '.html': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.htm': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+
+  // YAML
+  '.yaml': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+  '.yml': { cmd: 'prettier', args: ['--write', '--log-level', 'warn'] },
+};
+
+// 检查命令是否可用
+function isCommandAvailable(cmd) {
+  try {
+    // 首先尝试 which
+    spawn('which', [cmd], { stdio: 'ignore' });
+
+    // 对于 prettier，额外检查 npx
+    if (cmd === 'prettier') {
+      spawn('npx', [cmd, '--version'], { stdio: 'ignore' });
+    }
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// 获取工具修改的文件
+function getModifiedFiles() {
+  const toolName = process.env.CLAUDE_TOOL_NAME || '';
+  const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+
+  // 从工具输入中提取文件路径
+  const filePaths = [];
+
+  // Edit 工具
+  if (toolName === 'Edit') {
+    // Edit 工具的文件路径在 file_path 参数中
+    const match = toolInput.match(/"filePath":\s*"([^"]+)"/);
+    if (match) {
+      filePaths.push(match[1]);
+    }
+  }
+
+  // Write 工具
+  if (toolName === 'Write') {
+    const match = toolInput.match(/"file_path":\s*"([^"]+)"/);
+    if (match) {
+      filePaths.push(match[1]);
+    }
+  }
+
+  // NotebookEdit 工具
+  if (toolName === 'NotebookEdit') {
+    const match = toolInput.match(/"notebook_path":\s*"([^"]+)"/);
+    if (match) {
+      filePaths.push(match[1]);
+    }
+  }
+
+  return filePaths;
+}
+
+// 格式化文件
+function formatFile(filePath) {
+  const ext = path.extname(filePath);
+
+  // 跳过不需要格式化的目录
+  const skipDirs = ['node_modules', '.git', 'dist', 'build', 'target', 'vendor', '.venv'];
+  if (skipDirs.some(dir => filePath.includes(`/${dir}/`) || filePath.includes(`\\${dir}\\`))) {
+    return null;
+  }
+
+  const formatter = FORMATTERS[ext];
+  if (!formatter) {
+    return null;
+  }
+
+  // 检查格式化器是否可用
+  if (!isCommandAvailable(formatter.cmd)) {
+    return null;
+  }
+
+  // 检查文件是否存在
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  try {
+    // 对于 prettier，使用 npx 来支持本地安装
+    const cmd = formatter.cmd === 'prettier' ? 'npx' : formatter.cmd;
+    const args = formatter.cmd === 'prettier'
+      ? ['prettier', ...formatter.args, filePath]
+      : [...formatter.args, filePath];
+
+    // 运行格式化器
+    spawn(cmd, args, {
+      stdio: 'ignore',
+      cwd: PROJECT_DIR,
+      detached: true
+    }).unref();
+    return { file: filePath, formatter: formatter.cmd };
+  } catch (e) {
+    return null;
+  }
+}
+
+// 主函数
+function main() {
+  try {
+    const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+
+    // 只在 PostToolUse 事件时运行
+    if (eventType !== 'PostToolUse') {
+      process.exit(0);
+    }
+
+    const modifiedFiles = getModifiedFiles();
+
+    if (modifiedFiles.length === 0) {
+      process.exit(0);
+    }
+
+    // 格式化所有修改的文件
+    const formatted = modifiedFiles
+      .map(formatFile)
+      .filter(result => result !== null);
+
+    // 输出格式化结果（可选，用于调试）
+    if (formatted.length > 0 && process.env.DEBUG_FORMATTER) {
+      console.log(`\n🎨 [格式化] 已格式化 ${formatted.length} 个文件:`);
+      formatted.forEach(f => console.log(`   - ${f.file} (${f.formatter})`));
+    }
+
+  } catch (e) {
+    // 完全静默，不输出任何错误
+  }
+
+  process.exit(0);
+}
+
+main();

package/template/.claude/hooks/multi-session.cjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * Multi-Session Manager - 并行多会话管理
+ *
+ * 根据 Boris Cherny 的实践，并行运行 5 个 Claude 可以极大提升效率。
+ * 这个 hook 帮助跟踪和管理多个并行会话。
+ *
+ * 功能：
+ * - 跟踪活跃的会话
+ * - 为每个会话分配编号
+ * - 记录会话状态和任务
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const SESSIONS_DIR = path.join(PROJECT_DIR, '.claude', 'sessions');
+const ACTIVE_SESSIONS_FILE = path.join(SESSIONS_DIR, 'active-sessions.json');
+const SESSION_LOCK_FILE = path.join(SESSIONS_DIR, '.session-lock');
+
+// 确保目录存在
+try { fs.mkdirSync(SESSIONS_DIR, { recursive: true }); } catch (e) {}
+
+// 获取主机名和用户信息用于标识会话来源
+function getSessionIdentifier() {
+  const hostname = os.hostname();
+  const platform = os.platform();
+  const username = process.env.USER || process.env.USERNAME || 'unknown';
+  return `${username}@${hostname} (${platform})`;
+}
+
+// 获取当前会话 ID
+function getCurrentSessionId() {
+  // 从环境变量或进程信息生成唯一 ID
+  const pid = process.pid;
+  const ppid = process.ppid;
+  const timestamp = Date.now();
+  return `session-${pid}-${ppid}`;
+}
+
+// 获取活跃会话列表
+function getActiveSessions() {
+  if (!fs.existsSync(ACTIVE_SESSIONS_FILE)) {
+    return [];
+  }
+  try {
+    const data = fs.readFileSync(ACTIVE_SESSIONS_FILE, 'utf-8');
+    const sessions = JSON.parse(data);
+    // 清理超过 1 小时的旧会话
+    const oneHourAgo = Date.now() - 60 * 60 * 1000;
+    return sessions.filter(s => s.lastHeartbeat > oneHourAgo);
+  } catch (e) {
+    return [];
+  }
+}
+
+// 保存活跃会话列表
+function saveActiveSessions(sessions) {
+  fs.writeFileSync(ACTIVE_SESSIONS_FILE, JSON.stringify(sessions, null, 2));
+}
+
+// 更新当前会话的心跳
+function updateHeartbeat() {
+  const sessions = getActiveSessions();
+  const currentId = getCurrentSessionId();
+  const now = Date.now();
+
+  const existingSession = sessions.find(s => s.id === currentId);
+  if (existingSession) {
+    existingSession.lastHeartbeat = now;
+    existingSession.heartbeatCount = (existingSession.heartbeatCount || 0) + 1;
+  } else {
+    sessions.push({
+      id: currentId,
+      identifier: getSessionIdentifier(),
+      startedAt: now,
+      lastHeartbeat: now,
+      heartbeatCount: 1,
+      status: 'active'
+    });
+  }
+
+  saveActiveSessions(sessions);
+  return sessions;
+}
+
+// 获取会话编号（1-5，类似 Boris 的标签页编号）
+function getSessionNumber(sessions) {
+  const currentId = getCurrentSessionId();
+  const session = sessions.find(s => s.id === currentId);
+  if (session && session.number) {
+    return session.number;
+  }
+
+  // 分配一个可用的编号
+  const usedNumbers = new Set(sessions.filter(s => s.number).map(s => s.number));
+  for (let i = 1; i <= 10; i++) {
+    if (!usedNumbers.has(i)) {
+      // 更新会话的编号
+      const updatedSessions = getActiveSessions();
+      const targetSession = updatedSessions.find(s => s.id === currentId);
+      if (targetSession) {
+        targetSession.number = i;
+        saveActiveSessions(updatedSessions);
+        return i;
+      }
+      return i;
+    }
+  }
+
+  return sessions.length + 1;
+}
+
+// 显示会话状态
+function displaySessionStatus() {
+  const sessions = getActiveSessions();
+  const currentId = getCurrentSessionId();
+  const currentNumber = getSessionNumber(sessions);
+
+  console.log(`\n🔄 [多会话] 当前会话: #${currentNumber} | 活跃会话: ${sessions.length}`);
+  console.log(`   主机: ${getSessionIdentifier()}`);
+
+  if (sessions.length > 1) {
+    console.log(`\n   其他活跃会话:`);
+    sessions
+      .filter(s => s.id !== currentId)
+      .forEach(s => {
+        const number = s.number || '?';
+        const duration = Math.round((Date.now() - s.startedAt) / 1000 / 60);
+        console.log(`   - 会话 #${number}: ${s.identifier} (${duration}分钟前启动)`);
+      });
+  }
+
+  console.log('');
+}
+
+// 主函数
+function main() {
+  try {
+    const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+
+    // 在每次交互时更新心跳
+    const sessions = updateHeartbeat();
+    const sessionNumber = getSessionNumber(sessions);
+
+    // 在会话开始或重要操作时显示状态
+    if (eventType === 'UserPromptSubmit' && toolInput.length > 20) {
+      // 只在较长的用户输入时显示，避免噪音
+      if (sessions.length > 1 || process.env.SHOW_SESSION_STATUS) {
+        console.log(`\n🔄 [会话 #${sessionNumber}] 活跃会话: ${sessions.length}\n`);
+      }
+    }
+
+    // 在会话结束时清理
+    if (eventType === 'AgentStop') {
+      const currentId = getCurrentSessionId();
+      const updatedSessions = getActiveSessions();
+      const index = updatedSessions.findIndex(s => s.id === currentId);
+      if (index !== -1) {
+        updatedSessions[index].status = 'ended';
+        updatedSessions[index].endedAt = Date.now();
+        saveActiveSessions(updatedSessions);
+      }
+    }
+
+  } catch (e) {
+    // 静默处理错误
+  }
+
+  process.exit(0);
+}
+
+// 如果直接运行此脚本，显示会话状态
+if (require.main === module && process.argv[2] === '--status') {
+  displaySessionStatus();
+} else {
+  main();
+}

package/template/.claude/hooks/project-kickoff.cjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * Project Kickoff Hook - Manus-style project initialization
+ *
+ * 触发条件:
+ * - 检测到新项目 (缺少 PROJECT_KICKOFF.md)
+ * - 用户明确请求项目启动
+ *
+ * 功能:
+ * - 检查项目是否已启动
+ * - 如果未启动，提示 AI 进行项目规划
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const TEMPLATES_DIR = path.join(PROJECT_DIR, '.claude/templates');
+const KICKOFF_FILE = path.join(PROJECT_DIR, 'PROJECT_KICKOFF.md');
+const PLAN_FILE = path.join(PROJECT_DIR, 'TASK_PLAN.md');
+const PROPOSAL_FILE = path.join(PROJECT_DIR, 'PROJECT_PROPOSAL.md');
+const HINT_FILE = path.join(PROJECT_DIR, '.claude/.kickoff-hint.txt');
+
+// 检查项目是否已启动
+function isProjectStarted() {
+  return fs.existsSync(KICKOFF_FILE);
+}
+
+// 检查是否为强制启动模式
+function isForceKickoff() {
+  const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+  return toolInput.includes('kickoff') ||
+         toolInput.includes('项目启动') ||
+         toolInput.includes('project plan') ||
+         toolInput.includes('重新规划');
+}
+
+// 生成启动提示
+function generateKickoffHint() {
+  const now = new Date().toISOString().split('T')[0];
+
+  return `
+╔══════════════════════════════════════════════════════════════════════╗
+║                    🚀 项目启动检测 (Project Kickoff)                 ║
+╚══════════════════════════════════════════════════════════════════════╝
+
+检测到此项目尚未完成启动流程。
+
+根据 Manus 风格的 AI 2.0 开发范式，在开始编码前，我们需要：
+
+═══════════════════════════════════════════════════════════════════════
+
+📋 第一步: 项目启动清单 (PROJECT_KICKOFF.md)
+   ├── 定义项目目标和成功标准
+   ├── 明确技术约束和非技术约束
+   └── 划定 AI/Human 责任边界
+
+📋 第二步: 任务执行计划 (TASK_PLAN.md)
+   ├── 任务分解 (WBS)
+   ├── 依赖关系分析
+   ├── Agent 分配策略
+   └── 检查点设置
+
+📋 第三步: 项目计划书 (PROJECT_PROPOSAL.md)
+   ├── 技术架构设计
+   ├── 功能需求分析
+   ├── 开发迭代规划
+   └── 风险评估
+
+═══════════════════════════════════════════════════════════════════════
+
+🎯 下一步行动:
+
+请回答以下问题，我将为你生成完整的项目规划：
+
+1. 项目名称是什么？
+2. 用一句话描述这个项目要解决什么问题？
+3. 核心目标是什么？（成功标准是什么？）
+4. 有什么技术约束或偏好？（语言/框架/部署等）
+5. 预期的时间框架是怎样的？
+
+回答这些问题后，我将：
+✅ 生成 PROJECT_KICKOFF.md
+✅ 生成 TASK_PLAN.md
+✅ 生成 PROJECT_PROPOSAL.md
+✅ 等待你的确认后开始执行
+
+═══════════════════════════════════════════════════════════════════════
+
+💡 提示: 你也可以直接说 "跳过启动" 使用传统开发模式
+
+生成日期: ${now}
+`;
+}
+
+// 主函数
+function main() {
+  // 如果项目已启动且不是强制模式，静默退出
+  if (isProjectStarted() && !isForceKickoff()) {
+    process.exit(0);
+  }
+
+  // 生成提示文件
+  const hint = generateKickoffHint();
+  fs.mkdirSync(path.dirname(HINT_FILE), { recursive: true });
+  fs.writeFileSync(HINT_FILE, hint);
+
+  // 同时输出到 stdout (供 AI 直接读取)
+  console.log(hint);
+
+  process.exit(0);
+}
+
+main();