@namewta/speculo 0.1.20 → 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 (275) 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 +3 -3
  39. package/template/skills/github-npm-ops/references/issue-pr-triage.md +1 -1
  40. package/template/skills/github-npm-ops/references/preflight-checklist.md +4 -4
  41. package/template/skills/github-npm-ops/references/release-notes-injection.md +1 -1
  42. package/template/skills/github-npm-ops/references/release-pipeline.md +13 -13
  43. package/template/skills/github-npm-ops/references/version-bump-flow.md +3 -3
  44. package/template/skills/knowledge-prune/SKILL.md +29 -0
  45. package/template/skills/knowledge-prune/references/audit-rules.md +24 -0
  46. package/template/skills/runtime-context/SKILL.md +43 -0
  47. package/template/skills/runtime-context/references/path-resolution.md +32 -0
  48. package/template/skills/speculo-retro/SKILL.md +13 -37
  49. package/template/skills/speculo-retro/references/friction-taxonomy.md +3 -3
  50. package/template/skills/speculo-retro/references/issue-drafting-sop.md +3 -3
  51. package/template/skills/worktree-isolation/SKILL.md +10 -46
  52. package/template/skills/worktree-isolation/references/audit-branch-tree.md +2 -2
  53. package/template/skills/worktree-isolation/references/create-worktree.md +6 -6
  54. package/template/skills/worktree-isolation/references/merge-and-cleanup.md +5 -5
  55. package/template/vendor/README.md +11 -10
  56. package/template/vendor/matt-pocock/README.md +41 -0
  57. package/template/vendor/matt-pocock/engineering/README.md +28 -0
  58. package/template/vendor/matt-pocock/engineering/ask-matt/SKILL.md +76 -0
  59. package/template/vendor/matt-pocock/engineering/code-review/SKILL.md +89 -0
  60. package/template/vendor/matt-pocock/engineering/codebase-design/DEEPENING.md +37 -0
  61. package/template/vendor/matt-pocock/engineering/codebase-design/DESIGN-IT-TWICE.md +44 -0
  62. package/template/vendor/matt-pocock/engineering/codebase-design/SKILL.md +114 -0
  63. package/template/vendor/matt-pocock/engineering/diagnosing-bugs/SKILL.md +134 -0
  64. package/template/vendor/matt-pocock/engineering/diagnosing-bugs/scripts/hitl-loop.template.sh +41 -0
  65. package/template/vendor/matt-pocock/engineering/domain-modeling/ADR-FORMAT.md +47 -0
  66. package/template/vendor/matt-pocock/engineering/domain-modeling/CONTEXT-FORMAT.md +60 -0
  67. package/template/vendor/matt-pocock/engineering/domain-modeling/SKILL.md +74 -0
  68. package/template/vendor/matt-pocock/engineering/grill-with-docs/SKILL.md +7 -0
  69. package/template/vendor/matt-pocock/engineering/implement/SKILL.md +15 -0
  70. package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/HTML-REPORT.md +123 -0
  71. package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/SKILL.md +66 -0
  72. package/template/vendor/matt-pocock/engineering/prototype/LOGIC.md +79 -0
  73. package/template/vendor/matt-pocock/engineering/prototype/SKILL.md +30 -0
  74. package/template/vendor/matt-pocock/engineering/prototype/UI.md +112 -0
  75. package/template/vendor/matt-pocock/engineering/research/SKILL.md +12 -0
  76. package/template/vendor/matt-pocock/engineering/resolving-merge-conflicts/SKILL.md +14 -0
  77. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/SKILL.md +127 -0
  78. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/domain.md +51 -0
  79. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-github.md +45 -0
  80. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +46 -0
  81. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-local.md +30 -0
  82. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/triage-labels.md +15 -0
  83. package/template/vendor/matt-pocock/engineering/tdd/SKILL.md +36 -0
  84. package/template/vendor/matt-pocock/engineering/tdd/mocking.md +59 -0
  85. package/template/vendor/matt-pocock/engineering/tdd/tests.md +77 -0
  86. package/template/vendor/matt-pocock/engineering/to-spec/SKILL.md +75 -0
  87. package/template/vendor/matt-pocock/engineering/to-tickets/SKILL.md +113 -0
  88. package/template/vendor/matt-pocock/engineering/triage/AGENT-BRIEF.md +204 -0
  89. package/template/vendor/matt-pocock/engineering/triage/OUT-OF-SCOPE.md +104 -0
  90. package/template/vendor/matt-pocock/engineering/triage/SKILL.md +112 -0
  91. package/template/vendor/matt-pocock/engineering/wayfinder/SKILL.md +127 -0
  92. package/template/vendor/matt-pocock/in-progress/README.md +10 -0
  93. package/template/vendor/matt-pocock/in-progress/claude-handoff/SKILL.md +18 -0
  94. package/template/vendor/matt-pocock/in-progress/loop-me/SKILL.md +32 -0
  95. package/template/vendor/matt-pocock/in-progress/wizard/SKILL.md +45 -0
  96. package/template/vendor/matt-pocock/in-progress/wizard/template.sh +211 -0
  97. package/template/vendor/matt-pocock/in-progress/writing-beats/SKILL.md +67 -0
  98. package/template/vendor/matt-pocock/in-progress/writing-fragments/SKILL.md +78 -0
  99. package/template/vendor/matt-pocock/in-progress/writing-shape/SKILL.md +79 -0
  100. package/template/vendor/matt-pocock/productivity/README.md +18 -0
  101. package/template/vendor/matt-pocock/productivity/grill-me/SKILL.md +7 -0
  102. package/template/vendor/matt-pocock/productivity/grilling/SKILL.md +12 -0
  103. package/template/vendor/matt-pocock/productivity/handoff/SKILL.md +16 -0
  104. package/template/vendor/matt-pocock/productivity/teach/GLOSSARY-FORMAT.md +35 -0
  105. package/template/vendor/matt-pocock/productivity/teach/LEARNING-RECORD-FORMAT.md +46 -0
  106. package/template/vendor/matt-pocock/productivity/teach/MISSION-FORMAT.md +31 -0
  107. package/template/vendor/matt-pocock/productivity/teach/RESOURCES-FORMAT.md +32 -0
  108. package/template/vendor/matt-pocock/productivity/teach/SKILL.md +140 -0
  109. package/template/vendor/matt-pocock/productivity/writing-great-skills/GLOSSARY.md +201 -0
  110. package/template/vendor/matt-pocock/productivity/writing-great-skills/SKILL.md +83 -0
  111. package/template/workflows/matt-pocock/WORKFLOW.md +145 -0
  112. package/template/workflows/matt-pocock/_state/status.json +5 -0
  113. package/template/workflows/matt-pocock/routes/architecture.md +24 -0
  114. package/template/workflows/matt-pocock/routes/diagnose.md +22 -0
  115. package/template/workflows/matt-pocock/routes/experimental.md +18 -0
  116. package/template/workflows/matt-pocock/routes/idea-to-delivery.md +63 -0
  117. package/template/workflows/matt-pocock/routes/merge-conflicts.md +19 -0
  118. package/template/workflows/matt-pocock/routes/productivity.md +25 -0
  119. package/template/workflows/matt-pocock/routes/research-prototype.md +20 -0
  120. package/template/workflows/matt-pocock/routes/review.md +19 -0
  121. package/template/workflows/matt-pocock/routes/setup.md +42 -0
  122. package/template/workflows/matt-pocock/routes/triage.md +25 -0
  123. package/template/workflows/matt-pocock/routes/wayfinder.md +27 -0
  124. package/template/workflows/person/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md +74 -185
  125. package/template/workflows/person/M-mao-zedong-cognitive-os/activate.md +3 -2
  126. package/template/workflows/person/M-mao-zedong-cognitive-os/books/README.md +12 -238
  127. package/template/workflows/person/M-mao-zedong-cognitive-os/deliver.md +6 -5
  128. package/template/workflows/person/M-mao-zedong-cognitive-os/diagnose.md +5 -63
  129. package/template/workflows/person/M-mao-zedong-cognitive-os/mobilize.md +7 -54
  130. package/template/workflows/person/M-mao-zedong-cognitive-os/references/research/15-quote-bank.md +10 -10
  131. package/template/workflows/person/M-mao-zedong-cognitive-os/strategize.md +6 -72
  132. package/template/workflows/person/WORKFLOW.md +68 -0
  133. package/template/workflows/person/_state/.config/LESSONS.md +3 -0
  134. package/template/workflows/person/_state/.config/RULES.md +3 -0
  135. package/template/workflows/person/_state/changes/.gitkeep +1 -0
  136. package/template/workflows/person/_state/status.json +5 -0
  137. package/template/.speculo/.config/LESSONS.md +0 -9
  138. package/template/.speculo/.config/RULES.md +0 -11
  139. package/template/.speculo/AGENTS.md +0 -30
  140. package/template/.speculo/archive/AGENTS.md +0 -28
  141. package/template/.speculo/archive/dev/.gitkeep +0 -0
  142. package/template/.speculo/archive/person/.gitkeep +0 -0
  143. package/template/.speculo/dev/.gitkeep +0 -0
  144. package/template/.speculo/dev/docs-sync-state.json +0 -14
  145. package/template/.speculo/dev-status.json +0 -3
  146. package/template/.speculo/doc-status.json +0 -3
  147. package/template/.speculo/person/.gitkeep +0 -0
  148. package/template/.speculo/person-status.json +0 -1
  149. package/template/commands/archive.md +0 -68
  150. package/template/commands/caveman.md +0 -50
  151. package/template/commands/config-prune.md +0 -59
  152. package/template/commands/grill-me.md +0 -48
  153. package/template/commands/handoff.md +0 -59
  154. package/template/commands/scaffold-exercises.md +0 -56
  155. package/template/commands/write-a-skill.md +0 -52
  156. package/template/skills/caveman/SKILL.md +0 -38
  157. package/template/skills/caveman/references/compression-rules.md +0 -102
  158. package/template/skills/config-prune/SKILL.md +0 -66
  159. package/template/skills/grill-me/SKILL.md +0 -40
  160. package/template/skills/handoff/SKILL.md +0 -50
  161. package/template/skills/scaffold-exercises/SKILL.md +0 -41
  162. package/template/skills/scaffold-exercises/references/exercise-structure.md +0 -85
  163. package/template/skills/scaffold-exercises/references/lint-and-git.md +0 -54
  164. package/template/skills/speculo-write/SKILL.md +0 -56
  165. package/template/skills/speculo-write/references/asset-selection-sop.md +0 -67
  166. package/template/skills/speculo-write/references/authoring-quality-levers.md +0 -61
  167. package/template/skills/speculo-write/references/command-authoring-sop.md +0 -98
  168. package/template/skills/speculo-write/references/migration-sop.md +0 -101
  169. package/template/skills/speculo-write/references/persistence-contract-sop.md +0 -192
  170. package/template/skills/speculo-write/references/skill-authoring-sop.md +0 -212
  171. package/template/skills/speculo-write/references/validation-checklist.md +0 -85
  172. package/template/skills/speculo-write/references/workflow-authoring-sop.md +0 -132
  173. package/template/vendor/codebase-design/DEEPENING.md +0 -37
  174. package/template/vendor/codebase-design/DESIGN-IT-TWICE.md +0 -44
  175. package/template/vendor/codebase-design/SKILL.md +0 -114
  176. package/template/vendor/officecli/SKILL.md +0 -415
  177. package/template/vendor/resolving-merge-conflicts/SKILL.md +0 -14
  178. package/template/workflows/dev/01-grill-with-docs/01-grill-with-docs.md +0 -107
  179. package/template/workflows/dev/01-grill-with-docs/grill-context-scan.md +0 -30
  180. package/template/workflows/dev/01-grill-with-docs/grill-decision.md +0 -38
  181. package/template/workflows/dev/02-prd/02-prd.md +0 -70
  182. package/template/workflows/dev/02-prd/prd-synthesis.md +0 -30
  183. package/template/workflows/dev/02-prd/prd-zoom-out.md +0 -29
  184. package/template/workflows/dev/03-tdd/03-tdd.md +0 -158
  185. package/template/workflows/dev/03-tdd/mocking.md +0 -43
  186. package/template/workflows/dev/03-tdd/refactoring.md +0 -10
  187. package/template/workflows/dev/03-tdd/tdd-finish.md +0 -34
  188. package/template/workflows/dev/03-tdd/tdd-loop.md +0 -36
  189. package/template/workflows/dev/03-tdd/tdd-plan.md +0 -37
  190. package/template/workflows/dev/03-tdd/tests.md +0 -61
  191. package/template/workflows/dev/04-finalize/04-finalize.md +0 -137
  192. package/template/workflows/dev/04-finalize/completion-gate.md +0 -41
  193. package/template/workflows/dev/04-finalize/finalize-archive.md +0 -55
  194. package/template/workflows/dev/A-improve-architecture/A-improve-architecture.md +0 -143
  195. package/template/workflows/dev/A-improve-architecture/HTML-REPORT.md +0 -123
  196. package/template/workflows/dev/AGENTS.md +0 -87
  197. package/template/workflows/dev/D-docs-sync/D-docs-sync.md +0 -127
  198. package/template/workflows/dev/D-docs-sync/agents-contract.md +0 -95
  199. package/template/workflows/dev/D-docs-sync/changelog-contract.md +0 -155
  200. package/template/workflows/dev/D-docs-sync/config-contract.md +0 -75
  201. package/template/workflows/dev/D-docs-sync/docs-sync-diff.md +0 -86
  202. package/template/workflows/dev/D-docs-sync/docs-sync-finish.md +0 -37
  203. package/template/workflows/dev/D-docs-sync/docs-sync-state.md +0 -47
  204. package/template/workflows/dev/D-docs-sync/docs-sync-update.md +0 -44
  205. package/template/workflows/dev/D-docs-sync/knowledge-extract.md +0 -66
  206. package/template/workflows/dev/D-docs-sync/readme-contract.md +0 -124
  207. package/template/workflows/dev/D-docs-sync/state-json-schema.md +0 -172
  208. package/template/workflows/dev/H-diagnose/H-diagnose.md +0 -119
  209. package/template/workflows/dev/H-diagnose/diagnose-fix.md +0 -34
  210. package/template/workflows/dev/H-diagnose/diagnose-guide.md +0 -144
  211. package/template/workflows/dev/H-diagnose/diagnose-loop.md +0 -41
  212. package/template/workflows/dev/H-diagnose/scripts/hitl-loop.template.sh +0 -41
  213. package/template/workflows/dev/I-to-issues/I-to-issues.md +0 -140
  214. package/template/workflows/dev/I-to-issues/issues-slices.md +0 -211
  215. package/template/workflows/dev/M-domain-modeling/ADR-FORMAT.md +0 -74
  216. package/template/workflows/dev/M-domain-modeling/CONTEXT-FORMAT.md +0 -67
  217. package/template/workflows/dev/M-domain-modeling/M-domain-modeling.md +0 -118
  218. package/template/workflows/dev/R-review/R-review.md +0 -163
  219. package/template/workflows/dev/R-review/code-quality-checklist.md +0 -118
  220. package/template/workflows/dev/R-review/removal-checklist.md +0 -53
  221. package/template/workflows/dev/R-review/review-axes.md +0 -61
  222. package/template/workflows/dev/R-review/review-setup.md +0 -73
  223. package/template/workflows/dev/R-review/review-verdict.md +0 -43
  224. package/template/workflows/dev/R-review/security-checklist.md +0 -126
  225. package/template/workflows/dev/R-review/solid-checklist.md +0 -73
  226. package/template/workflows/dev/_templates/diagnosis-template.md +0 -20
  227. package/template/workflows/dev/_templates/docs-sync-report-template.md +0 -45
  228. package/template/workflows/dev/_templates/docs-sync-state-template.json +0 -14
  229. package/template/workflows/dev/_templates/domain-model-log-template.md +0 -20
  230. package/template/workflows/dev/_templates/grill-context-map-template.md +0 -20
  231. package/template/workflows/dev/_templates/grill-decision-log-template.md +0 -20
  232. package/template/workflows/dev/_templates/issues-slices-template.md +0 -106
  233. package/template/workflows/dev/_templates/prd-overview-template.md +0 -20
  234. package/template/workflows/dev/_templates/prd-template.md +0 -26
  235. package/template/workflows/dev/_templates/regression-template.md +0 -20
  236. package/template/workflows/dev/_templates/review-report-template.md +0 -30
  237. package/template/workflows/dev/_templates/review-sources-template.md +0 -33
  238. package/template/workflows/dev/_templates/review-verdict-template.md +0 -33
  239. package/template/workflows/dev/_templates/tdd-log-template.md +0 -23
  240. package/template/workflows/dev/_templates/tdd-plan-template.md +0 -35
  241. package/template/workflows/dev/_templates/tdd-verification-template.md +0 -26
  242. package/template/workflows/doc/AGENTS.md +0 -72
  243. package/template/workflows/doc/B-writing-beats/B-writing-beats.md +0 -79
  244. package/template/workflows/doc/B-writing-beats/writing-beats-append.md +0 -31
  245. package/template/workflows/doc/B-writing-beats/writing-beats-options.md +0 -29
  246. package/template/workflows/doc/E-edit-article/E-edit-article.md +0 -79
  247. package/template/workflows/doc/E-edit-article/edit-article-plan.md +0 -30
  248. package/template/workflows/doc/E-edit-article/edit-article-rewrite.md +0 -31
  249. package/template/workflows/doc/F-writing-fragments/F-writing-fragments.md +0 -80
  250. package/template/workflows/doc/F-writing-fragments/writing-fragments-interview.md +0 -32
  251. package/template/workflows/doc/F-writing-fragments/writing-fragments-log.md +0 -29
  252. package/template/workflows/doc/S-writing-shape/S-writing-shape.md +0 -81
  253. package/template/workflows/doc/S-writing-shape/writing-shape-block.md +0 -32
  254. package/template/workflows/doc/S-writing-shape/writing-shape-opening.md +0 -27
  255. package/template/workflows/doc/T-teach/T-teach.md +0 -147
  256. package/template/workflows/doc/T-teach/teach-lesson-wrap.md +0 -63
  257. package/template/workflows/doc/T-teach/teach-lesson.md +0 -53
  258. package/template/workflows/doc/T-teach/teach-mission.md +0 -33
  259. package/template/workflows/doc/T-teach/teach-resources.md +0 -36
  260. package/template/workflows/doc/_templates/edit-article-plan-template.md +0 -25
  261. package/template/workflows/doc/_templates/edit-article-template.md +0 -7
  262. package/template/workflows/doc/_templates/teach-glossary-template.md +0 -26
  263. package/template/workflows/doc/_templates/teach-learning-record-template.md +0 -38
  264. package/template/workflows/doc/_templates/teach-mission-template.md +0 -19
  265. package/template/workflows/doc/_templates/teach-resources-template.md +0 -18
  266. package/template/workflows/doc/_templates/writing-article-template.md +0 -7
  267. package/template/workflows/doc/_templates/writing-beat-options-template.md +0 -21
  268. package/template/workflows/doc/_templates/writing-fragments-template.md +0 -7
  269. package/template/workflows/doc/_templates/writing-interview-log-template.md +0 -21
  270. package/template/workflows/doc/_templates/writing-shape-log-template.md +0 -25
  271. package/template/workflows/person/AGENTS.md +0 -60
  272. /package/template/{.speculo/.config/adr → workflows/matt-pocock/_state/archive}/.gitkeep +0 -0
  273. /package/template/{.speculo/.config/context → workflows/matt-pocock/_state/changes}/.gitkeep +0 -0
  274. /package/template/{.speculo/archive/doc → workflows/person/_state/.config/context}/.gitkeep +0 -0
  275. /package/template/{.speculo/doc → workflows/person/_state/archive}/.gitkeep +0 -0
