@namewta/speculo 0.2.0 → 0.2.2

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 (64) hide show
  1. package/README.md +7 -5
  2. package/package.json +1 -1
  3. package/template/.speculo/README.md +3 -3
  4. package/template/.speculo/workspace.json +1 -0
  5. package/template/commands/docs-sync.md +2 -2
  6. package/template/commands/finalize.md +1 -1
  7. package/template/commands/knowledge-prune.md +1 -1
  8. package/template/commands/retro.md +1 -1
  9. package/template/commands/status.md +6 -5
  10. package/template/config.json +11 -0
  11. package/template/skills/change-lifecycle/references/finalize-archive.md +1 -1
  12. package/template/skills/docs-sync/assets/report-template.md +1 -1
  13. package/template/skills/docs-sync/references/workflow-scope-contract.md +2 -2
  14. package/template/skills/knowledge-prune/SKILL.md +1 -1
  15. package/template/skills/knowledge-prune/references/audit-rules.md +1 -1
  16. package/template/skills/runtime-context/SKILL.md +18 -7
  17. package/template/skills/runtime-context/references/path-resolution.md +11 -2
  18. package/template/skills/speculo-retro/SKILL.md +1 -1
  19. package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/HTML-REPORT.md +3 -1
  20. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/SKILL.md +29 -0
  21. package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/domain.md +22 -33
  22. package/template/workflows/matt-pocock/PERSISTENCE.md +80 -0
  23. package/template/workflows/matt-pocock/WORKFLOW.md +60 -102
  24. package/template/workflows/matt-pocock/atomic-skills/ask-matt.md +21 -0
  25. package/template/workflows/matt-pocock/atomic-skills/claude-handoff.md +21 -0
  26. package/template/workflows/matt-pocock/atomic-skills/code-review.md +21 -0
  27. package/template/workflows/matt-pocock/atomic-skills/codebase-design.md +21 -0
  28. package/template/workflows/matt-pocock/atomic-skills/diagnosing-bugs.md +21 -0
  29. package/template/workflows/matt-pocock/atomic-skills/domain-modeling.md +21 -0
  30. package/template/workflows/matt-pocock/atomic-skills/grill-me.md +21 -0
  31. package/template/workflows/matt-pocock/atomic-skills/grill-with-docs.md +21 -0
  32. package/template/workflows/matt-pocock/atomic-skills/grilling.md +21 -0
  33. package/template/workflows/matt-pocock/atomic-skills/handoff.md +21 -0
  34. package/template/workflows/matt-pocock/atomic-skills/implement.md +21 -0
  35. package/template/workflows/matt-pocock/atomic-skills/improve-codebase-architecture.md +21 -0
  36. package/template/workflows/matt-pocock/atomic-skills/loop-me.md +21 -0
  37. package/template/workflows/matt-pocock/atomic-skills/prototype.md +21 -0
  38. package/template/workflows/matt-pocock/atomic-skills/research.md +21 -0
  39. package/template/workflows/matt-pocock/atomic-skills/resolving-merge-conflicts.md +21 -0
  40. package/template/workflows/matt-pocock/atomic-skills/setup-matt-pocock-skills.md +21 -0
  41. package/template/workflows/matt-pocock/atomic-skills/tdd.md +21 -0
  42. package/template/workflows/matt-pocock/atomic-skills/teach.md +21 -0
  43. package/template/workflows/matt-pocock/atomic-skills/to-spec.md +21 -0
  44. package/template/workflows/matt-pocock/atomic-skills/to-tickets.md +21 -0
  45. package/template/workflows/matt-pocock/atomic-skills/triage.md +21 -0
  46. package/template/workflows/matt-pocock/atomic-skills/wayfinder.md +21 -0
  47. package/template/workflows/matt-pocock/atomic-skills/wizard.md +21 -0
  48. package/template/workflows/matt-pocock/atomic-skills/writing-beats.md +21 -0
  49. package/template/workflows/matt-pocock/atomic-skills/writing-fragments.md +21 -0
  50. package/template/workflows/matt-pocock/atomic-skills/writing-great-skills.md +21 -0
  51. package/template/workflows/matt-pocock/atomic-skills/writing-shape.md +20 -0
  52. package/template/workflows/matt-pocock/routes/architecture.md +4 -4
  53. package/template/workflows/matt-pocock/routes/diagnose.md +1 -1
  54. package/template/workflows/matt-pocock/routes/experimental.md +6 -6
  55. package/template/workflows/matt-pocock/routes/idea-to-delivery.md +11 -11
  56. package/template/workflows/matt-pocock/routes/merge-conflicts.md +1 -1
  57. package/template/workflows/matt-pocock/routes/productivity.md +3 -3
  58. package/template/workflows/matt-pocock/routes/research-prototype.md +2 -2
  59. package/template/workflows/matt-pocock/routes/review.md +1 -1
  60. package/template/workflows/matt-pocock/routes/setup.md +1 -1
  61. package/template/workflows/matt-pocock/routes/triage.md +3 -3
  62. package/template/workflows/matt-pocock/routes/wayfinder.md +3 -3
  63. package/template/workflows/person/PERSISTENCE.md +56 -0
  64. package/template/workflows/person/WORKFLOW.md +9 -27
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: to-spec
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: To Spec
6
+ description: 将既有讨论综合为可交付 spec。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # To Spec
12
+
13
+ 直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 tracker 外发确认边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/to-spec/SKILL.md" activation="adapted" /><completion>spec 先在 change 中形成;外发结果与路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: to-tickets
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: To Tickets
6
+ description: 将计划或 spec 拆分为带阻塞边的 tickets。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # To Tickets
12
+
13
+ 直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 tracker 外发确认边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/to-tickets/SKILL.md" activation="adapted" /><completion>tickets 先在 change 中形成;外发结果与路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: triage
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Triage
6
+ description: 将 issues 或外部 PR 移过 triage 状态机。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Triage
12
+
13
+ 直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、policy 与外部动作确认边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/triage/SKILL.md" activation="adapted" /><completion>建议先本地记录;确认后的外部结果与路径已写回。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: wayfinder
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Wayfinder
6
+ description: 为大型模糊目标建立并遍历调查地图。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Wayfinder
12
+
13
+ 直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 tracker 外部动作边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/wayfinder/SKILL.md" activation="adapted" /><completion>地图与前沿先本地记录;确认后的 tracker 结果已写回。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: wizard
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Wizard
6
+ description: 生成用于人工设置或迁移的交互式 bash 向导。
7
+ stability: experimental
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Wizard
12
+
13
+ 本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、secret 与外部动作确认边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/wizard/SKILL.md" activation="adapted" /><completion>脚本已静态验证;临时/项目归属与外部写入结果已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: writing-beats
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Writing Beats
6
+ description: 从素材堆逐节拍组装文章旅程。
7
+ stability: experimental
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Writing Beats
12
+
13
+ 本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 或用户明确项目目标已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/writing-beats/SKILL.md" activation="adapted" /><completion>文章与素材路径已记录,用户编辑得到保留。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: writing-fragments
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Writing Fragments
6
+ description: 通过访谈探索并追加写作碎片。
7
+ stability: experimental
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Writing Fragments
12
+
13
+ 本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 或用户明确项目目标已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/writing-fragments/SKILL.md" activation="adapted" /><completion>碎片文档路径已记录,用户编辑得到保留。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: writing-great-skills
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Writing Great Skills
6
+ description: 使用可预测性模型设计或审查 skill。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Writing Great Skills
12
+
13
+ 直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与项目 skill 产物边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/writing-great-skills/SKILL.md" activation="adapted" /><completion>skill 审计结论与实际修改/报告路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,20 @@
1
+ ---
2
+ id: writing-shape
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Writing Shape
6
+ description: 将素材堆逐段塑造成独立文章。
7
+ stability: experimental
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Writing Shape
12
+
13
+ 本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
14
+
15
+ ```xml
16
+ <sequence>
17
+ <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 或用户明确项目目标已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/writing-shape/SKILL.md" activation="adapted" /><completion>文章路径已记录,素材与用户编辑得到保留。</completion></phase>
19
+ </sequence>
20
+ ```
@@ -5,14 +5,14 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="scan" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/improve-codebase-architecture/SKILL.md" activation="adapted" />
9
- <skill root="vendor:matt-pocock" path="engineering/codebase-design/SKILL.md" activation="required" />
8
+ <instructions root="workflow" path="atomic-skills/improve-codebase-architecture.md" activation="adapted" />
9
+ <instructions root="workflow" path="atomic-skills/codebase-design.md" activation="required" />
10
10
  <artifact root="change" path="architecture/candidates.html" />
