sumulige-claude 1.5.1 → 1.5.2

package/.claude/THINKING_CHAIN_GUIDE.md

@@ -1,287 +0,0 @@
-# 思维链管理系统使用指南
-
-> 类似 GitLens，但用于对话和决策追踪
-
----
-
-## 🎯 核心功能
-
-| 功能 | 说明 |
-|------|------|
-| 📝 完整对话记录 | 记录每轮对话（用户 + AI） |
-| 🔗 决策追踪 | 自动识别并记录重要决策 |
-| 🔍 代码关联 | 追踪代码变更与决策的关系 |
-| 🚫 隐私保护 | 自动过滤 API Key 等敏感信息 |
-| 📤 导出功能 | 支持 JSON/Markdown/PDF 导出 |
-
----
-
-## 📂 数据结构
-
-```
-.claude/
-├── transcripts/              # 完整对话存档
-│   └── 2026/01/14.md        # 按日期组织
-├── decisions/                # 决策记录
-│   ├── DECISIONS.md         # 决策索引
-│   └── by-topic/            # 按主题分类
-├── code-trace/              # 代码变更追踪
-│   ├── files-map.json      # 文件 → 决策
-│   └── decisions-map.json  # 决策 → 文件
-└── export/                  # 导出目录
-```
-
----
-
-## 🚀 快速开始
-
-### 1. 查看今日对话
-
-```bash
-# 方式 1: 直接查看
-cat .claude/transcripts/$(date +%Y/%m/%d).md
-
-# 方式 2: 使用脚本
-node .claude/hooks/conversation-recorder.cjs today
-
-# 添加别名后
-today
-```
-
-### 2. 查看所有决策
-
-```bash
-# 方式 1: 直接查看
-cat .claude/decisions/DECISIONS.md
-
-# 方式 2: 使用脚本
-node .claude/hooks/decision-tracker.cjs list
-
-# 添加别名后
-decisions
-```
-
-### 3. 追踪代码来源
-
-```bash
-# 查看某个文件的决策历史
-node .claude/hooks/code-tracer.cjs trace src/file.ts
-
-# 添加别名后
-trace src/file.ts
-```
-
----
-
-## 📝 命令参考
-
-### 对话记录 (conversation-recorder.cjs)
-
-```bash
-# 记录用户消息
-node .claude/hooks/conversation-recorder.cjs user "消息内容"
-
-# 记录 AI 回复
-node .claude/hooks/conversation-recorder.cjs assistant "回复内容"
-
-# 手动记录决策
-node .claude/hooks/conversation-recorder.cjs decision "标题" "理由" "内容"
-
-# 查看今日对话
-node .claude/hooks/conversation-recorder.cjs today
-
-# 列出所有 transcript
-node .claude/hooks/conversation-recorder.cjs list
-```
-
-### 决策追踪 (decision-tracker.cjs)
-
-```bash
-# 手动添加决策
-node .claude/hooks/decision-tracker.cjs add "标题" "内容" "tag1,tag2"
-
-# 列出所有决策
-node .claude/hooks/decision-tracker.cjs list
-
-# 搜索决策
-node .claude/hooks/decision-tracker.cjs search "关键词"
-
-# 列出所有主题
-node .claude/hooks/decision-tracker.cjs topics
-
-# 从文本中提取决策
-node .claude/hooks/decision-tracker.cjs extract "文本内容"
-```
-
-### 代码追踪 (code-tracer.cjs)
-
-```bash
-# 查看文件的决策历史
-node .claude/hooks/code-tracer.cjs trace <文件路径>
-
-# 查看决策关联的文件
-node .claude/hooks/code-tracer.cjs decision <决策ID>
-
-# 手动关联文件到决策
-node .claude/hooks/code-tracer.cjs link <文件> <决策ID>
-
-# 显示所有关联
-node .claude/hooks/code-tracer.cjs all
-
-# 同步决策描述
-node .claude/hooks/code-tracer.cjs sync
-```
-
-### 隐私过滤 (privacy-filter.js)
-
-```bash
-# 检查文件是否包含敏感信息
-node .claude/hooks/privacy-filter.js --check <文件>
-
-# 过滤敏感信息
-node .claude/hooks/privacy-filter.js --filter <输入> [输出]
-
-# 列出所有过滤模式
-node .claude/hooks/privacy-filter.js --patterns
-```
-
-### 导出 (export.cjs)
-
-```bash
-# 导出为 JSON
-node .claude/hooks/export.cjs json [文件名]
-
-# 导出为 Markdown
-node .claude/hooks/export.cjs md [文件名]
-
-# 导出为 PDF（需要 pandoc）
-node .claude/hooks/export.cjs pdf
-
-# 只导出决策
-node .claude/hooks/export.cjs decisions
-
-# 只导出对话
-node .claude/hooks/export.cjs transcripts
-
-# 列出导出文件
-node .claude/hooks/export.cjs list
-
-# 清理导出文件
-node .claude/hooks/export.cjs clean
-```
-
----
-
-## ⚡ 推荐别名
-
-添加到 `~/.zshrc` 或 `~/.bashrc`：
-
-```bash
-# 对话历史
-alias today='node .claude/hooks/conversation-recorder.cjs today'
-alias transcripts='node .claude/hooks/conversation-recorder.cjs list'
-
-# 决策
-alias decisions='node .claude/hooks/decision-tracker.cjs list'
-alias dadd='node .claude/hooks/decision-tracker.cjs add'
-alias dsearch='node .claude/hooks/decision-tracker.cjs search'
-alias dtopics='node .claude/hooks/decision-tracker.cjs topics'
-
-# 代码追踪
-alias trace='node .claude/hooks/code-tracer.cjs trace'
-alias dtrace='node .claude/hooks/code-tracer.cjs decision'
-alias codelink='node .claude/hooks/code-tracer.cjs link'
-
-# 导出
-alias export='node .claude/hooks/export.cjs'
-```
-
----
-
-## 🔒 隐私保护
-
-系统会自动过滤以下敏感信息：
-
-| 类型 | 示例 |
-|------|------|
-| API Key | `sk-xxxxx` → `sk-[REDACTED]` |
-| Bearer Token | `Bearer xxxxx` → `Bearer [REDACTED]` |
-| AWS Key | `AKIAxxxxx` → `AKIA[REDACTED]` |
-| GitHub Token | `ghp_xxxxx` → `ghp_[REDACTED]` |
-| 配置中的密钥 | `key: "xxxxx"` → `key: [REDACTED]` |
-
----
-
-## 📊 工作流示例
-
-### 场景：实现一个新功能
-
-1. **开始对话** → 系统自动记录到 `transcripts/`
-2. **做出决策** → 系统自动识别并记录到 `decisions/`
-3. **修改代码** → 手动关联代码到决策
-4. **完成回顾** → 导出完整记录
-
-```bash
-# 查看今天做了什么
-today
-
-# 查看所有相关决策
-decisions | grep "功能"
-
-# 追踪某个文件的来源
-trace src/feature.ts
-
-# 导出完整记录
-export json my-feature.json
-```
-
----
-
-## 📱 VSCode 集成
-
-在 `.vscode/settings.json` 中添加：
-
-```json
-{
-  "files.exclude": {
-    "**/.claude/transcripts": true,
-    "**/.claude/code-trace": true
-  },
-  "search.exclude": {
-    "**/.claude/export": true
-  }
-}
-```
-
----
-
-## 🔄 数据持久化
-
-- 所有数据存储在本地项目 `.claude/` 目录
-- 已配置 `.gitignore`，不会提交到 git
-- 可随时使用 `export.cjs` 导出备份
-
----
-
-## 🤝 AI 辅助
-
-系统会自动：
-
-- **识别决策**：检测对话中的决策关键词
-- **分类主题**：自动为决策打标签
-- **过滤隐私**：自动替换敏感信息
-- **关联代码**：追踪文件变更
-
-你也可以手动：
-
-- **添加决策**：使用 `dadd` 命令
-- **关联代码**：使用 `codelink` 命令
-- **修正分类**：编辑 `decisions/by-topic/` 文件
-
----
-
-## 📚 更多
-
-- 查看决策按主题：`cat .claude/decisions/by-topic/*.md`
-- 搜索历史对话：`grep -r "关键词" .claude/transcripts/`
-- 查看完整思维链：`node .claude/hooks/export.cjs md && open .claude/export/`

