@kunlv/atdc 1.0.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 (222) hide show
  1. package/AGENTS.md +58 -0
  2. package/GO.md +245 -0
  3. package/bin/add-command.py +144 -0
  4. package/bin/atdc.js +460 -0
  5. package/bin/cls.js +98 -0
  6. package/central/link.sh +60 -0
  7. package/central/ticket_center_server/.handoffs/TASK-238389_QYinVipLimit.md +128 -0
  8. package/central/ticket_center_server/.test_plans/TASK-227254-SupportMembership-self-test-plan.md +566 -0
  9. package/central/ticket_center_server/.test_plans/task-238389-qyin-vip-limit-self-test-plan.md +210 -0
  10. package/commands/claude/atd.md +3 -0
  11. package/commands/claude/atdc/1-spec.md +5 -0
  12. package/commands/claude/atdc/1-update.md +5 -0
  13. package/commands/claude/atdc/2-qa.md +3 -0
  14. package/commands/claude/atdc/3-impl-skip-spec.md +5 -0
  15. package/commands/claude/atdc/3-impl.md +3 -0
  16. package/commands/claude/atdc/4-verify.md +3 -0
  17. package/commands/claude/atdc/5-done.md +3 -0
  18. package/commands/claude/atdc/add-command.md +4 -0
  19. package/commands/claude/atdc/add-to-hc.md +3 -0
  20. package/commands/claude/atdc/analysis-cls-log.md +4 -0
  21. package/commands/claude/atdc/article.md +6 -0
  22. package/commands/claude/atdc/bugfix.md +4 -0
  23. package/commands/claude/atdc/code-simplifier.md +8 -0
  24. package/commands/claude/atdc/commit.md +4 -0
  25. package/commands/claude/atdc/compound.md +5 -0
  26. package/commands/claude/atdc/context.md +3 -0
  27. package/commands/claude/atdc/diagnose.md +8 -0
  28. package/commands/claude/atdc/git-guardrails.md +18 -0
  29. package/commands/claude/atdc/grill-with-docs.md +8 -0
  30. package/commands/claude/atdc/handoff.md +8 -0
  31. package/commands/claude/atdc/health.md +3 -0
  32. package/commands/claude/atdc/learn.md +4 -0
  33. package/commands/claude/atdc/review.md +10 -0
  34. package/commands/claude/atdc/search.md +4 -0
  35. package/commands/claude/atdc/strategy.md +3 -0
  36. package/commands/claude/atdc/table2xlsx.md +4 -0
  37. package/commands/claude/atdc/test-plan.md +5 -0
  38. package/commands/claude/atdc/travel-planner.md +4 -0
  39. package/commands/claude/atdc/xlsx2sql-insert.md +4 -0
  40. package/commands/claude/atdc/xlsx2sql-update.md +4 -0
  41. package/commands/claude/atdc/zoom-out.md +8 -0
  42. package/commands/codex/atdc/SKILL.md +8 -0
  43. package/commands/codex/atdc-1-spec/SKILL.md +8 -0
  44. package/commands/codex/atdc-1-update/SKILL.md +8 -0
  45. package/commands/codex/atdc-2-qa/SKILL.md +8 -0
  46. package/commands/codex/atdc-3-impl/SKILL.md +8 -0
  47. package/commands/codex/atdc-3-impl-skip-spec/SKILL.md +8 -0
  48. package/commands/codex/atdc-4-verify/SKILL.md +8 -0
  49. package/commands/codex/atdc-5-done/SKILL.md +8 -0
  50. package/commands/codex/atdc-add-command/SKILL.md +7 -0
  51. package/commands/codex/atdc-add-to-hc/SKILL.md +8 -0
  52. package/commands/codex/atdc-analysis-cls-log/SKILL.md +5 -0
  53. package/commands/codex/atdc-article/SKILL.md +8 -0
  54. package/commands/codex/atdc-bugfix/SKILL.md +5 -0
  55. package/commands/codex/atdc-code-simplifier/SKILL.md +7 -0
  56. package/commands/codex/atdc-commit/SKILL.md +7 -0
  57. package/commands/codex/atdc-compound/SKILL.md +8 -0
  58. package/commands/codex/atdc-context/SKILL.md +8 -0
  59. package/commands/codex/atdc-diagnose/SKILL.md +9 -0
  60. package/commands/codex/atdc-git-guardrails/SKILL.md +19 -0
  61. package/commands/codex/atdc-grill-with-docs/SKILL.md +9 -0
  62. package/commands/codex/atdc-handoff/SKILL.md +9 -0
  63. package/commands/codex/atdc-health/SKILL.md +8 -0
  64. package/commands/codex/atdc-learn/SKILL.md +7 -0
  65. package/commands/codex/atdc-review/SKILL.md +49 -0
  66. package/commands/codex/atdc-search/SKILL.md +5 -0
  67. package/commands/codex/atdc-strategy/SKILL.md +8 -0
  68. package/commands/codex/atdc-table2xlsx/SKILL.md +8 -0
  69. package/commands/codex/atdc-test-plan/SKILL.md +13 -0
  70. package/commands/codex/atdc-travel-planner/SKILL.md +7 -0
  71. package/commands/codex/atdc-xlsx2sql-insert/SKILL.md +8 -0
  72. package/commands/codex/atdc-xlsx2sql-update/SKILL.md +8 -0
  73. package/commands/codex/atdc-zoom-out/SKILL.md +9 -0
  74. package/commands/cursor/atdc/SKILL.md +8 -0
  75. package/commands/cursor/atdc-1-spec/SKILL.md +8 -0
  76. package/commands/cursor/atdc-1-update/SKILL.md +8 -0
  77. package/commands/cursor/atdc-2-qa/SKILL.md +8 -0
  78. package/commands/cursor/atdc-3-impl/SKILL.md +8 -0
  79. package/commands/cursor/atdc-3-impl-skip-spec/SKILL.md +8 -0
  80. package/commands/cursor/atdc-4-verify/SKILL.md +8 -0
  81. package/commands/cursor/atdc-5-done/SKILL.md +8 -0
  82. package/commands/cursor/atdc-add-command/SKILL.md +7 -0
  83. package/commands/cursor/atdc-add-to-hc/SKILL.md +8 -0
  84. package/commands/cursor/atdc-analysis-cls-log/SKILL.md +5 -0
  85. package/commands/cursor/atdc-article/SKILL.md +8 -0
  86. package/commands/cursor/atdc-bugfix/SKILL.md +5 -0
  87. package/commands/cursor/atdc-code-simplifier/SKILL.md +7 -0
  88. package/commands/cursor/atdc-commit/SKILL.md +7 -0
  89. package/commands/cursor/atdc-compound/SKILL.md +8 -0
  90. package/commands/cursor/atdc-context/SKILL.md +8 -0
  91. package/commands/cursor/atdc-diagnose/SKILL.md +8 -0
  92. package/commands/cursor/atdc-git-guardrails/SKILL.md +18 -0
  93. package/commands/cursor/atdc-grill-with-docs/SKILL.md +8 -0
  94. package/commands/cursor/atdc-handoff/SKILL.md +8 -0
  95. package/commands/cursor/atdc-health/SKILL.md +8 -0
  96. package/commands/cursor/atdc-learn/SKILL.md +7 -0
  97. package/commands/cursor/atdc-review/SKILL.md +49 -0
  98. package/commands/cursor/atdc-search/SKILL.md +5 -0
  99. package/commands/cursor/atdc-strategy/SKILL.md +8 -0
  100. package/commands/cursor/atdc-table2xlsx/SKILL.md +8 -0
  101. package/commands/cursor/atdc-test-plan/SKILL.md +7 -0
  102. package/commands/cursor/atdc-travel-planner/SKILL.md +7 -0
  103. package/commands/cursor/atdc-xlsx2sql-insert/SKILL.md +8 -0
  104. package/commands/cursor/atdc-xlsx2sql-update/SKILL.md +8 -0
  105. package/commands/cursor/atdc-zoom-out/SKILL.md +8 -0
  106. package/commands/opencode/atd.md +6 -0
  107. package/commands/opencode/atdc/1-spec.md +8 -0
  108. package/commands/opencode/atdc/1-update.md +8 -0
  109. package/commands/opencode/atdc/2-qa.md +6 -0
  110. package/commands/opencode/atdc/3-impl-skip-spec.md +8 -0
  111. package/commands/opencode/atdc/3-impl.md +6 -0
  112. package/commands/opencode/atdc/4-verify.md +6 -0
  113. package/commands/opencode/atdc/5-done.md +6 -0
  114. package/commands/opencode/atdc/add-command.md +6 -0
  115. package/commands/opencode/atdc/add-to-hc.md +6 -0
  116. package/commands/opencode/atdc/analysis-cls-log.md +6 -0
  117. package/commands/opencode/atdc/article.md +6 -0
  118. package/commands/opencode/atdc/bugfix.md +6 -0
  119. package/commands/opencode/atdc/code-simplifier.md +8 -0
  120. package/commands/opencode/atdc/commit.md +6 -0
  121. package/commands/opencode/atdc/compound.md +8 -0
  122. package/commands/opencode/atdc/context.md +6 -0
  123. package/commands/opencode/atdc/diagnose.md +8 -0
  124. package/commands/opencode/atdc/git-guardrails.md +18 -0
  125. package/commands/opencode/atdc/grill-with-docs.md +8 -0
  126. package/commands/opencode/atdc/handoff.md +8 -0
  127. package/commands/opencode/atdc/health.md +6 -0
  128. package/commands/opencode/atdc/learn.md +6 -0
  129. package/commands/opencode/atdc/review.md +7 -0
  130. package/commands/opencode/atdc/search.md +6 -0
  131. package/commands/opencode/atdc/strategy.md +6 -0
  132. package/commands/opencode/atdc/table2xlsx.md +6 -0
  133. package/commands/opencode/atdc/test-plan.md +6 -0
  134. package/commands/opencode/atdc/travel-planner.md +6 -0
  135. package/commands/opencode/atdc/xlsx2sql-insert.md +6 -0
  136. package/commands/opencode/atdc/xlsx2sql-update.md +6 -0
  137. package/commands/opencode/atdc/zoom-out.md +8 -0
  138. package/config/cls-defaults.json +19 -0
  139. package/hooks/atd-archive.sh +86 -0
  140. package/hooks/atd-state.sh +165 -0
  141. package/hooks/evidence-hook.sh +88 -0
  142. package/hooks/evidence-log.sh +54 -0
  143. package/hooks/guardrails.sh +65 -0
  144. package/hooks/handoff-compress.sh +104 -0
  145. package/hooks/phase-guard.sh +134 -0
  146. package/hooks/phase-write-guard.sh +96 -0
  147. package/hooks/ponytail-fix.sh +179 -0
  148. package/hooks/ponytail-guard.sh +66 -0
  149. package/hooks/ponytail-scan.sh +62 -0
  150. package/install.sh +276 -0
  151. package/package.json +20 -0
  152. package/packages/cls/bin/cls.js +146 -0
  153. package/packages/cls/config/defaults.json +17 -0
  154. package/packages/cls/mcp/server.js +142 -0
  155. package/packages/cls/package.json +29 -0
  156. package/packages/cls/scripts/postinstall.js +19 -0
  157. package/packages/cls/src/client.js +262 -0
  158. package/prompts/1-spec.md +271 -0
  159. package/prompts/1-update.md +198 -0
  160. package/prompts/2-qa.md +164 -0
  161. package/prompts/3-impl-bugfix.md +271 -0
  162. package/prompts/3-impl.md +419 -0
  163. package/prompts/4-verify.md +160 -0
  164. package/prompts/5-done.md +227 -0
  165. package/prompts/6-article.md +571 -0
  166. package/prompts/X-add-command.md +60 -0
  167. package/prompts/X-add-to-hc.md +178 -0
  168. package/prompts/X-analysis-cls-log.md +68 -0
  169. package/prompts/X-bugfix.md +10 -0
  170. package/prompts/X-code-simplifier.md +38 -0
  171. package/prompts/X-commit.md +116 -0
  172. package/prompts/X-compound.md +188 -0
  173. package/prompts/X-context-scan.md +101 -0
  174. package/prompts/X-diagnose.md +116 -0
  175. package/prompts/X-grill-with-docs.md +120 -0
  176. package/prompts/X-handoff.md +80 -0
  177. package/prompts/X-health.md +78 -0
  178. package/prompts/X-learn.md +151 -0
  179. package/prompts/X-review.md +417 -0
  180. package/prompts/X-search.md +74 -0
  181. package/prompts/X-strategy.md +95 -0
  182. package/prompts/X-table2xlsx.md +46 -0
  183. package/prompts/X-test-plan.md +436 -0
  184. package/prompts/X-travel-planner.md +22 -0
  185. package/prompts/X-xlsx2sql-insert.md +34 -0
  186. package/prompts/X-xlsx2sql-update.md +40 -0
  187. package/prompts/X-zoom-out.md +119 -0
  188. package/reference/diagnose-loop.md +66 -0
  189. package/reference/gates.md +90 -0
  190. package/reference/git-guardrails.md +71 -0
  191. package/reference/guards.md +275 -0
  192. package/reference/learn.md +100 -0
  193. package/reference/memory.md +190 -0
  194. package/reference/risk.md +74 -0
  195. package/reference/tdd.md +40 -0
  196. package/scripts/svg2png.js +46 -0
  197. package/src/cls/client.js +244 -0
  198. package/src/constants.js +49 -0
  199. package/src/evidence/ai-draft-metrics.js +157 -0
  200. package/src/evidence/canvas.js +184 -0
  201. package/src/evidence/index.js +98 -0
  202. package/src/evidence/sink-events.js +165 -0
  203. package/src/evidence/stage-timing.js +112 -0
  204. package/src/installers/claude.js +79 -0
  205. package/src/installers/codex.js +62 -0
  206. package/src/installers/opencode.js +72 -0
  207. package/src/manifest/ponytail-patterns.json +185 -0
  208. package/src/mcp/cls-mcp-server.js +142 -0
  209. package/src/utils.js +79 -0
  210. package/src/validators/state-validate.js +123 -0
  211. package/templates/.phase-state.json +13 -0
  212. package/templates/adr.md +62 -0
  213. package/templates/changelog.md +21 -0
  214. package/templates/concepts.md +35 -0
  215. package/templates/design.md +47 -0
  216. package/templates/handoff.md +64 -0
  217. package/templates/learn-skill.md +43 -0
  218. package/templates/progress.json +17 -0
  219. package/templates/proposal.md +29 -0
  220. package/templates/solution.md +36 -0
  221. package/templates/strategy.md +39 -0
  222. package/templates/tasks.md +41 -0
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: atd:handoff
3
+ description: 压缩当前会话为交接文档。触发词:handoff、交接、生成交接。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-handoff.md`,然后根据以下参数开始执行:
6
+
7
+ $ARGUMENTS
8
+
9
+ 跳过 GO.md 路由,直接生成交接文档。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:health
3
+ description: 项目健康巡检(change/记忆/spec覆盖率/图引擎)。触发词:health、健康巡检。
4
+ ---
5
+
6
+ 执行前先运行 `~/.claude/scripts/link-crg.sh` 确保 CRG 图数据就绪,然后用 Read 工具读取 `${ATDC_DIR}/prompts/X-health.md` 开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行项目健康巡检。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:learn
3
+ description: self-learning桥接:session→golden path→atd skill。触发词:learn、记住这个、沉淀为技能。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-learn.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行 self-learning 桥接:从 session 中检测。
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: atd:review
3
+ description: 代码review(CRG+CodeGraph:blast radius+风险+测试缺口)。触发词:review、代码审查。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-review.md`,然后根据参数开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行代码级 review。无参数时执行全量 review。
9
+
10
+ ## 子模式
11
+
12
+ | 参数 | 说明 |
13
+ |------|------|
14
+ | 无参数 | 全量 review(CRG + CodeGraph) |
15
+ | `delta` | 仅变更文件 review |
16
+ | `pr` | PR/分支 review |
17
+ | `gaps` | 仅测试缺口检测 |
18
+ | `flows` | 仅受影响流程追踪 |
19
+ | `arch` | 架构健康检查(耦合/桥接/枢纽) |
20
+ | `crg` | CRG 深度分析(token 高效模式) |
21
+
22
+ ## 强制规则
23
+
24
+ ### 规则 1:pr 模式必须先合并 origin/master
25
+
26
+ 对于 `pr` 模式,执行 Phase 1 前**必须**先将 `origin/master` 最新代码合并到当前分支,避免 diff 包含已合入 master 的内容:
27
+
28
+ ```bash
29
+ git fetch origin master && git merge origin/master --no-edit
30
+ ```
31
+
32
+ ### 规则 2:报告输出路径固定
33
+
34
+ Review 报告**必须**输出到项目根目录的 `docs/report/`,命名格式:
35
+
36
+ ```
37
+ docs/report/code-review-<分支名或change号>-<YYYY-MM-DD>.md
38
+ ```
39
+
40
+ 前缀固定为 `code-review-`,日期为当天日期。不再保存到 `openspec/changes/`。
41
+
42
+ ### 规则 3:检测到 DB 操作时必须做慢查校验
43
+
44
+ Review 过程中检测到变更代码包含 SQL 查询(Raw SQL / GORM / DB 连接)时:
45
+ 1. **暂停** review,向用户列出涉及的 SQL 和表名
46
+ 2. 要求用户提供对应表的 `CREATE TABLE` 语句(DDL)
47
+ 3. 用户提供 DDL 后,逐条分析每条 SQL 的索引命中情况(命中/部分覆盖/filesort/temp table)
48
+ 4. 给出 EXPLAIN 预估和慢查风险等级(🟢低/🟡中/🔴高)
49
+ 5. 汇总到 review 报告的 "DB 慢查分析" 章节
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: atd:search
3
+ description: Semble代码搜索(语义+词法双路检索)。触发词:search、搜代码、找代码、/atdc:search。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-search.md`,然后直接开始执行。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:strategy
3
+ description: 产品策略锚点(STRATEGY.md创建/更新)。触发词:strategy、看看策略。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-strategy.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接创建或更新 STRATEGY.md。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:table2xlsx
3
+ description: DDL→Excel模板生成。触发词:table2xlsx、DDL转Excel、生成模板。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-table2xlsx.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行 DDL → Excel 模板生成。
@@ -0,0 +1,13 @@
1
+ ---
2
+ name: atd:test-plan
3
+ description: 生成自测计划+集成测试代码。触发词:test-plan、自测计划、生成自测。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-test-plan.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进入自测计划阶段:基于当前活跃 change 的 tasks.md,生成自测计划文档和集成测试 Go 文件。
8
+
9
+ **签名铁律(生成集成测试时必须遵守,禁止省略):**
10
+ - 外部接口走 `CheckClientSignature`(kugo v0.1):**POST 必须把原始 JSON body 纳入签名**;GET body 为空串。
11
+ - 公式:`MD5(appkey + sorted(key=value...) + body + appkey)` → lowercase hex;参数名是 `signature`(不是 `sign`)。
12
+ - `doPost` / `doPostSigned` 必须:`b, _ := json.Marshal(payload)` → `signQueryWithBody(params, string(b))` → 同一 `b` 作为请求体。
13
+ - 生成后必须包含 `TestKugoBuildSignature_PostIncludesBody` 单测并通过。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:travel-planner
3
+ description: 全栈旅行规划(推荐→研究→规划→攻略)。触发词:travel-planner、旅行攻略。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-travel-planner.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行 旅行规划。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:xlsx2sql-insert
3
+ description: Excel→INSERT SQL。触发词:xlsx2sql-insert、Excel转SQL。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-xlsx2sql-insert.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行 Excel → INSERT SQL 转换。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:xlsx2sql-update
3
+ description: Excel→UPDATE SQL。触发词:xlsx2sql-update、Excel转UPDATE。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-xlsx2sql-update.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行 Excel → UPDATE SQL 转换。
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: atd:zoom-out
3
+ description: 代码全景分析(定位/数据流/影响面/架构)。触发词:zoom-out、全景分析、看全局。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-zoom-out.md`,然后根据以下参数开始执行:
6
+
7
+ $ARGUMENTS
8
+
9
+ 跳过 GO.md 路由,直接进行代码全景分析。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd
3
+ description: 触发atdc工作流(propose/execute/health/scan)。Read GO.md路由。触发词:/flow、atdc、走流程。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/GO.md`,然后根据用户输入的需求开始执行。
7
+
8
+ 无额外参数时,GO.md 的 Step 1 会自动检测当前项目有无活跃 change,路由到对应阶段(propose / execute / verify / archive / health)。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:1-spec
3
+ description: 阶段1:需求→规格文档(proposal+tasks+specs)。触发词:1-spec、生成规格、propose。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/1-spec.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 1-spec 阶段:需求澄清 + 规格生成。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:1-update
3
+ description: 阶段1-Update:变更已有change需求文档。触发词:1-update、变更需求、update。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/1-update.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 1-update 阶段:对当前活跃 change 的需求文档进行变更。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:2-qa
3
+ description: 阶段2:质疑规格(隐性假设/边界/依赖/ADR)。触发词:2-qa、质疑一下、grill。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/2-qa.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 2-qa 阶段:对当前活跃 change 规格进行逐维度质疑检验。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:3-impl
3
+ description: 阶段3:按规格实现(缺文档则拦截,支持断点恢复)。触发词:3-impl、执行、execute。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/3-impl.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 3-impl 阶段:按规格文档实现(缺文件则拦截)。从 .progress.json 恢复断点或从头开始。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:3-impl-skip-spec
3
+ description: 阶段3-skip-spec:跳过规格直接实现。触发词:skip-spec、跳过规格、plan-dev。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/3-impl.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由和 propose 阶段,直接进入 3-impl 阶段(--skip-spec 模式):需求已清楚,跳过规格文档直接实现。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:4-verify
3
+ description: 阶段4:C3验收(逐条核查SHALL/MUST)。触发词:4-verify、验收、verify。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/4-verify.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 4-verify 阶段:C3 验收,逐条核查 SHALL/MUST。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:5-done
3
+ description: 阶段5:归档change+写记忆条目。触发词:5-done、归档、archive。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/5-done.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 5-done 阶段:归档 change + 写 caveman 记忆条目。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:add-command
3
+ description: 新增atdc命令(一键4端同步)。触发词:add-command、新增命令。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-add-command.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行 新增 atdc 命令。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:add-to-hc
3
+ description: 添加API接口到.hc HTTP Client测试文件。触发词:add-to-hc、加接口。
4
+ ---
5
+
6
+ 用 Read 工具读取 ${ATDC_DIR}/prompts/X-add-to-hc.md,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 add-to-hc 阶段:按模板生成 HTTP Client 条目并插入 external_routes.http。
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: atd:analysis-cls-log
3
+ description: CLS日志分析。触发词:analysis-cls-log、分析CLS日志、/atdc:analysis-cls-log。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-analysis-cls-log.md`,然后直接开始执行。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:article
3
+ description: 生成图文技术文章(3 skill+配图+润色)。触发词:article、生成文章、写文章。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/6-article.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 6-article 阶段:强制加载三个 skill,生成配图并输出图文结合的技术分享文章到 Obsidian 知识库。
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: atd:bugfix
3
+ description: Bugfix 5-Phase 流程。触发词:bugfix、修Bug、/atdc:bugfix。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/3-impl-bugfix.md`,然后直接开始执行。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:code-simplifier
3
+ description: Simplify/clean up code after coding sessions. 触发词:code-simplifier、simplify、简化代码。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-code-simplifier.md`,然后根据参数开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行代码简化。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:commit
3
+ description: Git Commit Message规范化生成。触发词:commit、提交信息、写commit。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-commit.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行 Git Commit Message 规范化生成。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:compound
3
+ description: 知识沉淀(docs/solutions/+CONCEPTS.md)。触发词:compound、沉淀知识。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-compound.md`,然后根据参数开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行知识沉淀。无参数时进入交互模式。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:context
3
+ description: 首次入场扫描→生成CONTEXT.md全景文档。触发词:context、扫描项目、scan。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-context-scan.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进入 context 阶段:首次入场扫描,生成项目全景文档 CONTEXT.md。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:diagnose
3
+ description: 结构化调试(复现→最小化→假设→插桩→修复→回归)。触发词:diagnose、诊断、debug。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-diagnose.md`,然后根据以下参数开始执行:
6
+
7
+
8
+ 跳过 GO.md 路由,直接进入结构化调试循环。
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: atd:git-guardrails
3
+ description: Git安全防护(拦截push main/force push/WIP)。触发词:git-guardrails、git防护。
4
+ ---
5
+ 执行以下步骤:
6
+
7
+ 1. 检查 hook 是否已安装:
8
+ ```bash
9
+ ls -la .git/hooks/pre-push 2>/dev/null && echo "✅ 已安装" || echo "❌ 未安装"
10
+ ```
11
+
12
+ 2. 如果用户说 `install` 或未安装:
13
+ ```bash
14
+ ln -sf ~/atdc/hooks/guardrails.sh .git/hooks/pre-push && echo "✅ git-guardrails 已安装"
15
+ ```
16
+
17
+ 3. 输出当前防护状态(参考 reference/git-guardrails.md 说明规则)
18
+
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:grill-with-docs
3
+ description: 深度拷问plan+更新CONTEXT+生成ADR。触发词:grill-with-docs、深度拷问。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-grill-with-docs.md`,然后根据以下参数开始执行:
6
+
7
+
8
+ 跳过 GO.md 路由,直接进入深度拷问 + 文档沉淀。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:handoff
3
+ description: 压缩当前会话为交接文档。触发词:handoff、交接、生成交接。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-handoff.md`,然后根据以下参数开始执行:
6
+
7
+
8
+ 跳过 GO.md 路由,直接生成交接文档。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:health
3
+ description: 项目健康巡检(change/记忆/spec覆盖率/图引擎)。触发词:health、健康巡检。
4
+ ---
5
+
6
+ 执行前先运行 `~/.claude/scripts/link-crg.sh` 确保 CRG 图数据就绪,然后用 Read 工具读取 `${ATDC_DIR}/prompts/X-health.md` 开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行项目健康巡检。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:learn
3
+ description: self-learning桥接:session→golden path→atd skill。触发词:learn、记住这个、沉淀为技能。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-learn.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行 self-learning 桥接:从 session 中检测。
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: atd:review
3
+ description: 代码review(CRG+CodeGraph:blast radius+风险+测试缺口)。触发词:review、代码审查。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-review.md`,然后根据参数开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行代码级 review。无参数时执行全量 review。
9
+
10
+ ## 子模式
11
+
12
+ | 参数 | 说明 |
13
+ |------|------|
14
+ | 无参数 | 全量 review(CRG + CodeGraph) |
15
+ | `delta` | 仅变更文件 review |
16
+ | `pr` | PR/分支 review |
17
+ | `gaps` | 仅测试缺口检测 |
18
+ | `flows` | 仅受影响流程追踪 |
19
+ | `arch` | 架构健康检查(耦合/桥接/枢纽) |
20
+ | `crg` | CRG 深度分析(token 高效模式) |
21
+
22
+ ## 强制规则
23
+
24
+ ### 规则 1:pr 模式必须先合并 origin/master
25
+
26
+ 对于 `pr` 模式,执行 Phase 1 前**必须**先将 `origin/master` 最新代码合并到当前分支,避免 diff 包含已合入 master 的内容:
27
+
28
+ ```bash
29
+ git fetch origin master && git merge origin/master --no-edit
30
+ ```
31
+
32
+ ### 规则 2:报告输出路径固定
33
+
34
+ Review 报告**必须**输出到项目根目录的 `docs/report/`,命名格式:
35
+
36
+ ```
37
+ docs/report/code-review-<分支名或change号>-<YYYY-MM-DD>.md
38
+ ```
39
+
40
+ 前缀固定为 `code-review-`,日期为当天日期。不再保存到 `openspec/changes/`。
41
+
42
+ ### 规则 3:检测到 DB 操作时必须做慢查校验
43
+
44
+ Review 过程中检测到变更代码包含 SQL 查询(Raw SQL / GORM / DB 连接)时:
45
+ 1. **暂停** review,向用户列出涉及的 SQL 和表名
46
+ 2. 要求用户提供对应表的 `CREATE TABLE` 语句(DDL)
47
+ 3. 用户提供 DDL 后,逐条分析每条 SQL 的索引命中情况(命中/部分覆盖/filesort/temp table)
48
+ 4. 给出 EXPLAIN 预估和慢查风险等级(🟢低/🟡中/🔴高)
49
+ 5. 汇总到 review 报告的 "DB 慢查分析" 章节
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: atd:search
3
+ description: Semble代码搜索(语义+词法双路检索)。触发词:search、搜代码、找代码、/atdc:search。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-search.md`,然后直接开始执行。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:strategy
3
+ description: 产品策略锚点(STRATEGY.md创建/更新)。触发词:strategy、看看策略。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-strategy.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接创建或更新 STRATEGY.md。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:table2xlsx
3
+ description: DDL→Excel模板生成。触发词:table2xlsx、DDL转Excel、生成模板。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-table2xlsx.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行 DDL → Excel 模板生成。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:test-plan
3
+ description: 生成自测计划+集成测试代码。触发词:test-plan、自测计划、生成自测。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-test-plan.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进入自测计划阶段:基于当前活跃 change 的 tasks.md,生成自测计划文档和集成测试 Go 文件。
@@ -0,0 +1,7 @@
1
+ ---
2
+ name: atd:travel-planner
3
+ description: 全栈旅行规划(推荐→研究→规划→攻略)。触发词:travel-planner、旅行攻略。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-travel-planner.md`,然后直接开始执行。
6
+
7
+ 跳过 GO.md 路由,直接进行 旅行规划。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:xlsx2sql-insert
3
+ description: Excel→INSERT SQL。触发词:xlsx2sql-insert、Excel转SQL。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-xlsx2sql-insert.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行 Excel → INSERT SQL 转换。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:xlsx2sql-update
3
+ description: Excel→UPDATE SQL。触发词:xlsx2sql-update、Excel转UPDATE。
4
+ ---
5
+
6
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-xlsx2sql-update.md`,然后直接开始执行。
7
+
8
+ 跳过 GO.md 路由,直接进行 Excel → UPDATE SQL 转换。
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: atd:zoom-out
3
+ description: 代码全景分析(定位/数据流/影响面/架构)。触发词:zoom-out、全景分析、看全局。
4
+ ---
5
+ 用 Read 工具读取 `${ATDC_DIR}/prompts/X-zoom-out.md`,然后根据以下参数开始执行:
6
+
7
+
8
+ 跳过 GO.md 路由,直接进行代码全景分析。
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 触发 atdc 工作流(propose/execute/health/scan)
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/GO.md,然后根据以下输入开始执行:
5
+
6
+ $ARGUMENTS
@@ -0,0 +1,8 @@
1
+ ---
2
+ description: 阶段1:输入需求,生成规格文档(proposal + tasks + specs),跳过自动路由
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/1-spec.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 1-spec 阶段:需求澄清 + 规格生成。
7
+
8
+ 用户需求:$ARGUMENTS
@@ -0,0 +1,8 @@
1
+ ---
2
+ description: 阶段1-Update:变更已有 change 的需求文档(proposal/design/specs/tasks),跳过自动路由
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/1-update.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 1-update 阶段:对当前活跃 change 的需求文档进行变更。
7
+
8
+ 用户变更说明:$ARGUMENTS
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 阶段2:质疑当前规格,逐维度检验漏洞(隐性假设、边界、依赖风险),跳过自动路由
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/2-qa.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 2-qa 阶段:对当前活跃 change 规格进行逐维度质疑检验。
@@ -0,0 +1,8 @@
1
+ ---
2
+ description: 阶段3(--skip-spec):需求已清楚,跳过规格文档直接实现
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/3-impl.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由和 propose 阶段,直接进入 3-impl 阶段(--skip-spec 模式):需求已清楚,跳过规格文档直接实现。
7
+
8
+ 用户需求:$ARGUMENTS
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 阶段3:按规格文档实现(缺 proposal/tasks/specs 则拦截),从断点恢复或从头开始
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/3-impl.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 3-impl 阶段:按规格文档实现(缺 proposal/tasks/specs 则拦截)。从 .progress.json 恢复断点或从头开始。
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 阶段4:C3 验收,逐条核查 SHALL/MUST,跳过自动路由
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/4-verify.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 4-verify 阶段:C3 验收,逐条核查 SHALL/MUST。
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 阶段5:归档 change,写 caveman 记忆条目,跳过自动路由
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/5-done.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 5-done 阶段:归档 change + 写 caveman 记忆条目。
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 新增 atd-code 命令(一键4端同步),跳过自动路由
3
+ ---
4
+ 用 Read 工具读取 ${ATDC_DIR}/prompts/X-add-command.md,然后直接开始执行。
5
+
6
+ $ARGUMENTS
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 添加新 API 接口到 .hc HTTP Client(模板快填),跳过自动路由
3
+ ---
4
+ 用 Read 工具读取 ${ATDC_DIR}/prompts/X-add-to-hc.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 add-to-hc 阶段:按模板生成 HTTP Client 条目并插入 external_routes.http。
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: CLS日志分析,跳过自动路由
3
+ ---
4
+ 用 Read 工具读取 ${ATDC_DIR}/prompts/X-analysis-cls-log.md,然后直接开始执行。
5
+
6
+ $ARGUMENTS
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: 阶段6:生成图文技术文章(3 skill 强制 + 配图生成 + 规范润色),跳过自动路由
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/6-article.md,然后直接开始执行。
5
+
6
+ 跳过 GO.md 路由,直接进入 6-article 阶段:强制加载 article-writing / chinese-content-writing-guideline / humanizer-zh 三个 skill,生成配图并输出图文结合的技术分享文章。
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: Bugfix 5-Phase 流程,跳过自动路由
3
+ ---
4
+ 用 Read 工具读取 ${ATDC_DIR}/prompts/3-impl-bugfix.md,然后直接开始执行。
5
+
6
+ $ARGUMENTS
@@ -0,0 +1,8 @@
1
+ ---
2
+ description: 代码简化(基于 code-simplifier skill)。用法 /atdc:code-simplifier [文件路径|PR|diff]
3
+ ---
4
+ 请用 Read 工具读取 ${ATDC_DIR}/prompts/X-code-simplifier.md,然后根据以下输入开始执行:
5
+
6
+ $ARGUMENTS
7
+
8
+ 跳过 GO.md 路由,直接进行代码简化。