11
11
  <completion>报告写入当前 change 而非系统临时目录,候选使用统一设计词汇。</completion>
12
12
  </phase>
13
13
  <phase id="select-grill" order="2">
14
- <skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="required" />
15
- <skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="required" />
14
+ <instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
15
+ <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="required" />
16
16
  <artifact root="change" path="architecture/design.md" />
17
17
  <completion>用户选择的候选已遍历设计树,拒绝理由和 ADR 候选已确认。</completion>
18
18
  </phase>
@@ -5,7 +5,7 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="feedback-loop" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/diagnosing-bugs/SKILL.md" activation="required" />
8
+ <instructions root="workflow" path="atomic-skills/diagnosing-bugs.md" activation="required" />
9
9
  <artifact root="change" path="diagnosis/feedback-loop.md" />
10
10
  <completion>存在一条已运行、能对当前症状变红、快速且确定的命令;否则 blocked。</completion>
11
11
  </phase>
@@ -6,12 +6,12 @@
6
6
 
7
7
  ```xml
8
8
  <routes>
9
- <route id="loop-me" order="1" root="vendor:matt-pocock" path="in-progress/loop-me/SKILL.md" />
10
- <route id="wizard" order="2" root="vendor:matt-pocock" path="in-progress/wizard/SKILL.md" />
11
- <route id="claude-handoff" order="3" root="vendor:matt-pocock" path="in-progress/claude-handoff/SKILL.md" />
12
- <route id="writing-fragments" order="4" root="vendor:matt-pocock" path="in-progress/writing-fragments/SKILL.md" />
13
- <route id="writing-beats" order="5" root="vendor:matt-pocock" path="in-progress/writing-beats/SKILL.md" />
14
- <route id="writing-shape" order="6" root="vendor:matt-pocock" path="in-progress/writing-shape/SKILL.md" />
9
+ <route id="loop-me" order="1" root="workflow" path="atomic-skills/loop-me.md" />
10
+ <route id="wizard" order="2" root="workflow" path="atomic-skills/wizard.md" />
11
+ <route id="claude-handoff" order="3" root="workflow" path="atomic-skills/claude-handoff.md" />
12
+ <route id="writing-fragments" order="4" root="workflow" path="atomic-skills/writing-fragments.md" />
13
+ <route id="writing-beats" order="5" root="workflow" path="atomic-skills/writing-beats.md" />
14
+ <route id="writing-shape" order="6" root="workflow" path="atomic-skills/writing-shape.md" />
15
15
  </routes>
16
16
  ```