@@ -1,60 +0,0 @@
1
- ---
2
- id: person/index
3
- category: person
4
- name: Person Workflow AGENTS Guide
5
- description: 以人物方法论为底座的工作流导航与渐进披露指引
6
- keywords: [person, methodology, agents, 人物, 方法论, cognitive, 认知]
7
- ---
8
-
9
- # Person Workflow AGENTS Guide
10
-
11
- > ⚠️ **持久化铁律:本文件及所有 person workflow 的全部产物,必须且只能写入 `speculo/.speculo/person/<change>/`。绝对禁止写入项目根目录的 `.speculo/`、`temp/` 或其他任何非规范位置。**
12
-
13
- 本文件是 person 分类的 AGENTS 导航入口。进入时先读取 `speculo/.speculo/person-status.json`,再按其中 active change 读取 `speculo/.speculo/person/<change>/.status.json`,根据用户意图推荐横向 workflow。
14
-
15
- > **命名铁律:** 所有 change 目录必须为 `YYYY-MM-DD-<kebab-name>`(例:`2026-06-12-mao-strategy-consult`)。不符合此格式的目录视为 `malformed`,仅汇报不自动操作。
16
-
17
- ## 渐进披露
18
-
19
- 1. 先读本文件,确认当前 person change、咨询模式和入口别名。
20
- 2. 选定入口后,只读取对应 workflow 入口文件(如 `M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md`)。
21
- 3. 进入具体 phase 时,再读取该 phase 文件、模板和被调用 skill wrapper。
22
- 4. 执行中如涉及项目硬约束、跨任务经验、人物方法论上下文、术语定义、ADR 或决策依据,必须参考 `../../.speculo/.config/` 下对应文件;`RULES.md` 的约束高于普通 workflow 文案。
23
- 5. 需要理解状态骨架、archive 或 `.config` 时,读取 `../../.speculo/AGENTS.md` 和相关子目录的 `AGENTS.md`。
24
-
25
- ## 入口别名
26
-
27
- | 别名 | 入口 | 用途 |
28
- |------|------|------|
29
- | `person/M` | `M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md` | 以毛泽东方法论为底座的认知咨询:分析问题→制定战略→组织行动 |
30
-
31
- ## 进入协议
32
-
33
- 1. 若用户未指定 change,扫描 `speculo/.speculo/person-status.json` 和 `speculo/.speculo/person/*/.status.json`,列出 active changes。
34
- - **命名校验**:扫描时仅处理符合 `YYYY-MM-DD-<kebab-name>` 格式的目录。不符合的目录标记为 `malformed`,单独列出路径并提示用户修复或手动清理,不自动删除或重命名。
35
- 2. 若只有一个 active change,默认继续该 change;若有多个 active change,要求用户选择。
36
- 3. 若没有 active change,按用户意图创建新的 change 目录,**目录名必须为 `YYYY-MM-DD-<kebab-name>`**(使用当前日期,`<kebab-name>` 从用户意图提取),并初始化 `.status.json` 与 `speculo/.speculo/person-status.json`。
37
- 4. 推荐入口时优先使用用户显式别名;没有别名时按用户意图推荐一个横向 workflow。
38
- 5. 执行任何 workflow 前,读取该 workflow 入口文件、阶段文件和模板。
39
- 6. 执行中一旦需要项目规则、经验、上下文、术语或 ADR,先读取 `../../.speculo/.config/`,再继续判断或写入产物;除非用户明确要求或规则允许,不自动改写 `.config/`。
40
-
41
- ## 执行模式
42
-
43
- - `mao`:以毛泽东方法论进行结构化认知咨询——分析问题、制定战略、组织行动,进入 `person/M`。
44
-
45
- ## 状态汇报
46
-
47
- 输出 person 状态时至少包含:
48
-
49
- - active change 数量与每个 change 的 `current_phase`
50
- - malformed 目录清单(不符合 `YYYY-MM-DD-<kebab-name>` 格式的目录)
51
- - 每个 change 的当前文档路径、素材路径和最近写入时间
52
- - `phase_history` 最后一项为 `blocked` 或 `updated_at` 超过 14 天未变化的 change
53
- - 推荐下一步入口和原因
54
-
55
- ## 完成与状态更新
56
-
57
- - 所有 person workflow 必须维护同一 change 的 `.status.json`。
58
- - 进入 phase 时更新 `current_phase`,并在 `phase_history` 追加 `in-progress` 记录。
59
- - phase 完成时写入 `completed_at` 和 `status: completed`。
60
- - 用户确认咨询输出或分析边界完成后,才把 `change_status` 置为 `completed`。