sumulige-claude 1.5.1 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (223) hide show
  1. package/.claude/hooks/hook-registry.json +0 -15
  2. package/.claude/rules/coding-style.md +18 -7
  3. package/.claude/rules/hooks.md +15 -4
  4. package/.claude/rules/performance.md +15 -5
  5. package/.claude/rules/security.md +140 -4
  6. package/.claude/rules/testing.md +138 -9
  7. package/.claude/rules/web-design-standard.md +16 -5
  8. package/.claude/skills/algorithmic-art/metadata.yaml +28 -0
  9. package/.claude/skills/api-tester/SKILL.md +61 -0
  10. package/.claude/skills/api-tester/examples/basic.md +3 -0
  11. package/.claude/skills/api-tester/metadata.yaml +30 -0
  12. package/.claude/skills/api-tester/templates/default.md +3 -0
  13. package/.claude/skills/brand-guidelines/metadata.yaml +26 -0
  14. package/.claude/skills/canvas-design/metadata.yaml +27 -0
  15. package/.claude/skills/code-reviewer-123/SKILL.md +61 -0
  16. package/.claude/skills/code-reviewer-123/examples/basic.md +3 -0
  17. package/.claude/skills/code-reviewer-123/metadata.yaml +30 -0
  18. package/.claude/skills/code-reviewer-123/templates/default.md +3 -0
  19. package/.claude/skills/doc-coauthoring/metadata.yaml +27 -0
  20. package/.claude/skills/docx/metadata.yaml +30 -0
  21. package/.claude/skills/frontend-design/metadata.yaml +28 -0
  22. package/.claude/skills/internal-comms/metadata.yaml +28 -0
  23. package/.claude/skills/mcp-builder/metadata.yaml +26 -0
  24. package/.claude/skills/my-skill/SKILL.md +61 -0
  25. package/.claude/skills/my-skill/examples/basic.md +3 -0
  26. package/.claude/skills/my-skill/metadata.yaml +30 -0
  27. package/.claude/skills/my-skill/templates/default.md +3 -0
  28. package/.claude/skills/pdf/metadata.yaml +29 -0
  29. package/.claude/skills/pptx/metadata.yaml +29 -0
  30. package/.claude/skills/react-best-practices/metadata.yaml +26 -0
  31. package/.claude/skills/react-node-practices/SKILL.md +409 -0
  32. package/.claude/skills/react-node-practices/metadata.yaml +56 -0
  33. package/.claude/skills/skill-creator/metadata.yaml +25 -0
  34. package/.claude/skills/slack-gif-creator/metadata.yaml +28 -0
  35. package/.claude/skills/test-skill-name/SKILL.md +61 -0
  36. package/.claude/skills/test-skill-name/examples/basic.md +3 -0
  37. package/.claude/skills/test-skill-name/metadata.yaml +30 -0
  38. package/.claude/skills/test-skill-name/templates/default.md +3 -0
  39. package/.claude/skills/test-workflow/metadata.yaml +32 -0
  40. package/.claude/skills/theme-factory/metadata.yaml +26 -0
  41. package/.claude/skills/threejs-fundamentals/metadata.yaml +27 -0
  42. package/.claude/skills/web-artifacts-builder/metadata.yaml +30 -0
  43. package/.claude/skills/web-design-guidelines/metadata.yaml +26 -0
  44. package/.claude/skills/webapp-testing/metadata.yaml +26 -0
  45. package/.claude/skills/xlsx/metadata.yaml +29 -0
  46. package/LICENSE +21 -0
  47. package/README.md +280 -529
  48. package/cli.js +19 -3
  49. package/package.json +29 -3
  50. package/template/.codex/README.md +69 -0
  51. package/template/.codex/config.toml +56 -0
  52. package/template/AGENTS.md +94 -0
  53. package/.claude/.kickoff-hint.txt +0 -52
  54. package/.claude/.sumulige-claude-version +0 -1
  55. package/.claude/.version +0 -1
  56. package/.claude/AGENTS.md +0 -42
  57. package/.claude/ANCHORS.md +0 -40
  58. package/.claude/CLAUDE.md +0 -138
  59. package/.claude/MEMORY.md +0 -69
  60. package/.claude/PROJECT_LOG.md +0 -101
  61. package/.claude/THINKING_CHAIN_GUIDE.md +0 -287
  62. package/.claude/USAGE.md +0 -175
  63. package/.claude/boris-optimizations.md +0 -167
  64. package/.claude/handoffs/INDEX.md +0 -21
  65. package/.claude/handoffs/LATEST.md +0 -76
  66. package/.claude/handoffs/handoff_2026-01-22T13-07-04-757Z.md +0 -76
  67. package/.claude/quality-gate.json +0 -82
  68. package/.claude/rag/skill-index.json +0 -135
  69. package/.claude/settings.json +0 -99
  70. package/.claude/settings.local.json +0 -175
  71. package/.claude/templates/PROJECT_KICKOFF.md +0 -89
  72. package/.claude/templates/PROJECT_PROPOSAL.md +0 -227
  73. package/.claude/templates/TASK_PLAN.md +0 -121
  74. package/.claude/templates/hooks/README.md +0 -302
  75. package/.claude/templates/hooks/hook.sh.template +0 -94
  76. package/.claude/templates/hooks/user-prompt-submit.cjs.template +0 -116
  77. package/.claude/templates/hooks/user-response-submit.cjs.template +0 -94
  78. package/.claude/templates/hooks/validate.js +0 -173
  79. package/.claude/templates/tasks/develop.md +0 -69
  80. package/.claude/templates/tasks/research.md +0 -64
  81. package/.claude/templates/tasks/test.md +0 -96
  82. package/.claude/thinking-routes/.last-sync +0 -1
  83. package/.claude/thinking-routes/QUICKREF.md +0 -98
  84. package/.claude/workflow/document-scanner.js +0 -426
  85. package/.claude/workflow/knowledge-engine.js +0 -941
  86. package/.claude/workflow/notebooklm/browser.js +0 -1028
  87. package/.claude/workflow/phases/phase1-research.js +0 -578
  88. package/.claude/workflow/phases/phase1-research.ts +0 -465
  89. package/.claude/workflow/phases/phase2-approve.js +0 -722
  90. package/.claude/workflow/phases/phase3-plan.js +0 -1200
  91. package/.claude/workflow/phases/phase4-develop.js +0 -894
  92. package/.claude/workflow/search-cache.js +0 -230
  93. package/.claude/workflow/templates/approval.md +0 -315
  94. package/.claude/workflow/templates/development.md +0 -377
  95. package/.claude/workflow/templates/planning.md +0 -328
  96. package/.claude/workflow/templates/research.md +0 -250
  97. package/.claude/workflow/types.js +0 -37
  98. package/.claude/workflow/web-search.js +0 -278
  99. package/.claude-plugin/marketplace.json +0 -71
  100. package/.github/workflows/sync-skills.yml +0 -74
  101. package/.versionrc +0 -25
  102. package/AGENTS.md +0 -580
  103. package/CHANGELOG.md +0 -481
  104. package/CLAUDE-template.md +0 -114
  105. package/DEV_TOOLS_GUIDE.md +0 -190
  106. package/PROJECT_STRUCTURE.md +0 -266
  107. package/Q&A.md +0 -325
  108. package/config/defaults.json +0 -34
  109. package/config/official-skills.json +0 -183
  110. package/config/quality-gate.json +0 -67
  111. package/config/skill-categories.json +0 -40
  112. package/config/version-manifest.json +0 -85
  113. package/demos/power-3d-scatter.html +0 -683
  114. package/development/cache/web-search/search_1193d605f8eb364651fc2f2041b58a31.json +0 -36
  115. package/development/cache/web-search/search_3798bf06960edc125f744a1abb5b72c5.json +0 -36
  116. package/development/cache/web-search/search_37c7d4843a53f0d83f1122a6f908a2a3.json +0 -36
  117. package/development/cache/web-search/search_44166fa0153709ee168485a22aa0ab40.json +0 -36
  118. package/development/cache/web-search/search_4deaebb1f77e86a8ca066dc5a49c59fd.json +0 -36
  119. package/development/cache/web-search/search_94da91789466070a7f545612e73c7372.json +0 -36
  120. package/development/cache/web-search/search_dd5de8491b8b803a3cb01339cd210fb0.json +0 -36
  121. package/development/knowledge-base/.index.clean.json +0 -1
  122. package/development/knowledge-base/.index.json +0 -486
  123. package/development/knowledge-base/test-best-practices.md +0 -29
  124. package/development/projects/proj_mkh1pazz_ixmt1/phase1/feasibility-report.md +0 -160
  125. package/development/projects/proj_mkh4jvnb_z7rwf/phase1/feasibility-report.md +0 -160
  126. package/development/projects/proj_mkh4jxkd_ewz5a/phase1/feasibility-report.md +0 -160
  127. package/development/projects/proj_mkh4k84n_ni73k/phase1/feasibility-report.md +0 -160
  128. package/development/projects/proj_mkh4wfyd_u9w88/phase1/feasibility-report.md +0 -160
  129. package/development/projects/proj_mkh4wsbo_iahvf/development/projects/proj_mkh4xbpg_4na5w/phase1/feasibility-report.md +0 -160
  130. package/development/projects/proj_mkh4wsbo_iahvf/phase1/feasibility-report.md +0 -160
  131. package/development/projects/proj_mkh4xulg_1ka8x/phase1/feasibility-report.md +0 -160
  132. package/development/projects/proj_mkh4xwhj_gch8j/phase1/feasibility-report.md +0 -160
  133. package/development/projects/proj_mkh4y2qk_9lm8z/phase1/feasibility-report.md +0 -160
  134. package/development/projects/proj_mkh4y2qk_9lm8z/phase2/requirements.md +0 -226
  135. package/development/projects/proj_mkh4y2qk_9lm8z/phase3/PRD.md +0 -345
  136. package/development/projects/proj_mkh4y2qk_9lm8z/phase3/TASK_PLAN.md +0 -284
  137. package/development/projects/proj_mkh4y2qk_9lm8z/phase3/prototype/README.md +0 -14
  138. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/DEVELOPMENT_LOG.md +0 -35
  139. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/TASKS.md +0 -34
  140. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/.env.example +0 -5
  141. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/README.md +0 -60
  142. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/package.json +0 -25
  143. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/src/index.js +0 -70
  144. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/src/routes/index.js +0 -48
  145. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/tests/health.test.js +0 -20
  146. package/development/projects/proj_mkh4y2qk_9lm8z/phase4/source/tests/jest.config.js +0 -21
  147. package/development/projects/proj_mkh7veqg_3lypc/phase1/feasibility-report.md +0 -160
  148. package/development/projects/proj_mkh7veqg_3lypc/phase2/requirements.md +0 -226
  149. package/development/projects/proj_mkh7veqg_3lypc/phase3/PRD.md +0 -345
  150. package/development/projects/proj_mkh7veqg_3lypc/phase3/TASK_PLAN.md +0 -284
  151. package/development/projects/proj_mkh7veqg_3lypc/phase3/prototype/README.md +0 -14
  152. package/development/projects/proj_mkh8k8fo_rmqn5/phase1/feasibility-report.md +0 -160
  153. package/development/projects/proj_mkh8xyhy_1vshq/phase1/feasibility-report.md +0 -178
  154. package/development/projects/proj_mkh8zddd_dhamf/phase1/feasibility-report.md +0 -377
  155. package/development/projects/proj_mkh8zddd_dhamf/phase2/requirements.md +0 -442
  156. package/development/projects/proj_mkh8zddd_dhamf/phase3/api-design.md +0 -800
  157. package/development/projects/proj_mkh8zddd_dhamf/phase3/architecture.md +0 -625
  158. package/development/projects/proj_mkh8zddd_dhamf/phase3/data-model.md +0 -830
  159. package/development/projects/proj_mkh8zddd_dhamf/phase3/risks.md +0 -957
  160. package/development/projects/proj_mkh8zddd_dhamf/phase3/wbs.md +0 -381
  161. package/development/todos/.state.json +0 -19
  162. package/development/todos/INDEX.md +0 -63
  163. package/development/todos/active/_README.md +0 -49
  164. package/development/todos/archived/_README.md +0 -11
  165. package/development/todos/backlog/_README.md +0 -11
  166. package/development/todos/backlog/mcp-integration.md +0 -35
  167. package/development/todos/completed/_README.md +0 -11
  168. package/development/todos/completed/boris-optimizations.md +0 -39
  169. package/development/todos/completed/develop/local-knowledge-index.md +0 -85
  170. package/development/todos/completed/develop/todo-system.md +0 -47
  171. package/development/todos/completed/develop/web-search-integration.md +0 -83
  172. package/development/todos/completed/test/phase1-e2e-test.md +0 -103
  173. package/docs/DEVELOPMENT.md +0 -461
  174. package/docs/MARKETPLACE.md +0 -352
  175. package/docs/RELEASE.md +0 -93
  176. package/jest.config.js +0 -63
  177. package/lib/commands.js +0 -3588
  178. package/lib/config-manager.js +0 -441
  179. package/lib/config-schema.js +0 -408
  180. package/lib/config-validator.js +0 -330
  181. package/lib/config.js +0 -122
  182. package/lib/errors.js +0 -305
  183. package/lib/incremental-sync.js +0 -274
  184. package/lib/marketplace.js +0 -487
  185. package/lib/migrations.js +0 -154
  186. package/lib/permission-audit.js +0 -255
  187. package/lib/quality-gate.js +0 -431
  188. package/lib/quality-rules.js +0 -373
  189. package/lib/utils.js +0 -150
  190. package/lib/version-check.js +0 -169
  191. package/lib/version-manifest.js +0 -171
  192. package/project-paradigm.md +0 -313
  193. package/prompts/how-to-find.md +0 -163
  194. package/prompts/linus-architect.md +0 -71
  195. package/prompts/software-architect.md +0 -173
  196. package/prompts/web-designer.md +0 -249
  197. package/scripts/fix-hooks.mjs +0 -97
  198. package/scripts/sync-external.mjs +0 -298
  199. package/scripts/sync-to-home.sh +0 -108
  200. package/scripts/update-registry.mjs +0 -325
  201. package/sources.yaml +0 -83
  202. package/tests/README.md +0 -263
  203. package/tests/commands.test.js +0 -1086
  204. package/tests/config-manager.test.js +0 -677
  205. package/tests/config-schema.test.js +0 -425
  206. package/tests/config-validator.test.js +0 -436
  207. package/tests/config.test.js +0 -100
  208. package/tests/errors.test.js +0 -477
  209. package/tests/manual/phase1-e2e.sh +0 -389
  210. package/tests/manual/phase2-test-cases.md +0 -311
  211. package/tests/manual/phase3-test-cases.md +0 -309
  212. package/tests/manual/phase4-test-cases.md +0 -414
  213. package/tests/manual/test-cases.md +0 -417
  214. package/tests/marketplace.test.js +0 -420
  215. package/tests/migrations.test.js +0 -187
  216. package/tests/quality-gate.test.js +0 -679
  217. package/tests/quality-rules.test.js +0 -619
  218. package/tests/sync-external.test.js +0 -214
  219. package/tests/update-registry.test.js +0 -251
  220. package/tests/utils.test.js +0 -171
  221. package/tests/version-check.test.js +0 -75
  222. package/tests/web-search.test.js +0 -392
  223. package/thinkinglens-silent.md +0 -138