17
17
 
@@ -5,16 +5,16 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="grill" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/grill-with-docs/SKILL.md" activation="conditional">
8
+ <instructions root="workflow" path="atomic-skills/grill-with-docs.md" activation="conditional">
9
9
  <when>当前任务位于已有代码仓,需要同步领域语言与 ADR 候选。</when>
10
- </skill>
11
- <skill root="vendor:matt-pocock" path="productivity/grill-me/SKILL.md" activation="conditional">
10
+ </instructions>
11
+ <instructions root="workflow" path="atomic-skills/grill-me.md" activation="conditional">
12
12
  <when>用户显式要求 grill-me,或计划/设计不依赖现有代码仓。</when>
13
- </skill>
14
- <skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="required" />
15
- <skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="conditional">
13
+ </instructions>
14
+ <instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
15
+ <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="conditional">
16
16
  <when>存在代码仓并需要沉淀领域语言或 ADR 候选。</when>
17
- </skill>
17
+ </instructions>
18
18
  <artifact root="change" path="decision-log.md" />
19
19
  <completion>一次只确认一个决策;所有关键分支均已清晰且用户确认达成共识后,才允许形成 Plan 或进入 spec。CONTEXT/ADR 仅在确认后写入 knowledge namespace。</completion>
20
20
  </phase>