package/.claude/USAGE.md

@@ -1,175 +0,0 @@
-# Skills 系统使用手册
-
-> 版本: 2.0.0 | 更新日期: 2026-01-22
-
----
-
-## 核心 Skills
-
-| Skill | 命令 | 触发时机 | 作用 | 模型 |
-|-------|------|---------|------|------|
-| `quality-guard` | `/review` | 提交前、PR 审查 | 代码质量 + 安全检查 + 清理建议 | sonnet |
-| `test-master` | `/test` | 实现功能后 | TDD + E2E + 覆盖率分析 | sonnet |
-| `design-brain` | `/plan` | 开始新任务前 | 规划 + 架构设计 | opus |
-| `quick-fix` | `/fix` | 构建失败时 | 快速修复错误 | haiku |
-
----
-
-## 命令速查表
-
-### /review - 代码审查
-
-```bash
-/review              # 标准代码审查
-/review --security   # 安全深度扫描 (OWASP Top 10)
-/review --clean      # 死代码清理建议
-/review --all        # 完整审查
-```
-
-**触发时机**:
-- 准备提交代码前
-- PR 审查时
-- 怀疑有安全问题时
-
-### /test - 测试
-
-```bash
-/test                # 运行单元测试
-/test --tdd          # TDD 开发模式 (RED→GREEN→REFACTOR)
-/test --e2e          # E2E 测试 (Playwright)
-/test --coverage     # 覆盖率报告
-/test --all          # 完整测试套件
-```
-
-**触发时机**:
-- 完成功能实现后
-- 修复 bug 后
-- 提交前验证
-
-### /plan - 规划
-
-```bash
-/plan                # 快速规划（默认）
-/plan --deep         # 深度设计（架构决策）
-/plan --arch         # 仅架构设计
-```
-
-**触发时机**:
-- 开始新功能开发前
-- 重大重构前
-- 技术选型时
-
-### /fix - 快速修复
-
-```bash
-/fix                 # 自动检测并修复
-/fix --build         # 修复构建错误
-/fix --lint          # 修复 lint 错误
-/fix --type          # 修复类型错误
-/fix --all           # 修复所有错误
-```
-
-**触发时机**:
-- `npm run build` 失败
-- `tsc` 报类型错误
-- ESLint 报错
-
-### /refactor - 重构
-
-```bash
-/refactor            # 分析并建议清理
-/refactor --dead     # 查找死代码
-/refactor --deps     # 查找未使用依赖
-/refactor --duplicate # 查找重复代码
-/refactor --execute  # 执行清理（需确认）
-```
-
-**触发时机**:
-- 代码库变大需要清理
-- 发现重复代码
-- 依赖需要整理
-
----
-
-## 模型成本策略
-
-| 模型 | 使用场景 | 相对成本 | 速度 |
-|------|---------|---------|------|
-| **haiku** | `/fix` 快速修复 | 1x (最低) | 最快 |
-| **sonnet** | `/review`, `/test` 标准任务 | 5x | 中等 |
-| **opus** | `/plan --deep` 复杂架构 | 15x | 较慢 |
-
-**自动选择规则**:
-- 简单修复 → haiku（节省成本）
-- 代码审查/测试 → sonnet（平衡性价比）
-- 架构设计 → opus（仅在需要深度分析时）
-
----
-
-## 工作流示例
-
-### 新功能开发
-
-```
-1. /plan              # 规划实现步骤
-2. 编写代码           # 实现功能
-3. /fix               # 修复编译错误
-4. /test --tdd        # 补充测试
-5. /review            # 代码审查
-6. /commit            # 提交代码
-```
-
-### Bug 修复
-
-```
-1. /test              # 确认失败的测试
-2. 修复代码           # 实现修复
-3. /fix               # 确保编译通过
-4. /test              # 验证测试通过
-5. /review --security # 安全检查
-6. /commit            # 提交修复
-```
-
-### 代码清理
-
-```
-1. /refactor          # 分析代码库
-2. /refactor --dead   # 找死代码
-3. /refactor --deps   # 找未用依赖
-4. /refactor --execute # 执行清理
-5. /test              # 确保不破坏功能
-6. /commit            # 提交清理
-```
-
----
-
-## 自动加载
-
-Skills 会根据用户输入自动加载：
-
-```json
-{
-  "auto_load": {
-    "enabled": true,
-    "confidence_threshold": 0.7,
-    "max_skills_per_task": 3
-  }
-}
-```
-
-**关键词触发示例**:
-- "review code" → `quality-guard`
-- "fix build error" → `quick-fix`
-- "plan architecture" → `design-brain`
-- "run tests" → `test-master`
-
----
-
-## 配置文件
-
-| 文件 | 说明 |
-|------|------|
-| `.claude/rag/skill-index.json` | Skill 索引和模型策略 |
-| `.claude/skills/*/metadata.yaml` | 各 Skill 配置 |
-| `.claude/skills/*/SKILL.md` | Skill 详细指令 |
-| `.claude/commands/*.md` | 命令定义 |

