sumulige-claude 1.2.0 → 1.3.0

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/fix.md

@@ -0,0 +1,83 @@
+---
+description: Quick fix for build, lint, and type errors
+---
+
+# /fix
+
+快速修复构建错误、lint 错误、类型错误。
+
+## 使用方式
+
+```bash
+/fix              # 自动检测并修复（默认）
+/fix --build      # 修复构建错误
+/fix --lint       # 修复 lint 错误
+/fix --type       # 修复类型错误
+/fix --all        # 修复所有错误
+```
+
+## 关联 Skill
+
+此命令加载 `quick-fix` skill（使用 haiku 模型，快速响应）。
+
+---
+
+## 工作流程
+
+### Step 1: 错误检测
+
+```bash
+# 构建错误
+npm run build 2>&1 | head -100
+
+# 类型错误
+npx tsc --noEmit 2>&1 | head -50
+
+# Lint 错误
+npx eslint . --format json 2>&1 | head -100
+```
+
+### Step 2: 错误分类
+
+| 类型 | 示例 | 策略 |
+|------|------|------|
+| 类型错误 | `TS2345` | 添加类型或断言 |
+| 导入错误 | `Cannot find module` | 检查路径 |
+| 语法错误 | `Unexpected token` | 修复语法 |
+| Lint 错误 | `no-unused-vars` | 删除或使用 |
+
+### Step 3: 增量修复
+
+```
+原则：每次只修复一个错误
+
+1. 读取第一个错误
+2. 定位文件和行号
+3. 应用最小修复
+4. 重新编译验证
+5. 重复直到全部修复
+```
+
+### Step 4: 输出报告
+
+```markdown
+# Quick Fix Report
+
+## Errors Found: X
+## Fixed: Y
+## Remaining: Z
+
+| File | Line | Error | Fix |
+|------|------|-------|-----|
+
+## Build Status
+✅ SUCCESS / ❌ FAILED
+```
+
+---
+
+## 原则
+
+- **快速** - 使用轻量模型
+- **最小** - 只做必要修改
+- **安全** - 不确定的不修复

package/.claude/commands/plan.md

@@ -0,0 +1,88 @@
+---
+description: Plan implementation with architecture design
+---
+
+# /plan
+
+为功能或任务创建实现计划，支持快速规划和深度设计。
+
+## 使用方式
+
+```bash
+/plan              # 快速规划（默认）
+/plan --deep       # 深度设计（架构决策）
+/plan --arch       # 仅架构设计
+```
+
+## 关联 Skill
+
+此命令加载 `design-brain` skill（复杂任务使用 opus）。
+
+---
+
+## 工作流程
+
+### 快速规划（默认）
+
+```markdown
+# Plan: [功能名称]
+
+## Goal
+[一句话描述]
+
+## Steps
+1. [ ] [步骤 1]
+2. [ ] [步骤 2]
+3. [ ] [步骤 3]
+
+## Files
+- `path/to/file.ts` - [修改内容]
+
+## Risk
+- [主要风险] → [缓解策略]
+```
+
+### 深度设计（--deep）
+
+```markdown
+# Design: [系统名称]
+
+## Overview
+[背景和目标]
+
+## Architecture
+[组件图 + 数据流]
+
+## Technical Decisions
+| Decision | Choice | Reason | Trade-offs |
+|----------|--------|--------|------------|
+
+## Implementation Plan
+### Phase 1: [阶段名]
+1. [ ] Step 1
+2. [ ] Step 2
+
+## Risks
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+
+## Success Criteria
+- [ ] 标准 1
+- [ ] 标准 2
+```
+
+---
+
+## 设计原则
+
+1. **简单优于复杂** - 能用简单方案就不要复杂化
+2. **最小变更** - 优先复用现有代码
+3. **可测试性** - 每个步骤都可验证
+
+## 使用场景
+
+| 场景 | 推荐模式 |
+|------|---------|
+| 小功能/bug 修复 | 快速规划 |
+| 新模块/系统 | 深度设计 |
+| 技术选型 | --arch |

package/.claude/commands/refactor.md

@@ -0,0 +1,102 @@
+---
+description: Safe code refactoring and cleanup
+---
+
+# /refactor
+
+安全的代码重构和清理。
+
+## 使用方式
+
+```bash
+/refactor              # 分析并建议清理（默认）
+/refactor --dead       # 查找死代码
+/refactor --deps       # 查找未使用依赖
+/refactor --duplicate  # 查找重复代码
+/refactor --execute    # 执行清理（需确认）
+```
+
+## 关联 Skill
+
+此命令加载 `quality-guard` skill（清理模式）。
+
+---
+
+## 工作流程
+
+### Step 1: 运行分析工具
+
+```bash
+# 未使用的文件、导出、依赖
+npx knip
+
+# 未使用的 npm 依赖
+npx depcheck
+
+# 未使用的 TypeScript 导出
+npx ts-prune
+
+# 未使用的 eslint-disable
+npx eslint . --report-unused-disable-directives
+```
+
+### Step 2: 风险分类
+
+| 风险 | 类型 | 处理 |
+|------|------|------|
+| 🟢 SAFE | 未使用导出、测试文件 | 可直接删除 |
+| 🟡 CAREFUL | 动态导入可能使用 | 需验证 |
+| 🔴 RISKY | 公共 API、配置文件 | 谨慎处理 |
+
+### Step 3: 生成报告
+
+```markdown
+# Refactor Report
+
+## Dead Code
+| File | Type | Risk | Reason |
+|------|------|------|--------|
+
+## Unused Dependencies
+| Package | Size | Last Used |
+|---------|------|-----------|
+
+## Duplicate Code
+| Location 1 | Location 2 | Lines |
+|------------|------------|-------|
+
+## Recommended Actions
+1. [ ] Remove unused-package (SAFE)
+2. [ ] Delete src/old.ts (SAFE)
+3. [ ] Review src/utils.ts (CAREFUL)
+
+## Impact
+- Files to delete: X
+- Dependencies to remove: Y
+- Lines of code: -Z
+```
+
+### Step 4: 执行清理（--execute）
+
+```
+⚠️ 执行前：
+1. 创建备份分支
+2. 确保测试通过
+3. 逐个删除，每删一个运行测试
+4. 记录到 DELETION_LOG.md
+```
+
+---
+
+## 安全检查清单
+
+删除前：
+- [ ] grep 所有引用
+- [ ] 检查动态导入
+- [ ] 查看 git 历史
+- [ ] 运行所有测试
+
+删除后：
+- [ ] 构建成功
+- [ ] 测试通过
+- [ ] 提交变更

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
 

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

@@ -15,11 +15,6 @@ const { spawn } = require('child_process');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 
-// 如果不在 Claude Code 环境中运行，静默退出
-if (!process.env.CLAUDE_PROJECT_DIR) {
-  process.exit(0);
-}
-
 // 支持的格式化器配置
 const FORMATTERS = {
   // JavaScript/TypeScript
@@ -178,8 +173,8 @@ function main() {
 
     // 输出格式化结果（可选，用于调试）
     if (formatted.length > 0 && process.env.DEBUG_FORMATTER) {
-      console.error(`\n🎨 [格式化] 已格式化 ${formatted.length} 个文件:`);
-      formatted.forEach(f => console.error(`   - ${f.file} (${f.formatter})`));
+      console.log(`\n🎨 [格式化] 已格式化 ${formatted.length} 个文件:`);
+      formatted.forEach(f => console.log(`   - ${f.file} (${f.formatter})`));
     }
 
   } catch (e) {