@@ -24,19 +24,19 @@
24
24
  <completion>答案与来源已回填 decision-log,临时代码已删除。</completion>
25
25
  </phase>
26
26
  <phase id="spec" order="3">
27
- <skill root="vendor:matt-pocock" path="engineering/to-spec/SKILL.md" activation="adapted" />
27
+ <instructions root="workflow" path="atomic-skills/to-spec.md" activation="adapted" />
28
28
  <artifact root="change" path="spec/spec.md" />
29
29
  <completion>spec 先本地落盘;外发 tracker 需要单独确认。</completion>
30
30
  </phase>
31
31
  <phase id="tickets" order="4">
32
32
  <when>工作跨多个上下文窗口。</when>
33
- <skill root="vendor:matt-pocock" path="engineering/to-tickets/SKILL.md" activation="adapted" />
33
+ <instructions root="workflow" path="atomic-skills/to-tickets.md" activation="adapted" />
34
34
  <artifact root="change" path="tracker/tickets.md" />
35
35
  <completion>垂直切片与阻塞边已获用户批准,外发引用已回写。</completion>
36
36
  </phase>
37
37
  <phase id="implement" order="5">
38
- <skill root="vendor:matt-pocock" path="engineering/implement/SKILL.md" activation="adapted" />
39
- <skill root="vendor:matt-pocock" path="engineering/tdd/SKILL.md" activation="required" />
38
+ <instructions root="workflow" path="atomic-skills/implement.md" activation="adapted" />
39
+ <instructions root="workflow" path="atomic-skills/tdd.md" activation="required" />
40
40
  <artifact root="change" path="implementation/log.md" />
41
41
  <completion>每个切片已验证;commit 仅在用户确认后执行。</completion>
42
42
  </phase>
@@ -5,7 +5,7 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="inspect-intent" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/resolving-merge-conflicts/SKILL.md" activation="required" />
8
+ <instructions root="workflow" path="atomic-skills/resolving-merge-conflicts.md" activation="required" />
9
9
  <artifact root="change" path="merge-conflicts/record.md" />
10
10
  <completion>每个冲突双方的一手意图已查明。</completion>
11
11
  </phase>
@@ -5,17 +5,17 @@
5
5
  ```xml
6
6
  <routes>
7
7
  <route id="handoff" order="1">
8
- <skill root="vendor:matt-pocock" path="productivity/handoff/SKILL.md" activation="adapted" />
8
+ <instructions root="workflow" path="atomic-skills/handoff.md" activation="adapted" />
9
9
  <artifact root="change" path="handoffs/{topic}.md" />
10
10
  <when>需要跨会话或分叉上下文。</when>
11
11
  </route>
12
12
  <route id="teach" order="2">
13
- <skill root="vendor:matt-pocock" path="productivity/teach/SKILL.md" activation="adapted" />
13
+ <instructions root="workflow" path="atomic-skills/teach.md" activation="adapted" />
14
14
  <artifact root="change" path="teaching/" />
15
15
  <when>用户要跨会话学习主题。</when>
16
16
  </route>
17
17
  <route id="writing-great-skills" order="3">
18
- <skill root="vendor:matt-pocock" path="productivity/writing-great-skills/SKILL.md" activation="required" />
18
+ <instructions root="workflow" path="atomic-skills/writing-great-skills.md" activation="required" />
19
19
  <artifact root="change" path="skill-authoring/report.md" />
20
20
  <when>用户要设计或审查 skill。</when>
21
21
  </route>
@@ -6,13 +6,13 @@
6
6
  <sequence>
7
7
  <phase id="research" order="1">
8
8
  <when>答案需要当前仓库之外的一手来源。</when>
9
- <skill root="vendor:matt-pocock" path="engineering/research/SKILL.md" activation="conditional" />
9
+ <instructions root="workflow" path="atomic-skills/research.md" activation="conditional" />
10
10
  <artifact root="change" path="research/{topic}.md" />
11
11
  <completion>每项结论有一手来源,文件留在当前 change。</completion>
12
12
  </phase>
13
13
  <phase id="prototype" order="2">
14
14
  <when>状态、逻辑或 UI 需要可运行答案。</when>
15
- <skill root="vendor:matt-pocock" path="engineering/prototype/SKILL.md" activation="conditional" />
15
+ <instructions root="workflow" path="atomic-skills/prototype.md" activation="conditional" />
16
16
  <artifact root="change" path="prototypes/{topic}/answer.md" />
17
17
  <completion>答案已保留;一次性代码、数据库和路由已删除或明确吸收进实现。</completion>
18
18
  </phase>
@@ -5,7 +5,7 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="fixed-point" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/code-review/SKILL.md" activation="required" />
8
+ <instructions root="workflow" path="atomic-skills/code-review.md" activation="required" />
9
9
  <completion>固定点可解析、diff 非空、规范与标准来源已记录。</completion>
10
10
  </phase>
11
11
  <phase id="parallel-axes" order="2">
@@ -7,7 +7,7 @@
7
7
  ```xml