package/.claude/boris-optimizations.md

@@ -1,167 +0,0 @@
-# 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/handoffs/INDEX.md

@@ -1,21 +0,0 @@
-# Handoffs Index
-
-> Auto-generated context preservation documents
-> Updated: 2026-01-22T13:07:04.758Z
-
----
-
-## Recent Handoffs (1)
-
-- [handoff_2026-01-22T13-07-04-757Z.md](./handoff_2026-01-22T13-07-04-757Z.md) - 2026-01-22T13:07:04.758Z
-
-
----
-
-## Latest Handoff
-
-See [LATEST.md](./LATEST.md) for the most recent context snapshot.
-
----
-
-*Index maintained by auto-handoff.cjs*

package/.claude/handoffs/LATEST.md

@@ -1,76 +0,0 @@
-# Handoff: Pre-Compact Context Preservation
-
-> Auto-generated before context compression
-> Date: 2026-01-22T13:07:04.742Z
-> Session: unknown
-> Conversation: unknown
-
----
-
-## Session Info
-
-- **Project**: sumulige-claude
-- **Version**: 1.3.1
-- **Start Time**: 2026-01-22T13:06:23.872Z
-
----
-
-## Memory State
-
-- **Entries Loaded**: 4
-- **Anchors Modules**: 0
-
----
-
-## Active TODOs (0)
-
-*No active TODOs*
-
-
----
-
-## Recently Modified Files (Last 24h)
-
-- `.claude/.session-state.json` (2026-01-22)
-- `.claude/settings.local.json` (2026-01-22)
-- `.claude/settings.json` (2026-01-22)
-- `.claude/hooks/auto-handoff.cjs` (2026-01-22)
-- `.claude/hooks/memory-saver.cjs` (2026-01-22)
-- `.claude/hooks/memory-loader.cjs` (2026-01-22)
-- `.claude/.kickoff-hint.txt` (2026-01-22)
-- `.claude/skills/xlsx/LICENSE.txt` (2026-01-22)
-- `.claude/skills/web-artifacts-builder/LICENSE.txt` (2026-01-22)
-- `.claude/skills/webapp-testing/LICENSE.txt` (2026-01-22)
-- *...and 10 more files*
-
-
----
-
-## Context Preservation Notes
-
-**Important**: This handoff was auto-generated before context compaction.
-The following information should be re-loaded after compaction:
-
-1. Read `.claude/MEMORY.md` for recent session context
-2. Check `development/todos/INDEX.md` for task status
-3. Review recent git commits for code changes
-
----
-
-## Recovery Commands
-
-```bash
-# View recent memory
-cat .claude/MEMORY.md | head -100
-
-# Check active TODOs
-ls development/todos/active/
-
-# View recent changes
-git log --oneline -10
-git status
-```
-
----
-
-*Auto-generated by auto-handoff.cjs at 2026-01-22T13:07:04.742Z*