@namewta/speculo 0.1.21 → 0.2.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 (288) hide show
  1. package/README.md +68 -78
  2. package/dist/src/cli.js +57 -34
  3. package/dist/src/cli.js.map +1 -1
  4. package/dist/src/index.d.ts +1 -3
  5. package/dist/src/index.js +128 -168
  6. package/dist/src/index.js.map +1 -1
  7. package/dist/src/migrate.d.ts +38 -0
  8. package/dist/src/migrate.js +646 -0
  9. package/dist/src/migrate.js.map +1 -0
  10. package/dist/src/workflows.d.ts +7 -37
  11. package/dist/src/workflows.js +49 -123
  12. package/dist/src/workflows.js.map +1 -1
  13. package/package.json +6 -4
  14. package/template/.speculo/README.md +20 -0
  15. package/template/.speculo/workspace.json +12 -0
  16. package/template/commands/docs-sync.md +28 -0
  17. package/template/commands/finalize.md +37 -0
  18. package/template/commands/knowledge-prune.md +20 -0
  19. package/template/commands/retro.md +15 -8
  20. package/template/commands/status.md +8 -51
  21. package/template/skills/agents-md-builder/SKILL.md +14 -101
  22. package/template/skills/change-lifecycle/SKILL.md +25 -0
  23. package/template/{workflows/dev/_templates → skills/change-lifecycle/assets}/completion-summary-template.md +2 -2
  24. package/template/{workflows/dev/_templates → skills/change-lifecycle/assets}/completion-verification-template.md +1 -1
  25. package/template/skills/change-lifecycle/references/completion-gate.md +19 -0
  26. package/template/skills/change-lifecycle/references/finalize-archive.md +32 -0
  27. package/template/skills/docs-sync/SKILL.md +22 -0
  28. package/template/skills/docs-sync/assets/report-template.md +45 -0
  29. package/template/skills/docs-sync/assets/state-template.json +20 -0
  30. package/template/skills/docs-sync/assets/workflow-scope-template.json +9 -0
  31. package/template/skills/docs-sync/references/agents-contract.md +43 -0
  32. package/template/skills/docs-sync/references/changelog-contract.md +39 -0
  33. package/template/skills/docs-sync/references/document-lifecycle-contract.md +38 -0
  34. package/template/skills/docs-sync/references/git-state-contract.md +67 -0
  35. package/template/skills/docs-sync/references/readme-contract.md +44 -0
  36. package/template/skills/docs-sync/references/workflow-scope-contract.md +50 -0
  37. package/template/skills/github-npm-ops/SKILL.md +14 -39
  38. package/template/skills/github-npm-ops/references/failure-recovery.md +1 -1
  39. package/template/skills/github-npm-ops/references/preflight-checklist.md +1 -1
  40. package/template/skills/github-npm-ops/references/release-notes-injection.md +1 -1
  41. package/template/skills/github-npm-ops/references/release-pipeline.md +13 -13
  42. package/template/skills/github-npm-ops/references/version-bump-flow.md +3 -3
  43. package/template/skills/knowledge-prune/SKILL.md +29 -0
  44. package/template/skills/knowledge-prune/references/audit-rules.md +24 -0
  45. package/template/skills/runtime-context/SKILL.md +43 -0
  46. package/template/skills/runtime-context/references/path-resolution.md +32 -0
  47. package/template/skills/speculo-retro/SKILL.md +13 -37
  48. package/template/skills/speculo-retro/references/friction-taxonomy.md +3 -3
  49. package/template/skills/speculo-retro/references/issue-drafting-sop.md +3 -3
  50. package/template/skills/worktree-isolation/SKILL.md +10 -46
  51. package/template/skills/worktree-isolation/references/audit-branch-tree.md +2 -2
  52. package/template/skills/worktree-isolation/references/create-worktree.md +6 -6
  53. package/template/skills/worktree-isolation/references/merge-and-cleanup.md +5 -5
  54. package/template/vendor/README.md +11 -10
  55. package/template/vendor/matt-pocock/README.md +41 -0
  56. package/template/vendor/matt-pocock/engineering/README.md +28 -0
  57. package/template/vendor/matt-pocock/engineering/ask-matt/SKILL.md +76 -0
  58. package/template/vendor/matt-pocock/engineering/code-review/SKILL.md +89 -0
  59. package/template/vendor/matt-pocock/engineering/codebase-design/DEEPENING.md +37 -0
  60. package/template/vendor/matt-pocock/engineering/codebase-design/DESIGN-IT-TWICE.md +44 -0
  61. package/template/vendor/matt-pocock/engineering/codebase-design/SKILL.md +114 -0
  62. package/template/vendor/matt-pocock/engineering/diagnosing-bugs/SKILL.md +134 -0
  63. package/template/vendor/matt-pocock/engineering/diagnosing-bugs/scripts/hitl-loop.template.sh +41 -0
  64. package/template/vendor/matt-pocock/engineering/domain-modeling/ADR-FORMAT.md +47 -0
  65. package/template/vendor/matt-pocock/engineering/domain-modeling/CONTEXT-FORMAT.md +60 -0
  66. package/template/vendor/matt-pocock/engineering/domain-modeling/SKILL.md +74 -0
  67. package/template/vendor/matt-pocock/engineering/grill-with-docs/SKILL.md +7 -0
  68. package/template/vendor/matt-pocock/engineering/implement/SKILL.md +15 -0
  69. package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/HTML-REPORT.md +123 -0
  70. package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/SKILL.md +66 -0
  71. package/template/vendor/matt-pocock/engineering/prototype/LOGIC.md +79 -0
  72. package/template/vendor/matt-pocock/engineering/prototype/SKILL.md +30 -0
  73. package/template/vendor/matt-pocock/engineering/prototype/UI.md +112 -0
  74. package/template/vendor/matt-pocock/engineering/research/SKILL.md +12 -0
  75. package/template/vendor/matt-pocock/engineering/resolving-merge-conflicts/SKILL.md +14 -0
  76. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/SKILL.md +127 -0
  77. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/domain.md +51 -0
  78. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-github.md +45 -0
  79. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +46 -0
  80. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-local.md +30 -0
  81. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/triage-labels.md +15 -0
  82. package/template/vendor/matt-pocock/engineering/tdd/SKILL.md +36 -0
  83. package/template/vendor/matt-pocock/engineering/tdd/mocking.md +59 -0
  84. package/template/vendor/matt-pocock/engineering/tdd/tests.md +77 -0
  85. package/template/vendor/matt-pocock/engineering/to-spec/SKILL.md +75 -0
  86. package/template/vendor/matt-pocock/engineering/to-tickets/SKILL.md +113 -0
  87. package/template/vendor/matt-pocock/engineering/triage/AGENT-BRIEF.md +204 -0
  88. package/template/vendor/matt-pocock/engineering/triage/OUT-OF-SCOPE.md +104 -0
  89. package/template/vendor/matt-pocock/engineering/triage/SKILL.md +112 -0
  90. package/template/vendor/matt-pocock/engineering/wayfinder/SKILL.md +127 -0
  91. package/template/vendor/matt-pocock/in-progress/README.md +10 -0
  92. package/template/vendor/matt-pocock/in-progress/claude-handoff/SKILL.md +18 -0
  93. package/template/vendor/matt-pocock/in-progress/loop-me/SKILL.md +32 -0
  94. package/template/vendor/matt-pocock/in-progress/wizard/SKILL.md +45 -0
  95. package/template/vendor/matt-pocock/in-progress/wizard/template.sh +211 -0
  96. package/template/vendor/matt-pocock/in-progress/writing-beats/SKILL.md +67 -0
  97. package/template/vendor/matt-pocock/in-progress/writing-fragments/SKILL.md +78 -0
  98. package/template/vendor/matt-pocock/in-progress/writing-shape/SKILL.md +79 -0
  99. package/template/vendor/matt-pocock/productivity/README.md +18 -0
  100. package/template/vendor/matt-pocock/productivity/grill-me/SKILL.md +7 -0
  101. package/template/vendor/matt-pocock/productivity/grilling/SKILL.md +12 -0
  102. package/template/vendor/matt-pocock/productivity/handoff/SKILL.md +16 -0
  103. package/template/vendor/matt-pocock/productivity/teach/GLOSSARY-FORMAT.md +35 -0
  104. package/template/vendor/matt-pocock/productivity/teach/LEARNING-RECORD-FORMAT.md +46 -0
  105. package/template/vendor/matt-pocock/productivity/teach/MISSION-FORMAT.md +31 -0
  106. package/template/vendor/matt-pocock/productivity/teach/RESOURCES-FORMAT.md +32 -0
  107. package/template/vendor/matt-pocock/productivity/teach/SKILL.md +140 -0
  108. package/template/vendor/matt-pocock/productivity/writing-great-skills/GLOSSARY.md +201 -0
  109. package/template/vendor/matt-pocock/productivity/writing-great-skills/SKILL.md +83 -0
  110. package/template/workflows/matt-pocock/WORKFLOW.md +145 -0
  111. package/template/workflows/matt-pocock/_state/status.json +5 -0
  112. package/template/workflows/matt-pocock/routes/architecture.md +24 -0
  113. package/template/workflows/matt-pocock/routes/diagnose.md +22 -0
  114. package/template/workflows/matt-pocock/routes/experimental.md +18 -0
  115. package/template/workflows/matt-pocock/routes/idea-to-delivery.md +63 -0
  116. package/template/workflows/matt-pocock/routes/merge-conflicts.md +19 -0
  117. package/template/workflows/matt-pocock/routes/productivity.md +25 -0
  118. package/template/workflows/matt-pocock/routes/research-prototype.md +20 -0
  119. package/template/workflows/matt-pocock/routes/review.md +19 -0
  120. package/template/workflows/matt-pocock/routes/setup.md +42 -0
  121. package/template/workflows/matt-pocock/routes/triage.md +25 -0
  122. package/template/workflows/matt-pocock/routes/wayfinder.md +27 -0
  123. package/template/workflows/person/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md +74 -59
  124. package/template/workflows/person/M-mao-zedong-cognitive-os/activate.md +2 -2
  125. package/template/workflows/person/M-mao-zedong-cognitive-os/deliver.md +5 -5
  126. package/template/workflows/person/M-mao-zedong-cognitive-os/diagnose.md +2 -2
  127. package/template/workflows/person/M-mao-zedong-cognitive-os/mobilize.md +4 -4
  128. package/template/workflows/person/M-mao-zedong-cognitive-os/strategize.md +3 -3
  129. package/template/workflows/person/WORKFLOW.md +68 -0
  130. package/template/workflows/person/_state/.config/LESSONS.md +3 -0
  131. package/template/workflows/person/_state/.config/RULES.md +3 -0
  132. package/template/workflows/person/_state/changes/.gitkeep +1 -0
  133. package/template/workflows/person/_state/status.json +5 -0
  134. package/template/.speculo/.config/LESSONS.md +0 -9
  135. package/template/.speculo/.config/RULES.md +0 -11
  136. package/template/.speculo/AGENTS.md +0 -30
  137. package/template/.speculo/archive/AGENTS.md +0 -28
  138. package/template/.speculo/archive/dev/.gitkeep +0 -0
  139. package/template/.speculo/archive/person/.gitkeep +0 -0
  140. package/template/.speculo/dev/.gitkeep +0 -0
  141. package/template/.speculo/dev/docs-sync-state.json +0 -14
  142. package/template/.speculo/dev-status.json +0 -3
  143. package/template/.speculo/doc-status.json +0 -3
  144. package/template/.speculo/person/.gitkeep +0 -0
  145. package/template/.speculo/person-status.json +0 -1
  146. package/template/commands/archive.md +0 -68
  147. package/template/commands/caveman.md +0 -50
  148. package/template/commands/config-prune.md +0 -59
  149. package/template/commands/grill-me.md +0 -48
  150. package/template/commands/handoff.md +0 -59
  151. package/template/commands/scaffold-exercises.md +0 -56
  152. package/template/commands/write-a-skill.md +0 -52
  153. package/template/skills/caveman/SKILL.md +0 -38
  154. package/template/skills/caveman/references/compression-rules.md +0 -102
  155. package/template/skills/config-prune/SKILL.md +0 -44
  156. package/template/skills/config-prune/references/audit-rules.md +0 -38
  157. package/template/skills/grill-me/SKILL.md +0 -40
  158. package/template/skills/handoff/SKILL.md +0 -73
  159. package/template/skills/scaffold-exercises/SKILL.md +0 -41
  160. package/template/skills/scaffold-exercises/references/exercise-structure.md +0 -85
  161. package/template/skills/scaffold-exercises/references/lint-and-git.md +0 -54
  162. package/template/skills/speculo-write/SKILL.md +0 -56
  163. package/template/skills/speculo-write/references/asset-selection-sop.md +0 -67
  164. package/template/skills/speculo-write/references/authoring-quality-levers.md +0 -61
  165. package/template/skills/speculo-write/references/command-authoring-sop.md +0 -98
  166. package/template/skills/speculo-write/references/migration-sop.md +0 -101
  167. package/template/skills/speculo-write/references/persistence-contract-sop.md +0 -271
  168. package/template/skills/speculo-write/references/skill-authoring-sop.md +0 -212
  169. package/template/skills/speculo-write/references/validation-checklist.md +0 -85
  170. package/template/skills/speculo-write/references/workflow-authoring-sop.md +0 -165
  171. package/template/vendor/codebase-design/DEEPENING.md +0 -37
  172. package/template/vendor/codebase-design/DESIGN-IT-TWICE.md +0 -44
  173. package/template/vendor/codebase-design/SKILL.md +0 -114
  174. package/template/vendor/officecli/SKILL.md +0 -415
  175. package/template/vendor/resolving-merge-conflicts/SKILL.md +0 -14
  176. package/template/workflows/dev/01-grill-with-docs/01-grill-with-docs.md +0 -107
  177. package/template/workflows/dev/01-grill-with-docs/grill-context-scan.md +0 -30
  178. package/template/workflows/dev/01-grill-with-docs/grill-decision.md +0 -38
  179. package/template/workflows/dev/02-prd/02-prd.md +0 -70
  180. package/template/workflows/dev/02-prd/prd-synthesis.md +0 -30
  181. package/template/workflows/dev/02-prd/prd-zoom-out.md +0 -29
  182. package/template/workflows/dev/03-tdd/03-tdd.md +0 -55
  183. package/template/workflows/dev/03-tdd/agents/tdd-finish-agent.md +0 -34
  184. package/template/workflows/dev/03-tdd/agents/tdd-implement-agent.md +0 -34
  185. package/template/workflows/dev/03-tdd/agents/tdd-plan-agent.md +0 -34
  186. package/template/workflows/dev/03-tdd/mocking.md +0 -43
  187. package/template/workflows/dev/03-tdd/refactoring.md +0 -10
  188. package/template/workflows/dev/03-tdd/tdd-finish.md +0 -34
  189. package/template/workflows/dev/03-tdd/tdd-loop.md +0 -36
  190. package/template/workflows/dev/03-tdd/tdd-plan.md +0 -37
  191. package/template/workflows/dev/03-tdd/tests.md +0 -61
  192. package/template/workflows/dev/04-finalize/04-finalize.md +0 -57
  193. package/template/workflows/dev/04-finalize/agents/completion-gate-agent.md +0 -35
  194. package/template/workflows/dev/04-finalize/completion-gate.md +0 -41
  195. package/template/workflows/dev/04-finalize/finalize-archive.md +0 -55
  196. package/template/workflows/dev/A-improve-architecture/A-improve-architecture.md +0 -60
  197. package/template/workflows/dev/A-improve-architecture/HTML-REPORT.md +0 -123
  198. package/template/workflows/dev/A-improve-architecture/architecture-grill.md +0 -30
  199. package/template/workflows/dev/A-improve-architecture/architecture-review.md +0 -29
  200. package/template/workflows/dev/A-improve-architecture/architecture-scan.md +0 -37
  201. package/template/workflows/dev/AGENTS.md +0 -95
  202. package/template/workflows/dev/D-docs-sync/D-docs-sync.md +0 -140
  203. package/template/workflows/dev/D-docs-sync/agents/docs-diff-agent.md +0 -34
  204. package/template/workflows/dev/D-docs-sync/agents/docs-update-agent.md +0 -34
  205. package/template/workflows/dev/D-docs-sync/agents-contract.md +0 -95
  206. package/template/workflows/dev/D-docs-sync/changelog-contract.md +0 -155
  207. package/template/workflows/dev/D-docs-sync/config-contract.md +0 -75
  208. package/template/workflows/dev/D-docs-sync/docs-sync-diff.md +0 -86
  209. package/template/workflows/dev/D-docs-sync/docs-sync-finish.md +0 -37
  210. package/template/workflows/dev/D-docs-sync/docs-sync-state.md +0 -47
  211. package/template/workflows/dev/D-docs-sync/docs-sync-update.md +0 -44
  212. package/template/workflows/dev/D-docs-sync/knowledge-extract.md +0 -66
  213. package/template/workflows/dev/D-docs-sync/readme-contract.md +0 -124
  214. package/template/workflows/dev/D-docs-sync/state-json-schema.md +0 -172
  215. package/template/workflows/dev/H-diagnose/H-diagnose.md +0 -108
  216. package/template/workflows/dev/H-diagnose/agents/diagnose-agent.md +0 -33
  217. package/template/workflows/dev/H-diagnose/agents/fix-agent.md +0 -34
  218. package/template/workflows/dev/H-diagnose/diagnose-fix.md +0 -34
  219. package/template/workflows/dev/H-diagnose/diagnose-guide.md +0 -144
  220. package/template/workflows/dev/H-diagnose/diagnose-loop.md +0 -41
  221. package/template/workflows/dev/H-diagnose/scripts/hitl-loop.template.sh +0 -41
  222. package/template/workflows/dev/I-to-issues/I-to-issues.md +0 -79
  223. package/template/workflows/dev/I-to-issues/issues-slices.md +0 -211
  224. package/template/workflows/dev/M-domain-modeling/ADR-FORMAT.md +0 -74
  225. package/template/workflows/dev/M-domain-modeling/CONTEXT-FORMAT.md +0 -67
  226. package/template/workflows/dev/M-domain-modeling/M-domain-modeling.md +0 -102
  227. package/template/workflows/dev/R-review/R-review.md +0 -75
  228. package/template/workflows/dev/R-review/agents/engineering-review-agent.md +0 -33
  229. package/template/workflows/dev/R-review/agents/spec-review-agent.md +0 -34
  230. package/template/workflows/dev/R-review/agents/standards-review-agent.md +0 -34
  231. package/template/workflows/dev/R-review/code-quality-checklist.md +0 -118
  232. package/template/workflows/dev/R-review/removal-checklist.md +0 -53
  233. package/template/workflows/dev/R-review/review-axes.md +0 -61
  234. package/template/workflows/dev/R-review/review-setup.md +0 -111
  235. package/template/workflows/dev/R-review/review-verdict.md +0 -43
  236. package/template/workflows/dev/R-review/security-checklist.md +0 -126
  237. package/template/workflows/dev/R-review/solid-checklist.md +0 -73
  238. package/template/workflows/dev/_templates/diagnosis-template.md +0 -20
  239. package/template/workflows/dev/_templates/docs-sync-report-template.md +0 -45
  240. package/template/workflows/dev/_templates/docs-sync-state-template.json +0 -14
  241. package/template/workflows/dev/_templates/domain-model-log-template.md +0 -20
  242. package/template/workflows/dev/_templates/grill-context-map-template.md +0 -20
  243. package/template/workflows/dev/_templates/grill-decision-log-template.md +0 -20
  244. package/template/workflows/dev/_templates/issues-slices-template.md +0 -106
  245. package/template/workflows/dev/_templates/overview-template.md +0 -19
  246. package/template/workflows/dev/_templates/prd-template.md +0 -26
  247. package/template/workflows/dev/_templates/regression-template.md +0 -20
  248. package/template/workflows/dev/_templates/review-report-template.md +0 -30
  249. package/template/workflows/dev/_templates/review-sources-template.md +0 -33
  250. package/template/workflows/dev/_templates/review-verdict-template.md +0 -33
  251. package/template/workflows/dev/_templates/tdd-log-template.md +0 -23
  252. package/template/workflows/dev/_templates/tdd-plan-template.md +0 -35
  253. package/template/workflows/dev/_templates/tdd-verification-template.md +0 -26
  254. package/template/workflows/doc/AGENTS.md +0 -80
  255. package/template/workflows/doc/B-writing-beats/B-writing-beats.md +0 -79
  256. package/template/workflows/doc/B-writing-beats/writing-beats-append.md +0 -31
  257. package/template/workflows/doc/B-writing-beats/writing-beats-options.md +0 -29
  258. package/template/workflows/doc/E-edit-article/E-edit-article.md +0 -79
  259. package/template/workflows/doc/E-edit-article/edit-article-plan.md +0 -30
  260. package/template/workflows/doc/E-edit-article/edit-article-rewrite.md +0 -31
  261. package/template/workflows/doc/F-writing-fragments/F-writing-fragments.md +0 -80
  262. package/template/workflows/doc/F-writing-fragments/writing-fragments-interview.md +0 -32
  263. package/template/workflows/doc/F-writing-fragments/writing-fragments-log.md +0 -29
  264. package/template/workflows/doc/S-writing-shape/S-writing-shape.md +0 -81
  265. package/template/workflows/doc/S-writing-shape/writing-shape-block.md +0 -32
  266. package/template/workflows/doc/S-writing-shape/writing-shape-opening.md +0 -27
  267. package/template/workflows/doc/T-teach/T-teach.md +0 -64
  268. package/template/workflows/doc/T-teach/teach-lesson-wrap.md +0 -63
  269. package/template/workflows/doc/T-teach/teach-lesson.md +0 -53
  270. package/template/workflows/doc/T-teach/teach-mission.md +0 -33
  271. package/template/workflows/doc/T-teach/teach-resources.md +0 -36
  272. package/template/workflows/doc/_templates/edit-article-plan-template.md +0 -25
  273. package/template/workflows/doc/_templates/edit-article-template.md +0 -7
  274. package/template/workflows/doc/_templates/teach-glossary-template.md +0 -26
  275. package/template/workflows/doc/_templates/teach-learning-record-template.md +0 -38
  276. package/template/workflows/doc/_templates/teach-lesson-html-template.md +0 -24
  277. package/template/workflows/doc/_templates/teach-mission-template.md +0 -19
  278. package/template/workflows/doc/_templates/teach-resources-template.md +0 -18
  279. package/template/workflows/doc/_templates/writing-article-template.md +0 -7
  280. package/template/workflows/doc/_templates/writing-beat-options-template.md +0 -21
  281. package/template/workflows/doc/_templates/writing-fragments-template.md +0 -7
  282. package/template/workflows/doc/_templates/writing-interview-log-template.md +0 -21
  283. package/template/workflows/doc/_templates/writing-shape-log-template.md +0 -25
  284. package/template/workflows/person/AGENTS.md +0 -72
  285. /package/template/{.speculo/.config/adr → workflows/matt-pocock/_state/archive}/.gitkeep +0 -0
  286. /package/template/{.speculo/.config/context → workflows/matt-pocock/_state/changes}/.gitkeep +0 -0
  287. /package/template/{.speculo/archive/doc → workflows/person/_state/.config/context}/.gitkeep +0 -0
  288. /package/template/{.speculo/doc → workflows/person/_state/archive}/.gitkeep +0 -0