8
8
  <sequence>
9
9
  <phase id="discover-config" order="1">
10
- <skill root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/SKILL.md" activation="adapted" />
10
+ <instructions root="workflow" path="atomic-skills/setup-matt-pocock-skills.md" activation="adapted" />
11
11
  <completion>已展示仓库、tracker 和领域文档现状。</completion>
12
12
  </phase>
13
13
  <phase id="configure-tracker" order="2">
@@ -5,7 +5,7 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="collect" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/triage/SKILL.md" activation="adapted" />
8
+ <instructions root="workflow" path="atomic-skills/triage.md" activation="adapted" />
9
9
  <artifact root="change" path="triage/{item}/record.md" />
10
10
  <completion>完整正文、评论、标签、diff、冗余性与私有 out-of-scope 已检查。</completion>
11
11
  </phase>
@@ -14,8 +14,8 @@
14
14
  </phase>
15
15
  <phase id="validate-grill" order="3">
16
16
  <when>声明需要复现或需求仍不完整。</when>
17
- <skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="conditional" />
18
- <skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="conditional" />
17
+ <instructions root="workflow" path="atomic-skills/grilling.md" activation="conditional" />
18
+ <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="conditional" />
19
19
  <completion>事实已验证,问题逐个解决。</completion>
20
20
  </phase>
21
21
  <phase id="apply" order="4">