@@ -1,101 +0,0 @@
1
- # 项目日志
2
-
3
- > 完整的开发历史记录
4
-
5
- ---
6
-
7
- ## 2026-01-14 - SMC 系统初始化
8
-
9
- ### 背景
10
- 项目 `.claude/` 目录缺少对话历史追踪系统,所有文件存在于 `template/.claude/` 中未同步。
11
-
12
- ### 执行
13
- 1. 同步 `hooks/` - 10 个自动化脚本
14
- 2. 同步 `thinking-routes/` - 对话流数据目录
15
- 3. 同步 `commands/` - 9 个技能命令定义
16
- 4. 创建核心记忆文件 (MEMORY.md, PROJECT_LOG.md, ANCHORS.md)
17
- 5. 初始化对话流数据结构
18
-
19
- ### 结果
20
- - ✅ 完整的对话历史追踪系统上线
21
- - ✅ 支持多会话并行管理
22
- - ✅ 自动记录对话流数据
23
- - ✅ 快速查询命令可用 (tl, log, memory)
24
-
25
- ---
26
-
27
- ## 2026-01-14 - 对话摘要
28
-
29
- ### 统计
30
- - 对话轮次: 21
31
- - 会话 ID: session-init
32
-
33
- ### 工具使用
34
- - unknown: 21
35
-
36
- ### 最近活动
37
- - 07:46 unknown
38
- - 07:46 unknown
39
- - 07:46 unknown
40
-
41
- ---
42
- ## 2026-01-14 - 对话摘要
43
-
44
- ### 统计
45
- - 对话轮次: 40
46
- - 会话 ID: session-init
47
-
48
- ### 工具使用
49
- - unknown: 40
50
-
51
- ### 最近活动
52
- - 08:13 unknown
53
- - 08:13 unknown
54
- - 08:13 unknown
55
-
56
- ---
57
- ## 2026-01-14 - 对话摘要
58
-
59
- ### 统计
60
- - 对话轮次: 60
61
- - 会话 ID: session-init
62
-
63
- ### 工具使用
64
- - unknown: 60
65
-
66
- ### 最近活动
67
- - 08:31 unknown
68
- - 08:31 unknown
69
- - 08:31 unknown
70
-
71
- ---
72
- ## 2026-01-14 - 对话摘要
73
-
74
- ### 统计
75
- - 对话轮次: 80
76
- - 会话 ID: session-init
77
-
78
- ### 工具使用
79
- - unknown: 80
80
-
81
- ### 最近活动
82
- - 08:32 unknown
83
- - 08:32 unknown
84
- - 08:32 unknown
85
-
86
- ---
87
- ## 2026-01-14 - 对话摘要
88
-
89
- ### 统计
90
- - 对话轮次: 100
91
- - 会话 ID: session-init
92
-
93
- ### 工具使用
94
- - unknown: 100
95
-
96
- ### 最近活动
97
- - 08:32 unknown
98
- - 08:32 unknown
99
- - 08:32 unknown
100
-
101
- ---
@@ -1,287 +0,0 @@
1
- # 思维链管理系统使用指南
2
-
3
- > 类似 GitLens,但用于对话和决策追踪
4
-
5
- ---
6
-
7
- ## 🎯 核心功能
8
-
9
- | 功能 | 说明 |
10
- |------|------|
11
- | 📝 完整对话记录 | 记录每轮对话(用户 + AI) |
12
- | 🔗 决策追踪 | 自动识别并记录重要决策 |
13
- | 🔍 代码关联 | 追踪代码变更与决策的关系 |
14
- | 🚫 隐私保护 | 自动过滤 API Key 等敏感信息 |
15
- | 📤 导出功能 | 支持 JSON/Markdown/PDF 导出 |
16
-
17
- ---
18
-
19
- ## 📂 数据结构
20
-
21
- ```
22
- .claude/
23
- ├── transcripts/ # 完整对话存档
24
- │ └── 2026/01/14.md # 按日期组织
25
- ├── decisions/ # 决策记录
26
- │ ├── DECISIONS.md # 决策索引
27
- │ └── by-topic/ # 按主题分类
28
- ├── code-trace/ # 代码变更追踪
29
- │ ├── files-map.json # 文件 → 决策
30
- │ └── decisions-map.json # 决策 → 文件
31
- └── export/ # 导出目录
32
- ```
33
-
34
- ---
35
-
36
- ## 🚀 快速开始
37
-
38
- ### 1. 查看今日对话
39
-
40
- ```bash
41
- # 方式 1: 直接查看
42
- cat .claude/transcripts/$(date +%Y/%m/%d).md
43
-
44
- # 方式 2: 使用脚本
45
- node .claude/hooks/conversation-recorder.cjs today
46
-
47
- # 添加别名后
48
- today
49
- ```
50
-
51
- ### 2. 查看所有决策
52
-
53
- ```bash
54
- # 方式 1: 直接查看
55
- cat .claude/decisions/DECISIONS.md
56
-
57
- # 方式 2: 使用脚本
58
- node .claude/hooks/decision-tracker.cjs list
59
-
60
- # 添加别名后
61
- decisions
62
- ```
63
-
64
- ### 3. 追踪代码来源
65
-
66
- ```bash
67
- # 查看某个文件的决策历史
68
- node .claude/hooks/code-tracer.cjs trace src/file.ts
69
-
70
- # 添加别名后
71
- trace src/file.ts
72
- ```
73
-
74
- ---
75
-
76
- ## 📝 命令参考
77
-
78
- ### 对话记录 (conversation-recorder.cjs)
79
-
80
- ```bash
81
- # 记录用户消息
82
- node .claude/hooks/conversation-recorder.cjs user "消息内容"
83
-
84
- # 记录 AI 回复
85
- node .claude/hooks/conversation-recorder.cjs assistant "回复内容"
86
-
87
- # 手动记录决策
88
- node .claude/hooks/conversation-recorder.cjs decision "标题" "理由" "内容"
89
-
90
- # 查看今日对话
91
- node .claude/hooks/conversation-recorder.cjs today
92
-
93
- # 列出所有 transcript
94
- node .claude/hooks/conversation-recorder.cjs list
95
- ```
96
-
97
- ### 决策追踪 (decision-tracker.cjs)
98
-
99
- ```bash
100
- # 手动添加决策
101
- node .claude/hooks/decision-tracker.cjs add "标题" "内容" "tag1,tag2"
102
-
103
- # 列出所有决策
104
- node .claude/hooks/decision-tracker.cjs list
105
-
106
- # 搜索决策
107
- node .claude/hooks/decision-tracker.cjs search "关键词"
108
-
109
- # 列出所有主题
110
- node .claude/hooks/decision-tracker.cjs topics
111
-
112
- # 从文本中提取决策
113
- node .claude/hooks/decision-tracker.cjs extract "文本内容"
114
- ```
115
-
116
- ### 代码追踪 (code-tracer.cjs)
117
-
118
- ```bash
119
- # 查看文件的决策历史
120
- node .claude/hooks/code-tracer.cjs trace <文件路径>
121
-
122
- # 查看决策关联的文件
123
- node .claude/hooks/code-tracer.cjs decision <决策ID>
124
-
125
- # 手动关联文件到决策
126
- node .claude/hooks/code-tracer.cjs link <文件> <决策ID>
127
-
128
- # 显示所有关联
129
- node .claude/hooks/code-tracer.cjs all
130
-
131
- # 同步决策描述
132
- node .claude/hooks/code-tracer.cjs sync
133
- ```
134
-
135
- ### 隐私过滤 (privacy-filter.js)
136
-
137
- ```bash
138
- # 检查文件是否包含敏感信息
139
- node .claude/hooks/privacy-filter.js --check <文件>
140
-
141
- # 过滤敏感信息
142
- node .claude/hooks/privacy-filter.js --filter <输入> [输出]
143
-
144
- # 列出所有过滤模式
145
- node .claude/hooks/privacy-filter.js --patterns
146
- ```
147
-
148
- ### 导出 (export.cjs)
149
-
150
- ```bash
151
- # 导出为 JSON
152
- node .claude/hooks/export.cjs json [文件名]
153
-
154
- # 导出为 Markdown
155
- node .claude/hooks/export.cjs md [文件名]
156
-
157
- # 导出为 PDF(需要 pandoc)
158
- node .claude/hooks/export.cjs pdf
159
-
160
- # 只导出决策
161
- node .claude/hooks/export.cjs decisions
162
-
163
- # 只导出对话
164
- node .claude/hooks/export.cjs transcripts
165
-
166
- # 列出导出文件
167
- node .claude/hooks/export.cjs list
168
-
169
- # 清理导出文件
170
- node .claude/hooks/export.cjs clean
171
- ```
172
-
173
- ---
174
-
175
- ## ⚡ 推荐别名
176
-
177
- 添加到 `~/.zshrc` 或 `~/.bashrc`:
178
-
179
- ```bash
180
- # 对话历史
181
- alias today='node .claude/hooks/conversation-recorder.cjs today'
182
- alias transcripts='node .claude/hooks/conversation-recorder.cjs list'
183
-
184
- # 决策
185
- alias decisions='node .claude/hooks/decision-tracker.cjs list'
186
- alias dadd='node .claude/hooks/decision-tracker.cjs add'
187
- alias dsearch='node .claude/hooks/decision-tracker.cjs search'
188
- alias dtopics='node .claude/hooks/decision-tracker.cjs topics'
189
-
190
- # 代码追踪
191
- alias trace='node .claude/hooks/code-tracer.cjs trace'
192
- alias dtrace='node .claude/hooks/code-tracer.cjs decision'
193
- alias codelink='node .claude/hooks/code-tracer.cjs link'
194
-
195
- # 导出
196
- alias export='node .claude/hooks/export.cjs'
197
- ```
198
-
199
- ---
200
-
201
- ## 🔒 隐私保护
202
-
203
- 系统会自动过滤以下敏感信息:
204
-
205
- | 类型 | 示例 |
206
- |------|------|
207
- | API Key | `sk-xxxxx` → `sk-[REDACTED]` |
208
- | Bearer Token | `Bearer xxxxx` → `Bearer [REDACTED]` |
209
- | AWS Key | `AKIAxxxxx` → `AKIA[REDACTED]` |
210
- | GitHub Token | `ghp_xxxxx` → `ghp_[REDACTED]` |
211
- | 配置中的密钥 | `key: "xxxxx"` → `key: [REDACTED]` |
212
-
213
- ---
214
-
215
- ## 📊 工作流示例
216
-
217
- ### 场景:实现一个新功能
218
-
219
- 1. **开始对话** → 系统自动记录到 `transcripts/`
220
- 2. **做出决策** → 系统自动识别并记录到 `decisions/`
221
- 3. **修改代码** → 手动关联代码到决策
222
- 4. **完成回顾** → 导出完整记录
223
-
224
- ```bash
225
- # 查看今天做了什么
226
- today
227
-
228
- # 查看所有相关决策
229
- decisions | grep "功能"
230
-
231
- # 追踪某个文件的来源
232
- trace src/feature.ts
233
-
234
- # 导出完整记录
235
- export json my-feature.json
236
- ```
237
-
238
- ---
239
-
240
- ## 📱 VSCode 集成
241
-
242
- 在 `.vscode/settings.json` 中添加:
243
-
244
- ```json
245
- {
246
- "files.exclude": {
247
- "**/.claude/transcripts": true,
248
- "**/.claude/code-trace": true
249
- },
250
- "search.exclude": {
251
- "**/.claude/export": true
252
- }
253
- }
254
- ```
255
-
256
- ---
257
-
258
- ## 🔄 数据持久化
259
-
260
- - 所有数据存储在本地项目 `.claude/` 目录
261
- - 已配置 `.gitignore`,不会提交到 git
262
- - 可随时使用 `export.cjs` 导出备份
263
-
264
- ---
265
-
266
- ## 🤝 AI 辅助
267
-
268
- 系统会自动:
269
-
270
- - **识别决策**:检测对话中的决策关键词
271
- - **分类主题**:自动为决策打标签
272
- - **过滤隐私**:自动替换敏感信息
273
- - **关联代码**:追踪文件变更
274
-
275
- 你也可以手动:
276
-
277
- - **添加决策**:使用 `dadd` 命令
278
- - **关联代码**:使用 `codelink` 命令
279
- - **修正分类**:编辑 `decisions/by-topic/` 文件
280
-
281
- ---
282
-
283
- ## 📚 更多
284
-
285
- - 查看决策按主题:`cat .claude/decisions/by-topic/*.md`
286
- - 搜索历史对话:`grep -r "关键词" .claude/transcripts/`
287
- - 查看完整思维链:`node .claude/hooks/export.cjs md && open .claude/export/`
package/.claude/USAGE.md DELETED
@@ -1,175 +0,0 @@
1
- # Skills 系统使用手册
2
-
3
- > 版本: 2.0.0 | 更新日期: 2026-01-22
4
-
5
- ---
6
-
7
- ## 核心 Skills
8
-
9
- | Skill | 命令 | 触发时机 | 作用 | 模型 |
10
- |-------|------|---------|------|------|
11
- | `quality-guard` | `/review` | 提交前、PR 审查 | 代码质量 + 安全检查 + 清理建议 | sonnet |
12
- | `test-master` | `/test` | 实现功能后 | TDD + E2E + 覆盖率分析 | sonnet |
13
- | `design-brain` | `/plan` | 开始新任务前 | 规划 + 架构设计 | opus |
14
- | `quick-fix` | `/fix` | 构建失败时 | 快速修复错误 | haiku |
15
-
16
- ---
17
-
18
- ## 命令速查表
19
-
20
- ### /review - 代码审查
21
-
22
- ```bash
23
- /review # 标准代码审查
24
- /review --security # 安全深度扫描 (OWASP Top 10)
25
- /review --clean # 死代码清理建议
26
- /review --all # 完整审查
27
- ```
28
-
29
- **触发时机**:
30
- - 准备提交代码前
31
- - PR 审查时
32
- - 怀疑有安全问题时
33
-
34
- ### /test - 测试
35
-
36
- ```bash
37
- /test # 运行单元测试
38
- /test --tdd # TDD 开发模式 (RED→GREEN→REFACTOR)
39
- /test --e2e # E2E 测试 (Playwright)
40
- /test --coverage # 覆盖率报告
41
- /test --all # 完整测试套件
42
- ```
43
-
44
- **触发时机**:
45
- - 完成功能实现后
46
- - 修复 bug 后
47
- - 提交前验证
48
-
49
- ### /plan - 规划
50
-
51
- ```bash
52
- /plan # 快速规划(默认)
53
- /plan --deep # 深度设计(架构决策)
54
- /plan --arch # 仅架构设计
55
- ```
56
-
57
- **触发时机**:
58
- - 开始新功能开发前
59
- - 重大重构前
60
- - 技术选型时
61
-
62
- ### /fix - 快速修复
63
-
64
- ```bash
65
- /fix # 自动检测并修复
66
- /fix --build # 修复构建错误
67
- /fix --lint # 修复 lint 错误
68
- /fix --type # 修复类型错误
69
- /fix --all # 修复所有错误
70
- ```
71
-
72
- **触发时机**:
73
- - `npm run build` 失败
74
- - `tsc` 报类型错误
75
- - ESLint 报错
76
-
77
- ### /refactor - 重构
78
-
79
- ```bash
80
- /refactor # 分析并建议清理
81
- /refactor --dead # 查找死代码
82
- /refactor --deps # 查找未使用依赖
83
- /refactor --duplicate # 查找重复代码
84
- /refactor --execute # 执行清理(需确认)
85
- ```
86
-
87
- **触发时机**:
88
- - 代码库变大需要清理
89
- - 发现重复代码
90
- - 依赖需要整理
91
-
92
- ---
93
-
94
- ## 模型成本策略
95
-
96
- | 模型 | 使用场景 | 相对成本 | 速度 |
97
- |------|---------|---------|------|
98
- | **haiku** | `/fix` 快速修复 | 1x (最低) | 最快 |
99
- | **sonnet** | `/review`, `/test` 标准任务 | 5x | 中等 |
100
- | **opus** | `/plan --deep` 复杂架构 | 15x | 较慢 |
101
-
102
- **自动选择规则**:
103
- - 简单修复 → haiku(节省成本)
104
- - 代码审查/测试 → sonnet(平衡性价比)
105
- - 架构设计 → opus(仅在需要深度分析时)
106
-
107
- ---
108
-
109
- ## 工作流示例
110
-
111
- ### 新功能开发
112
-
113
- ```
114
- 1. /plan # 规划实现步骤
115
- 2. 编写代码 # 实现功能
116
- 3. /fix # 修复编译错误
117
- 4. /test --tdd # 补充测试
118
- 5. /review # 代码审查
119
- 6. /commit # 提交代码
120
- ```
121
-
122
- ### Bug 修复
123
-
124
- ```
125
- 1. /test # 确认失败的测试
126
- 2. 修复代码 # 实现修复
127
- 3. /fix # 确保编译通过
128
- 4. /test # 验证测试通过
129
- 5. /review --security # 安全检查
130
- 6. /commit # 提交修复
131
- ```
132
-
133
- ### 代码清理
134
-
135
- ```
136
- 1. /refactor # 分析代码库
137
- 2. /refactor --dead # 找死代码
138
- 3. /refactor --deps # 找未用依赖
139
- 4. /refactor --execute # 执行清理
140
- 5. /test # 确保不破坏功能
141
- 6. /commit # 提交清理
142
- ```
143
-
144
- ---
145
-
146
- ## 自动加载
147
-
148
- Skills 会根据用户输入自动加载:
149
-
150
- ```json
151
- {
152
- "auto_load": {
153
- "enabled": true,
154
- "confidence_threshold": 0.7,
155
- "max_skills_per_task": 3
156
- }
157
- }
158
- ```
159
-
160
- **关键词触发示例**:
161
- - "review code" → `quality-guard`
162
- - "fix build error" → `quick-fix`
163
- - "plan architecture" → `design-brain`
164
- - "run tests" → `test-master`
165
-
166
- ---
167
-
168
- ## 配置文件
169
-
170
- | 文件 | 说明 |
171
- |------|------|
172
- | `.claude/rag/skill-index.json` | Skill 索引和模型策略 |
173
- | `.claude/skills/*/metadata.yaml` | 各 Skill 配置 |
174
- | `.claude/skills/*/SKILL.md` | Skill 详细指令 |
175
- | `.claude/commands/*.md` | 命令定义 |
@@ -1,167 +0,0 @@
1
- # Boris 优化指南
2
-
3
- 本指南基于 Claude Code 创造者 Boris Cherny 的最佳实践,为 oh-my-claude 项目提供优化建议。
4
-
5
- ## 已实现的优化
6
-
7
- ### 1. 验证反馈循环 🔍
8
-
9
- **文件**: `.claude/hooks/verify-work.cjs`
10
-
11
- **重要性**: ⭐⭐⭐⭐⭐ (最重要!质量提升 2-3 倍)
12
-
13
- **功能**:
14
- - 在关键操作后自动提醒验证
15
- - 记录待验证任务列表
16
- - 生成验证日志
17
-
18
- **使用方式**:
19
- ```bash
20
- # 手动触发验证流程
21
- /verify-work
22
- ```
23
-
24
- **验证时机**:
25
- - git commit 后 - 运行测试确保功能正常
26
- - git push 后 - 检查 CI/CD 状态
27
- - deploy 后 - 在预发布环境验证
28
- - build 后 - 检查构建产物
29
-
30
- ---
31
-
32
- ### 2. Slash Commands ⚡
33
-
34
- **目录**: `.claude/commands/`
35
-
36
- **可用命令**:
37
-
38
- | 命令 | 功能 |
39
- |------|------|
40
- | `/commit-push-pr` | 提交代码、推送、创建 PR |
41
- | `/commit` | 创建 git commit |
42
- | `/pr` | 创建或更新 PR |
43
- | `/test` | 运行测试套件 |
44
- | `/review` | 审查当前更改 |
45
- | `/verify-work` | 查看待验证任务 |
46
- | `/sessions` | 管理并行会话 |
47
-
48
- **使用方式**:
49
- ```bash
50
- # 快速提交并创建 PR
51
- /commit-push-pr
52
-
53
- # 审查更改后再提交
54
- /review
55
- /commit
56
-
57
- # 运行测试
58
- /test
59
- ```
60
-
61
- ---
62
-
63
- ### 3. 代码格式化 Hook 🎨
64
-
65
- **文件**: `.claude/hooks/code-formatter.cjs`
66
-
67
- **功能**:
68
- - 在代码编辑后自动格式化
69
- - 支持多种语言和格式化工具
70
- - 静默运行,不打扰工作流
71
-
72
- **支持的语言**:
73
- - JavaScript/TypeScript (Prettier)
74
- - Python (Black)
75
- - Rust (rustfmt)
76
- - Go (gofmt)
77
- - JSON/YAML/Markdown (Prettier)
78
-
79
- **调试模式**:
80
- ```bash
81
- export DEBUG_FORMATTER=1
82
- ```
83
-
84
- ---
85
-
86
- ### 4. 并行多会话支持 🔄
87
-
88
- **文件**: `.claude/hooks/multi-session.cjs`
89
-
90
- **功能**:
91
- - 跟踪活跃的并行会话
92
- - 为每个会话分配编号 (1-10)
93
- - 自动清理过期会话
94
-
95
- **Boris 的工作流**:
96
- ```
97
- 终端标签 1: Conductor (协调/规划)
98
- 终端标签 2: Architect (设计/架构)
99
- 终端标签 3: Builder (实现)
100
- 终端标签 4: Reviewer (审查)
101
- 终端标签 5: Explorer (研究)
102
-
103
- + 5-10 个 claude.ai/code Web 会话
104
- ```
105
-
106
- **使用方式**:
107
- ```bash
108
- # 查看所有活跃会话
109
- /sessions
110
-
111
- # 或直接运行
112
- node .claude/hooks/multi-session.cjs --status
113
- ```
114
-
115
- ---
116
-
117
- ## 配置更新
118
-
119
- 所有 hooks 已添加到 `.claude/settings.json`:
120
-
121
- ```json
122
- {
123
- "matcher": "UserPromptSubmit|PreToolUse|PostToolUse|AgentStop",
124
- "hooks": [
125
- { "command": "...project-kickoff.cjs", "timeout": 1 },
126
- { "command": "...thinking-silent.cjs", "timeout": 1 },
127
- { "command": "...rag-skill-loader.cjs", "timeout": 1 },
128
- { "command": "...code-formatter.cjs", "timeout": 5 },
129
- { "command": "...verify-work.cjs", "timeout": 1 },
130
- { "command": "...multi-session.cjs", "timeout": 1 }
131
- ]
132
- }
133
- ```
134
-
135
- ---
136
-
137
- ## 最佳实践总结
138
-
139
- ### 启动会话
140
- 1. **Plan 模式开始** (Shift+Tab 两次)
141
- 2. 批准计划后切换到 auto-accept 模式
142
- 3. 使用 `/commit-push-pr` 完成工作流
143
-
144
- ### 并行工作
145
- 1. 开启 5 个终端标签页
146
- 2. 每个标签运行不同的 agent/任务
147
- 3. 使用系统通知跟踪进度
148
- 4. 同时使用 claude.ai/code Web 会话
149
-
150
- ### 验证工作
151
- 1. 每次提交前 `/review`
152
- 2. 提交后 `/test` 验证
153
- 3. 定期 `/verify-work` 查看待验证项
154
- 4. 使用 background agent 验证长时间任务
155
-
156
- ### 团队协作
157
- 1. 共享 CLAUDE.md 到 git
158
- 2. PR 审查时使用 @.claude 添加规范
159
- 3. 定期更新团队知识库
160
-
161
- ---
162
-
163
- ## 额外资源
164
-
165
- - [Claude Code 文档](https://code.claude.com)
166
- - [Boris 的 Twitter Thread](https://twitter-thread.com/t/2007179832300581177)
167
- - [Claude Chrome Extension](https://code.claude.com/docs/en/chrome)