@namewta/speculo 0.2.1 → 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 (56) 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/commands/docs-sync.md +1 -1
  5. package/template/commands/knowledge-prune.md +1 -1
  6. package/template/commands/retro.md +1 -1
  7. package/template/skills/docs-sync/assets/report-template.md +1 -1
  8. package/template/skills/docs-sync/references/workflow-scope-contract.md +2 -2
  9. package/template/skills/knowledge-prune/SKILL.md +1 -1
  10. package/template/skills/knowledge-prune/references/audit-rules.md +1 -1
  11. package/template/skills/runtime-context/SKILL.md +3 -3
  12. package/template/skills/runtime-context/references/path-resolution.md +2 -2
  13. package/template/skills/speculo-retro/SKILL.md +1 -1
  14. package/template/workflows/matt-pocock/PERSISTENCE.md +80 -0
  15. package/template/workflows/matt-pocock/WORKFLOW.md +62 -115
  16. package/template/workflows/matt-pocock/atomic-skills/ask-matt.md +21 -0
  17. package/template/workflows/matt-pocock/atomic-skills/claude-handoff.md +21 -0
  18. package/template/workflows/matt-pocock/atomic-skills/code-review.md +21 -0
  19. package/template/workflows/matt-pocock/atomic-skills/codebase-design.md +21 -0
  20. package/template/workflows/matt-pocock/atomic-skills/diagnosing-bugs.md +21 -0
  21. package/template/workflows/matt-pocock/atomic-skills/domain-modeling.md +21 -0
  22. package/template/workflows/matt-pocock/atomic-skills/grill-me.md +21 -0
  23. package/template/workflows/matt-pocock/atomic-skills/grill-with-docs.md +21 -0
  24. package/template/workflows/matt-pocock/atomic-skills/grilling.md +21 -0
  25. package/template/workflows/matt-pocock/atomic-skills/handoff.md +21 -0
  26. package/template/workflows/matt-pocock/atomic-skills/implement.md +21 -0
  27. package/template/workflows/matt-pocock/atomic-skills/improve-codebase-architecture.md +21 -0
  28. package/template/workflows/matt-pocock/atomic-skills/loop-me.md +21 -0
  29. package/template/workflows/matt-pocock/atomic-skills/prototype.md +21 -0
  30. package/template/workflows/matt-pocock/atomic-skills/research.md +21 -0
  31. package/template/workflows/matt-pocock/atomic-skills/resolving-merge-conflicts.md +21 -0
  32. package/template/workflows/matt-pocock/atomic-skills/setup-matt-pocock-skills.md +21 -0
  33. package/template/workflows/matt-pocock/atomic-skills/tdd.md +21 -0
  34. package/template/workflows/matt-pocock/atomic-skills/teach.md +21 -0
  35. package/template/workflows/matt-pocock/atomic-skills/to-spec.md +21 -0
  36. package/template/workflows/matt-pocock/atomic-skills/to-tickets.md +21 -0
  37. package/template/workflows/matt-pocock/atomic-skills/triage.md +21 -0
  38. package/template/workflows/matt-pocock/atomic-skills/wayfinder.md +21 -0
  39. package/template/workflows/matt-pocock/atomic-skills/wizard.md +21 -0
  40. package/template/workflows/matt-pocock/atomic-skills/writing-beats.md +21 -0
  41. package/template/workflows/matt-pocock/atomic-skills/writing-fragments.md +21 -0
  42. package/template/workflows/matt-pocock/atomic-skills/writing-great-skills.md +21 -0
  43. package/template/workflows/matt-pocock/atomic-skills/writing-shape.md +20 -0
  44. package/template/workflows/matt-pocock/routes/architecture.md +4 -4
  45. package/template/workflows/matt-pocock/routes/diagnose.md +1 -1
  46. package/template/workflows/matt-pocock/routes/experimental.md +6 -6
  47. package/template/workflows/matt-pocock/routes/idea-to-delivery.md +11 -11
  48. package/template/workflows/matt-pocock/routes/merge-conflicts.md +1 -1
  49. package/template/workflows/matt-pocock/routes/productivity.md +3 -3
  50. package/template/workflows/matt-pocock/routes/research-prototype.md +2 -2
  51. package/template/workflows/matt-pocock/routes/review.md +1 -1
  52. package/template/workflows/matt-pocock/routes/setup.md +1 -1
  53. package/template/workflows/matt-pocock/routes/triage.md +3 -3
  54. package/template/workflows/matt-pocock/routes/wayfinder.md +3 -3
  55. package/template/workflows/person/PERSISTENCE.md +56 -0
  56. package/template/workflows/person/WORKFLOW.md +9 -27
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: domain-modeling
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Domain Modeling
6
+ description: 精炼领域词汇、上下文和架构决策。
7
+ stability: stable
8
+ invocation: model-allowed
9
+ ---
10
+
11
+ # Domain Modeling
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 与 knowledge namespace 已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="adapted" /><completion>术语与决策先在 change 中形成,确认后的长期路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: grill-me
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Grill Me
6
+ description: 通过逐问访谈打磨计划或设计。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Grill Me
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="productivity/grill-me/SKILL.md" activation="adapted" /><completion>访谈已收敛或明确 blocked,记录路径已写入 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: grill-with-docs
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Grill With Docs
6
+ description: 在代码仓中访谈并同步领域语言与决策。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Grill With Docs
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 与 knowledge namespace 已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/grill-with-docs/SKILL.md" activation="adapted" /><completion>访谈与确认后的知识路径已记录到 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: grilling
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Grilling
6
+ description: 复用逐问访谈循环直至关键分支清晰。
7
+ stability: stable
8
+ invocation: model-allowed
9
+ ---
10
+
11
+ # Grilling
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="productivity/grilling/SKILL.md" activation="adapted" /><completion>访谈决策已返回,记录路径已写入 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: handoff
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Handoff
6
+ description: 为另一个 agent 或会话保存脱敏交接文档。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Handoff
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 已替代 raw 临时目录作为持久化边界。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/handoff/SKILL.md" activation="adapted" /><completion>脱敏交接文档路径已记录到 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: implement
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Implement
6
+ description: 基于既有 spec 或 tickets 实现并验证工作。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Implement
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="engineering/implement/SKILL.md" activation="adapted" /><completion>实现与验证结果已返回;项目变更和运行记录各自位于正确边界。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: improve-codebase-architecture
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Improve Codebase Architecture
6
+ description: 扫描代码仓并呈现架构深化机会。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Improve Codebase Architecture
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 已替代 raw 系统临时目录作为报告边界。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/improve-codebase-architecture/SKILL.md" activation="adapted" /><completion>报告与选择结果已返回,实际路径已记录到 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: loop-me
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Loop Me
6
+ description: 通过有状态访谈形成可实施的工作流规格。
7
+ stability: experimental
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Loop Me
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/loop-me/SKILL.md" activation="adapted" /><completion>工作流规格路径已记录到 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: prototype
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Prototype
6
+ description: 用一次性逻辑或 UI 原型回答单个设计问题。
7
+ stability: stable
8
+ invocation: model-allowed
9
+ ---
10
+
11
+ # Prototype
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="engineering/prototype/SKILL.md" activation="adapted" /><completion>原型结论已保留,临时代码已删除或吸收,路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: research
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Research
6
+ description: 以一手来源调查问题并形成带引用结论。
7
+ stability: stable
8
+ invocation: model-allowed
9
+ ---
10
+
11
+ # Research
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="engineering/research/SKILL.md" activation="adapted" /><completion>研究结论与来源已返回,实际文件路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: resolving-merge-conflicts
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Resolving Merge Conflicts
6
+ description: 查明双方意图并解决进行中的 merge 或 rebase 冲突。
7
+ stability: stable
8
+ invocation: model-allowed
9
+ ---
10
+
11
+ # Resolving Merge Conflicts
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 与继续 merge/rebase 的确认边界已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/resolving-merge-conflicts/SKILL.md" activation="adapted" /><completion>冲突结果与验证证据已记录;继续或提交仅在确认后执行。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: setup-matt-pocock-skills
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Setup Matt Pocock Skills
6
+ description: 配置 tracker、triage 标签和领域知识布局。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Setup Matt Pocock 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、integrations 与 knowledge namespaces 已解析。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/SKILL.md" activation="adapted" /><completion>确认后的配置写入声明 namespace,实际路径已记录。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: tdd
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: TDD
6
+ description: 以红绿重构循环构建一个垂直切片。
7
+ stability: stable
8
+ invocation: model-allowed
9
+ ---
10
+
11
+ # TDD
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="engineering/tdd/SKILL.md" activation="adapted" /><completion>红绿重构证据已返回,实际记录路径已写入 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -0,0 +1,21 @@
1
+ ---
2
+ id: teach
3
+ type: atomic-skill
4
+ workflow: matt-pocock
5
+ name: Teach
6
+ description: 在持久化教学工作区中跨会话教授主题。
7
+ stability: stable
8
+ invocation: user-only
9
+ ---
10
+
11
+ # Teach
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 已替代 raw 当前目录作为教学工作区。</completion></phase>
18
+ <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/teach/SKILL.md" activation="adapted" /><completion>教学状态与课程产物路径已记录到 skill history。</completion></phase>
19
+ </sequence>
20
+ ```
21
+
@@ -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>