@@ -5,9 +5,9 @@
5
5
  ```xml
6
6
  <sequence>
7
7
  <phase id="name-destination" order="1">
8
- <skill root="vendor:matt-pocock" path="engineering/wayfinder/SKILL.md" activation="required" />
9
- <skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="required" />
10
- <skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="required" />
8
+ <instructions root="workflow" path="atomic-skills/wayfinder.md" activation="required" />
9
+ <instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
10
+ <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="required" />
11
11
  <completion>目的地与范围边界已确认。</completion>
12
12
  </phase>
13
13
  <phase id="map-frontier" order="2">
@@ -0,0 +1,56 @@
1
+ # Person Persistence
2
+
3
+ 本文件是 `person` 的唯一运行契约。`WORKFLOW.md` 只能引用本文件,不得复制 runtime roots、store、change 启动或副作用规则。进入 person workflow 时先读取项目根 `speculo/.speculo/workspace.json`,再执行本文件。
4
+
5
+ ## 运行时根
6
+
7
+ ```xml
8
+ <runtime-context>
9
+ <root id="workflow" base="workflows" path="person" />
10
+ <root id="state" base="state" path="person" />
11
+ </runtime-context>
12
+ ```
13
+
14
+ ## 持久化命名空间
15
+
16
+ ```xml
17
+ <persistence root="state">
18
+ <store id="index" role="index" kind="file" path="status.json" create="initialize" />
19
+ <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
20
+ <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
21
+ <store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
22
+ </persistence>
23
+ ```
24
+
25
+ ## 启动协议
26
+
27
+ ```xml
28
+ <sequence>
29
+ <phase id="resolve-runtime" order="1">
30
+ <skill root="skills" path="runtime-context/SKILL.md" activation="required" />
31
+ <completion>workspace、config 与 workflow/state roots 均已解析并通过边界检查;同一运行已解析时复用结果。</completion>
32
+ </phase>
33
+ <phase id="select-change" order="2">
34
+ <artifact root="state" path="status.json" />
35
+ <completion>已选择用户指定或唯一 active change;没有 active change 时原子创建 `changes/YYYY-MM-DD-&lt;kebab-topic&gt;/.status.json` 并更新索引;多个候选时先消歧。</completion>
36
+ </phase>
37
+ </sequence>
38
+ ```
39
+
40
+ 创建 change 时初始化 schema version 1、workflow/name/timestamps、`change_status: active`、空的 `route_history`。已有 change 缺少数组时按空数组读取,在下一次真实更新时补齐,不要求迁移。
41
+
42
+ ## 状态字段
43
+
44
+ ```xml
45
+ <state-schema>
46
+ <field name="current_route" type="string|null" />
47
+ <field name="route_history" type="array" />
48
+ </state-schema>
49
+ ```
50
+
51
+ ## 路径与副作用
52
+
53
+ - route 产物只写当前 change;已声明 knowledge store 只接收 workflow 确认的长期内容。
54
+ - 用户要求的项目产物不是 Speculo 运行状态;保存项目相对指针,不把派生绝对路径写入状态。
55
+ - 发布、提交、移动或删除外部/项目资源前展示动作并取得明确确认。
56
+
@@ -3,32 +3,23 @@ id: person
3
3
  type: workflow
4
4
  workflow: person
5
5
  name: Person Workflow
6
- description: 以人物方法论为底座的显式激活型咨询 workflow
6
+ description: 以人物方法论为底座并共享独立持久化契约的咨询 workflow
7
7
  keywords: [person, methodology, consulting, 人物, 方法论]
8
8
  ---
9
9
 
10
10
  # Person Workflow
11
11
 
12
- 先读取项目根 `speculo/.speculo/workspace.json`,再解析以下 workflow/state 根。进入时读取 `status.json`,选择唯一 active change;没有 active change 时原子创建 `changes/<YYYY-MM-DD-name>/.status.json` 并追加索引。
12
+ 先读取 [PERSISTENCE.md](./PERSISTENCE.md)。该文件是 runtime roots、store、change 启动和副作用边界的唯一来源;本入口只负责选择人物方法论 route。
13
13
 
14
- ## 运行时根
14
+ ## 进入协议
15
15
 
16
16
  ```xml
17
- <runtime-context>
18
- <root id="workflow" base="workflows" path="person" />
19
- <root id="state" base="state" path="person" />
20
- </runtime-context>
21
- ```
22
-
23
- ## 持久化命名空间
24
-
25
- ```xml
26
- <persistence root="state">
27
- <store id="index" role="index" kind="file" path="status.json" create="initialize" />
28
- <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
29
- <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
30
- <store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
31
- </persistence>
17
+ <sequence>
18
+ <phase id="load-persistence" order="1">
19
+ <instructions root="workflow" path="PERSISTENCE.md" activation="required" />
20
+ <completion>runtime context 与 current change 已按唯一持久化契约解析。</completion>
21
+ </phase>
22
+ </sequence>
32
23
  ```
33
24
 
34
25
  ## 路由
@@ -47,15 +38,6 @@ keywords: [person, methodology, consulting, 人物, 方法论]
47
38
  <dependencies />
48
39
  ```
49
40
 
50
- ## 状态扩展字段
51
-
52
- ```xml
53
- <state-schema>
54
- <field name="current_route" type="string" />
55
- <field name="route_history" type="array" />
56
- </state-schema>
57
- ```
58
-
59
41
  ## 状态转移
60
42
 
61
43
  ```xml