@@ -1,48 +0,0 @@
1
- ---
2
- id: grill-me
3
- type: command
4
- name: Grill Me
5
- description: 对计划或设计进行逐问式压力测试
6
- keywords: [grill, 追问, pressure-test, 方案]
7
- ---
8
-
9
- # Grill Me 命令
10
-
11
- ## 归档路径模式
12
-
13
- 可选产物目录:`speculo/.speculo/commands/<YYYY-MM-DD>-grill-me-<topic>/`
14
-
15
- 报告文件:`speculo/.speculo/commands/<YYYY-MM-DD>-grill-me-<topic>/report.md`
16
-
17
- - `<YYYY-MM-DD>` 使用当前日期。
18
- - `<topic>` 从被压力测试的计划或决策主题提取,使用小写 kebab-case;无法判断时使用 `decision`。
19
- - 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
20
-
21
- ## 调用的 skills
22
-
23
- - `../skills/grill-me/SKILL.md` — 用户要求拷问计划、设计或决策时读取。
24
-
25
- ## 执行步骤
26
-
27
- 1. 读取 `../skills/grill-me/SKILL.md`。
28
- 2. 先探索可从仓库确认的事实。
29
- 3. 对无法从仓库确认且会改变决策树的问题,每次只问一个。
30
- 4. 用户要求持久化时,把已确认决策和开放问题写入 `speculo/.speculo/commands/<YYYY-MM-DD>-grill-me-<topic>/report.md`。
31
-
32
- ## 产物模板(report.md,可选)
33
-
34
- > **服务命令:** `grill-me.md`
35
- > **产物文件名:** `report.md`
36
-
37
- ```markdown
38
- # Grill Me Report
39
-
40
- ## 主题
41
- [TODO: 记录被压力测试的计划或设计。]
42
-
43
- ## 已确认决策
44
- [TODO: 列出已确认决策和用户确认依据。]
45
-
46
- ## 开放问题
47
- [TODO: 列出仍未解决的问题、推荐答案和阻塞原因。]
48
- ```
@@ -1,59 +0,0 @@
1
- ---
2
- id: handoff
3
- type: command
4
- name: Handoff
5
- description: 生成脱敏交接文档,供另一个 agent 或会话接手
6
- keywords: [handoff, 交接, summary, resume]
7
- ---
8
-
9
- # Handoff 命令
10
-
11
- ## 归档路径模式
12
-
13
- 产物目录:`speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/`
14
-
15
- 交接文件:`speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`
16
-
17
- - `<YYYY-MM-DD>` 使用当前日期。
18
- - `<topic>` 从用户目标或交接主题提取,使用小写 kebab-case;无法判断时使用 `session`。
19
- - 禁止把交接文档写入 `temp/`、系统临时目录或工作区内其他非规范位置。
20
-
21
- ## 调用的 skills
22
-
23
- - `../skills/handoff/SKILL.md` — 需要把当前对话压缩成交接文档时读取。
24
-
25
- ## 执行步骤
26
-
27
- 1. 读取 `../skills/handoff/SKILL.md`。
28
- 2. 按 `../skills/handoff/SKILL.md` 要求,生成脱敏交接正文与 `<topic>` 建议。
29
- 3. 创建规范命令产物目录 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/`。
30
- 4. 把交接正文写入 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`。
31
- 5. 删除 API key、密码、PII 和其他敏感信息;不要复制 PRD、计划、ADR、issue、commit、diff 或其他已有产物正文。
32
- 6. 返回 `handoff.md` 路径、3-5 条摘要和推荐技能清单。
33
-
34
- ## 产物模板(handoff.md)
35
-
36
- > **服务命令:** `handoff.md`
37
- > **产物文件名:** `handoff.md`
38
-
39
- ```markdown
40
- # Handoff
41
-
42
- ## 目标
43
- [TODO: 概括当前任务目标和用户下一步重点。]
44
-
45
- ## 已完成
46
- [TODO: 列出已完成工作、关键决策和重要文件路径。]
47
-
48
- ## 未完成
49
- [TODO: 列出下一步、阻塞点和剩余风险。]
50
-
51
- ## 验证
52
- [TODO: 记录已运行命令、结果和未运行原因。]
53
-
54
- ## 推荐技能
55
- [TODO: 列出下一个 agent 推荐读取的 skill。]
56
-
57
- ## 摘要
58
- [TODO: 用 3-5 条概括交接内容,不复制敏感信息。]
59
- ```
@@ -1,56 +0,0 @@
1
- ---
2
- id: scaffold-exercises
3
- type: command
4
- name: Scaffold Exercises
5
- description: 创建课程练习目录骨架并运行练习 lint
6
- keywords: [exercises, scaffold, course, lint, 练习]
7
- ---
8
-
9
- # Scaffold Exercises 命令
10
-
11
- ⚠️ **本命令会创建或移动项目文件,且 source skill 可能执行 git commit。AI 必须先列出影响清单并征求用户确认才能执行。**
12
-
13
- ## 归档路径模式
14
-
15
- 产物目录:`speculo/.speculo/commands/<YYYY-MM-DD>-scaffold-exercises-<topic>/`
16
-
17
- 报告文件:`speculo/.speculo/commands/<YYYY-MM-DD>-scaffold-exercises-<topic>/report.md`
18
-
19
- - `<YYYY-MM-DD>` 使用当前日期。
20
- - `<topic>` 从章节、练习或课程主题提取,使用小写 kebab-case;无法判断时使用 `exercises`。
21
- - 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
22
-
23
- ## 调用的 skills
24
-
25
- - `../skills/scaffold-exercises/SKILL.md` — 用户要求创建课程章节或练习桩时读取。
26
-
27
- ## 执行步骤
28
-
29
- 1. 读取 `../skills/scaffold-exercises/SKILL.md`。
30
- 2. 解析章节、练习、编号、名称、变体类型和目标路径。
31
- 3. 列出将创建、移动或提交的路径,以及将运行的 lint / git 命令。
32
- 4. 等待用户明确确认;没有确认时只输出计划,不创建目录、不提交 git。
33
- 5. 用户确认后执行创建、lint 和修复循环。
34
- 6. 只有用户明确要求时才执行 git commit。
35
- 7. 写入 `speculo/.speculo/commands/<YYYY-MM-DD>-scaffold-exercises-<topic>/report.md`。
36
-
37
- ## 产物模板(report.md)
38
-
39
- > **服务命令:** `scaffold-exercises.md`
40
- > **产物文件名:** `report.md`
41
-
42
- ```markdown
43
- # Scaffold Exercises Report
44
-
45
- ## 影响清单
46
- [TODO: 列出将创建或移动的章节、练习和变体路径。]
47
-
48
- ## 用户确认
49
- [TODO: 记录用户确认执行的原始内容摘要。]
50
-
51
- ## 执行结果
52
- [TODO: 记录目录创建、lint、修复和可选 git commit 结果。]
53
-
54
- ## 后续事项
55
- [TODO: 列出仍需补充内容、失败 lint 或阻塞原因。]
56
- ```
@@ -1,52 +0,0 @@
1
- ---
2
- id: write-a-skill
3
- type: command
4
- name: Write A Skill
5
- description: 创建或审查新的 Speculo skill 草稿
6
- keywords: [skill, create, write, 技能]
7
- ---
8
-
9
- # Write A Skill 命令
10
-
11
- ## 归档路径模式
12
-
13
- 产物目录:`speculo/.speculo/commands/<YYYY-MM-DD>-write-a-skill-<topic>/`
14
-
15
- 报告文件:`speculo/.speculo/commands/<YYYY-MM-DD>-write-a-skill-<topic>/report.md`
16
-
17
- - `<YYYY-MM-DD>` 使用当前日期。
18
- - `<topic>` 从 skill 名称或用户主题提取,使用小写 kebab-case;无法判断时使用 `skill`。
19
- - 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
20
-
21
- ## 调用的 skills
22
-
23
- - `../skills/speculo-write/SKILL.md` — 用户要求创建、审查或改进可复用 skill 时读取;该 skill 自带 skill authoring 规范。
24
-
25
- ## 执行步骤
26
-
27
- 1. 读取 `../skills/speculo-write/SKILL.md`,并按其 `references/skill-authoring-sop.md` 内化 skill 规范。
28
- 2. 先收集技能用途、触发条件、输入输出、脚本需求和示例需求。
29
- 3. 写文件前列出将创建或修改的路径,并等待用户明确确认。
30
- 4. 用户确认后,按 Speculo 契约创建 `../skills/<name>/SKILL.md` 及可选 `references/`、`scripts/`、`examples/`。
31
- 5. 把设计摘要、影响路径和验证结果写入 `speculo/.speculo/commands/<YYYY-MM-DD>-write-a-skill-<topic>/report.md`。
32
-
33
- ## 产物模板(report.md)
34
-
35
- > **服务命令:** `write-a-skill.md`
36
- > **产物文件名:** `report.md`
37
-
38
- ```markdown
39
- # Write A Skill Report
40
-
41
- ## 技能目标
42
- [TODO: 描述新 skill 的任务、触发条件和使用者。]
43
-
44
- ## 影响路径
45
- [TODO: 列出本次创建或修改的路径。]
46
-
47
- ## 用户确认
48
- [TODO: 记录用户确认创建或修改文件的原始内容摘要。]
49
-
50
- ## 验证结果
51
- [TODO: 记录 frontmatter、自包含性、渐进披露和脚本检查结果。]
52
- ```
@@ -1,38 +0,0 @@
1
- ---
2
- id: caveman
3
- type: skill
4
- name: Caveman
5
- description: 启用或关闭超压缩沟通模式以降低 token 消耗;当用户要求 caveman mode、少 token、极简技术表达,或调用 command/caveman 时使用。
6
- ---
7
-
8
- # Caveman
9
-
10
- ## 何时使用
11
-
12
- 当用户要求 `caveman mode`、`talk like caveman`、`use caveman`、少 token、极简表达、`be brief`,或调用对应 command 时使用。
13
-
14
- 当用户要求 `stop caveman`、`normal mode` 或明确恢复正常表达时关闭。
15
-
16
- ## 输入
17
-
18
- - 用户对沟通模式的启用、关闭或保持要求
19
- - 当前对话中的技术事实、风险和下一步动作
20
- - 需要原样保留的代码、命令、错误信息或用户引用
21
-
22
- ## 输出
23
-
24
- - 保留技术准确性的压缩回复风格
25
- - 必要时对安全风险、不可逆操作或多步骤顺序使用完整清晰表达
26
- - 不产生 `speculo/.speculo/` 或 `.status.json` 持久化产物
27
-
28
- ## 执行步骤
29
-
30
- 1. 判定用户是在启用、关闭还是检查 caveman mode。
31
- 2. 启用后跨轮保持,直到用户明确关闭。
32
- 3. 使用 `references/compression-rules.md` 的压缩规则、例外和示例。
33
- 4. 原样保留代码块、命令、错误信息和需要精确引用的文本。
34
- 5. 遇到安全警告、不可逆操作确认、易误读的多步骤序列或用户反复澄清时,暂时退出压缩表达;清晰部分结束后恢复。
35
-
36
- ## 渐进披露
37
-
38
- - `references/compression-rules.md`:启用 caveman mode 或判断何时暂时退出压缩表达时读取。
@@ -1,102 +0,0 @@
1
- # Caveman Compression Rules
2
-
3
- ## 持久性
4
-
5
- 一旦触发,每次回复都保持激活。多轮对话后不回退,不漂移回普通表达。
6
-
7
- 如果不确定是否仍激活,就继续保持。只有当用户说 `stop caveman`、`normal mode` 或等价指令时才关闭。
8
-
9
- ## 压缩规则
10
-
11
- 去除:
12
-
13
- - 冠词和不影响含义的连接词
14
- - 填充词,如 just、really、basically、actually、simply
15
- - 客套话,如 sure、certainly、of course、happy to
16
- - 模糊化表达和不必要的铺垫
17
-
18
- 优先使用:
19
-
20
- - 句子片段
21
- - 短同义词,例如用 `big` 而不是 `extensive`
22
- - 常见技术缩写,例如 DB、auth、config、req、res、fn、impl
23
- - 箭头表示因果关系,例如 `X -> Y`
24
- - 一个词能说清时不用两个词
25
-
26
- 保持精确:
27
-
28
- - 技术术语不降级
29
- - 代码块不改写
30
- - 错误信息原样引用
31
- - 不为了短而省略关键前提、风险或边界
32
-
33
- ## 输出模式
34
-
35
- 默认句式:
36
-
37
- ```text
38
- [东西] [动作] [原因]。[下一步]。
39
- ```
40
-
41
- 不要:
42
-
43
- ```text
44
- Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by...
45
- ```
46
-
47
- 要:
48
-
49
- ```text
50
- Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:
51
- ```
52
-
53
- ## 示例
54
-
55
- 用户问:为什么 React 组件重新渲染?
56
-
57
- 回答:
58
-
59
- ```text
60
- 内联对象属性 -> 新引用 -> 重新渲染。用 `useMemo`。
61
- ```
62
-
63
- 用户问:解释数据库连接池。
64
-
65
- 回答:
66
-
67
- ```text
68
- 连接池 = 复用数据库连接。跳过握手 -> 高负载下更快。
69
- ```
70
-
71
- ## 自动清晰度例外
72
-
73
- 遇到以下情况暂时退出 caveman mode:
74
-
75
- - 安全警告
76
- - 不可逆操作的确认
77
- - 片段顺序可能导致误读的多步骤序列
78
- - 用户要求澄清或重复提问
79
-
80
- 清晰部分完成后恢复 caveman mode。
81
-
82
- 示例:
83
-
84
- ```md
85
- **警告:** 这将永久删除 `users` 表中的所有行,且无法撤销。
86
-
87
- DROP TABLE users;
88
-
89
- 恢复 caveman mode。先确认备份存在。
90
- ```
91
-
92
- 也可以在实际回复中使用 SQL fence:
93
-
94
- ````md
95
- **警告:** 这将永久删除 `users` 表中的所有行,且无法撤销。
96
-
97
- ```sql
98
- DROP TABLE users;
99
- ```
100
-
101
- 恢复 caveman mode。先确认备份存在。
102
- ````
@@ -1,44 +0,0 @@
1
- ---
2
- id: config-prune
3
- type: skill
4
- name: Config Prune
5
- description: dry-run 审计 .config 中可安全删除或合并的过期知识资产,生成分组候选清单;当用户要求清理 .config、prune config、审计知识资产过期项、或通过 command/config-prune 调用时使用。
6
- ---
7
-
8
- # Config Prune
9
-
10
- ⚠️ **默认 dry-run。** 本 skill 涉及 `.config` 知识资产删除或合并,必须先列出候选清单并征求用户确认。没有确认时只输出候选清单,不删除、不重命名、不改 RULES。
11
-
12
- ## 何时使用
13
-
14
- - 用户要求"清理 .config"、"prune 配置"、"审计 ADR/CONTEXT/LESSONS 过期项"
15
- - 被 `commands/config-prune.md` 或 `workflows/dev/D-docs-sync` 等调用方委托执行审计
16
- - 本 skill 只负责分析与生成候选清单,不自行删除文件、不自行写报告;持久化由调用方负责
17
-
18
- ## 输入
19
-
20
- - `.config` 资产路径:`speculo/.speculo/.config/RULES.md`、`LESSONS.md`、`context/`、`adr/`
21
- - 用户确认状态(dry-run 或 confirmed)
22
-
23
- ## 输出
24
-
25
- - 按 `delete | merge | rewrite | keep | needs-confirmation` 分组的候选清单
26
- - 每个候选包含:来源、证据、风险
27
- - 不产生文件型持久化产物;结构化结果返回给调用方写入
28
-
29
- ## 执行步骤
30
-
31
- 1. 读取 `references/audit-rules.md`,按其中扫描范围与候选类型执行审计。
32
- 2. 如果用户没有明确确认,停止在 dry-run 候选清单。
33
- 3. 用户确认后,按 `references/audit-rules.md`「确认后执行」节操作。
34
-
35
- ## 边界
36
-
37
- - 不删除仍被代码、文档、归档或 active change 引用的 ADR / CONTEXT。
38
- - 不自动解决领域术语冲突;冲突项交给 `../../workflows/dev/M-domain-modeling/M-domain-modeling.md`。
39
- - 不修改 docs-sync state;由 `../../workflows/dev/D-docs-sync/D-docs-sync.md` 推进基线。
40
- - 不自行选择持久化位置;文件型产物由调用方写入规范路径。
41
-
42
- ## 渐进披露
43
-
44
- - `references/audit-rules.md`:执行 dry-run 审计或确认后清理时读取。
@@ -1,38 +0,0 @@
1
- # Config Prune 审计规则
2
-
3
- dry-run 候选生成与分组规则。`config-prune` skill 入口为调度器,执行审计时读取本文件。
4
-
5
- ## 扫描范围
6
-
7
- 1. 读取 `speculo/.speculo/.config/RULES.md`、`LESSONS.md`、`context/`、`adr/`;缺失路径记录为 `missing`,不自动创建。
8
- 2. 扫描当前仓库引用:
9
- ```bash
10
- rg -n "ADR-[0-9]{4}|[0-9]{4}-[a-z0-9-]+\\.md|CONTEXT|LESSONS|RULES" .
11
- ```
12
- 排除 `node_modules/`、`dist/`、`.git/` 等生成或依赖目录。
13
-
14
- ## 候选类型
15
-
16
- 至少包含以下 dry-run 候选:
17
-
18
- - 指向不存在 ADR 的正文引用或索引行。
19
- - 标记为 superseded 且超过 30 天、无活跃引用的 ADR。
20
- - 只含 `.gitkeep`、TODO、空占位或模板说明的长期知识文件。
21
- - CONTEXT 中当前代码、文档和归档均无证据支撑的术语。
22
- - LESSONS 中重复、过期、只适用单次任务或已被 RULES/ADR 吸收的经验。
23
-
24
- ## 分组输出
25
-
26
- 按 `delete | merge | rewrite | keep | needs-confirmation` 分组;每个候选必须包含来源、证据和风险。
27
-
28
- ## 确认后执行
29
-
30
- - 删除文件前再次检查路径仍位于 `speculo/.speculo/.config/`。
31
- - 修改 `RULES.md` 前必须确认具体条目;不能批量隐式改规则。
32
- - 执行后列出实际改动和跳过项。
33
-
34
- ## 边界
35
-
36
- - 不删除仍被代码、文档、归档或 active change 引用的 ADR / CONTEXT。
37
- - 术语冲突交给 `../../workflows/dev/M-domain-modeling/M-domain-modeling.md`。
38
- - docs-sync state 由 `../../workflows/dev/D-docs-sync/D-docs-sync.md` 推进。
@@ -1,40 +0,0 @@
1
- ---
2
- id: grill-me
3
- type: skill
4
- name: Grill Me
5
- description: 对计划、设计或决策进行逐问式压力测试;当用户要求 grill me、拷问方案、压力测试计划,或调用 command/grill-me 时使用。
6
- ---
7
-
8
- # Grill Me
9
-
10
- ## 何时使用
11
-
12
- 当用户想压力测试计划、设计、架构选择、实现策略或决策树,并希望逐步达成共识时使用。
13
-
14
- 如果问题可以通过探索代码库回答,先探索代码库,不把可查事实推回给用户。
15
-
16
- ## 输入
17
-
18
- - 待拷问的计划、设计、架构选择或实现策略
19
- - 用户已表达的约束、偏好、风险承受度和成功标准
20
- - 可通过仓库探索确认的事实
21
-
22
- ## 输出
23
-
24
- - 每轮一个问题
25
- - 每个问题附带推荐答案
26
- - 已锁定决策、剩余开放点和依赖关系的简短摘要
27
- - 需要持久化时,由调用方 command 或 workflow 归档摘要
28
-
29
- ## 执行步骤
30
-
31
- 1. 识别当前最影响方案正确性的未决问题。
32
- 2. 如果答案能通过本地代码、文档或配置确认,先读取相关材料。
33
- 3. 每次只问一个问题,避免问题组。
34
- 4. 对每个问题给出推荐答案,并说明推荐理由。
35
- 5. 用户回答后更新已锁定决策和剩余分支。
36
- 6. 继续遍历决策树,直到核心分支达成共识或用户停止。
37
-
38
- ## 渐进披露
39
-
40
- 无额外文件。该 skill 的完整执行规则在本入口中。
@@ -1,73 +0,0 @@
1
- ---
2
- id: handoff
3
- type: skill
4
- name: Handoff
5
- description: 将当前对话压缩成脱敏交接正文与元数据;当用户需要另一个 agent、另一个会话或 command/handoff 接手继续工作时使用。
6
- ---
7
-
8
- # Handoff
9
-
10
- ## 何时使用
11
-
12
- 当当前上下文需要交给另一个 agent、另一个会话或异步执行者继续时使用。
13
-
14
- 如果用户提供参数,把参数视为下一次会话的重点,并据此调整交接文档的内容取舍。
15
-
16
- ## 输入
17
-
18
- - 当前对话目标、已完成工作和未完成事项
19
- - 已修改或需要关注的文件路径、命令、测试结果和阻塞点
20
- - 用户提供的下一次会话重点
21
- - 可推荐给下一个 agent 的 skill 名称
22
-
23
- ## 输出
24
-
25
- - 脱敏交接正文(Markdown),供调用方写入规范命令产物目录
26
- - 建议的 `<topic>` 目录名(kebab-case)与命名依据
27
- - 3-5 条极简摘要
28
- - 推荐技能清单
29
-
30
- **本 skill 不自行创建目录、不写盘。** 持久化由 `commands/handoff.md` 独占负责。
31
-
32
- ## 命名建议
33
-
34
- - `<YYYY-MM-DD>` 使用当前日期。
35
- - `<topic>` 从用户目标、项目名、变更名或下一次会话重点提取,使用小写 kebab-case;无法判断时使用 `session`。
36
- - 安装后的目标路径为 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`。
37
-
38
- ## 执行步骤
39
-
40
- 1. 收集当前目标、背景、已做工作、关键文件、验证结果、剩余风险和下一步。
41
- 2. 删除 API key、密码、token、个人身份信息和其他敏感内容。
42
- 3. 不复制 PRD、计划、ADR、issue、commit、diff 或其他已有产物正文;改用路径、URL 或 commit 引用。
43
- 4. 添加 `## 推荐技能` 部分,列出下一个 agent 应优先读取或调用的 skill。
44
- 5. 按下方结构组织脱敏正文,连同 `<topic>` 建议、摘要和推荐技能清单返回给调用方。
45
-
46
- ## 正文结构
47
-
48
- ```markdown
49
- # Handoff
50
-
51
- ## 目标
52
- [概括当前任务目标和用户下一步重点。]
53
-
54
- ## 已完成
55
- [列出已完成工作、关键决策和重要文件路径。]
56
-
57
- ## 未完成
58
- [列出下一步、阻塞点和剩余风险。]
59
-
60
- ## 验证
61
- [记录已运行命令、结果和未运行原因。]
62
-
63
- ## 推荐技能
64
- [列出下一个 agent 推荐读取的 skill。]
65
-
66
- ## 摘要
67
- [用 3-5 条概括交接内容,不复制敏感信息。]
68
- ```
69
-
70
- ## references/ 与 scripts/
71
-
72
- - 无 `references/` 子文档;该 skill 的完整执行规则在本入口中。
73
- - 无 `scripts/`;直接按本文件步骤整理交接正文并返回。
@@ -1,41 +0,0 @@
1
- ---
2
- id: scaffold-exercises
3
- type: skill
4
- name: Scaffold Exercises
5
- description: 创建课程章节与练习目录骨架并验证 lint;当用户要求 scaffold exercises、创建练习桩、设置课程章节,或调用 command/scaffold-exercises 时使用。
6
- ---
7
-
8
- # Scaffold Exercises
9
-
10
- ## 何时使用
11
-
12
- 当项目包含课程练习结构,用户要求创建章节、练习、`problem/`、`solution/` 或 `explainer/` 桩时使用。
13
-
14
- ## 输入
15
-
16
- - 章节和练习计划、编号、名称和变体类型
17
- - 项目中的练习根目录,默认 `exercises/`
18
- - 项目的 lint 命令,默认 `pnpm ai-hero-cli internal lint`
19
- - git 操作要求,例如是否需要 `git mv`、是否需要提交
20
-
21
- ## 输出
22
-
23
- - 创建或移动的练习目录清单
24
- - 每个练习变体的 `readme.md` 桩
25
- - lint 运行结果和修复摘要
26
- - 如用户或调用方要求提交,输出 commit hash 或无法提交原因
27
-
28
- ## 执行步骤
29
-
30
- 1. 读取 `references/exercise-structure.md`,确认章节、练习、变体和必需文件规则。
31
- 2. 从计划中提取章节名、练习名、编号和变体;缺失变体时默认使用 `explainer/`。
32
- 3. 创建目录前列出影响路径;涉及重命名时使用 `git mv`。
33
- 4. 为每个变体创建最小但非空的 `readme.md`。
34
- 5. 运行 lint;按 `references/lint-and-git.md` 迭代修复,直到通过或记录阻塞。
35
- 6. 仅在用户或调用方明确要求时提交 git。
36
- 7. 不自行选择持久化目录;需要归档时,由调用方 command 或 workflow 写入其声明的 `speculo/.speculo/...` 规范路径。
37
-
38
- ## 渐进披露
39
-
40
- - `references/exercise-structure.md`:解析章节、练习编号、变体目录和必需文件时读取。
41
- - `references/lint-and-git.md`:运行 lint、修复练习结构错误、移动目录或提交时读取。
@@ -1,85 +0,0 @@
1
- # Exercise Structure
2
-
3
- ## 目录命名
4
-
5
- 章节目录位于 `exercises/` 下,格式:
6
-
7
- ```text
8
- XX-section-name/
9
- ```
10
-
11
- 示例:
12
-
13
- ```text
14
- 01-retrieval-skill-building/
15
- ```
16
-
17
- 练习目录位于章节目录下,格式:
18
-
19
- ```text
20
- XX.YY-exercise-name/
21
- ```
22
-
23
- 示例:
24
-
25
- ```text
26
- 01.03-retrieval-with-bm25/
27
- ```
28
-
29
- 规则:
30
-
31
- - 章节编号 = `XX`
32
- - 练习编号 = `XX.YY`
33
- - 名称使用 dash-case,小写字母和连字符
34
- - 练习编号必须匹配所属章节编号
35
-
36
- ## 练习变体
37
-
38
- 每个练习至少需要以下一个子文件夹:
39
-
40
- - `problem/`:带 TODO 的学生工作区
41
- - `solution/`:参考实现
42
- - `explainer/`:概念材料,不含 TODO
43
-
44
- 创建桩时,除非计划另有说明,默认使用 `explainer/`。
45
-
46
- ## 必需文件
47
-
48
- 每个变体文件夹都需要一个 `readme.md`。
49
-
50
- `readme.md` 必须:
51
-
52
- - 非空
53
- - 包含真实内容,即使只有标题和一句描述
54
- - 没有失效链接
55
-
56
- 最小桩:
57
-
58
- ```md
59
- # Exercise Title
60
-
61
- 这里写描述。
62
- ```
63
-
64
- 如果子文件夹包含代码,还需要一个超过 1 行的 `main.ts`。只有 `readme.md` 的练习桩可以是 readme-only。
65
-
66
- ## 示例
67
-
68
- 计划:
69
-
70
- ```text
71
- Section 05: Memory Skill Building
72
- - 05.01 Introduction to Memory
73
- - 05.02 Short-term Memory (explainer + problem + solution)
74
- - 05.03 Long-term Memory
75
- ```
76
-
77
- 创建:
78
-
79
- ```text
80
- exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer/readme.md
81
- exercises/05-memory-skill-building/05.02-short-term-memory/explainer/readme.md
82
- exercises/05-memory-skill-building/05.02-short-term-memory/problem/readme.md
83
- exercises/05-memory-skill-building/05.02-short-term-memory/solution/readme.md
84
- exercises/05-memory-skill-building/05.03-long-term-memory/explainer/readme.md
85
- ```