@namewta/speculo 0.2.0 → 0.2.2

package/template/workflows/matt-pocock/WORKFLOW.md

@@ -3,92 +3,25 @@ id: matt-pocock
 type: workflow
 workflow: matt-pocock
 name: Matt Pocock Workflow
-description: 以路由优先方式组合原生 Matt Pocock skills，并在 Speculo 私有状态根内持久化
+description: 以路由和原子入口组合 Matt Pocock skills，并共享同一持久化契约
 keywords: [matt-pocock, engineering, productivity, grilling, tdd, review]
 ---
 
 # Matt Pocock Workflow
 
-先读取项目根 `speculo/.speculo/workspace.json`，再激活本 workflow。所有状态位于 `state` 根绑定的 `matt-pocock` 子树；所有 route 只按命中分支物理渐进披露。
-
-直接运行 vendor raw skill 不继承本 workflow 的路径上下文和持久化保证。
-
-## 运行时根
-
-```xml
-<runtime-context>
-  <root id="workflow" base="workflows" path="matt-pocock" />
-  <root id="state" base="state" path="matt-pocock" />
-  <root id="vendor:matt-pocock" base="vendor" path="matt-pocock" />
-</runtime-context>
-```
-
-## 持久化命名空间
-
-```xml
-<persistence root="state">
-  <store id="index" role="index" kind="file" path="status.json" create="initialize" />
-  <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
-  <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
-  <store id="knowledge" role="knowledge" kind="directory" path="knowledge" create="lazy" consumers="docs-sync,retro,knowledge-prune" />
-  <store id="policy" role="policy" kind="directory" path="policy" create="lazy" consumers="docs-sync,knowledge-prune" />
-  <store id="integrations" role="integration" kind="directory" path="integrations" create="lazy" />
-  <store id="backlog" role="backlog" kind="directory" path="backlog" create="lazy" consumers="retro" />
-  <store id="legacy-config" role="legacy-knowledge" kind="directory" path=".config" create="existing-only" legacy="true" consumers="docs-sync,retro,knowledge-prune" />
-</persistence>
-```
-
-`status.json`、`changes/` 和 `archive/` 是 workflow 固定骨架；其余 store 只在 route 产生对应内容时创建。已有 `.config/` 只作为兼容来源读取，不作为新内容默认写入位置。
-
-## 路由
-
-```xml
-<routes>
-  <route id="idea-to-delivery" order="1" root="workflow" path="routes/idea-to-delivery.md">
-    <when>用户要把想法、需求或明确任务推进为规范、实现和交付。</when>
-  </route>
-  <route id="wayfinder" order="2" root="workflow" path="routes/wayfinder.md">
-    <when>目标庞大且跨多个上下文窗口，通往终点的决策路径仍不可见。</when>
-  </route>
-  <route id="triage" order="3" root="workflow" path="routes/triage.md">
-    <when>需要分类收到的 issue 或外部 PR/MR。</when>
-  </route>
-  <route id="diagnose" order="4" root="workflow" path="routes/diagnose.md">
-    <when>存在疑难 bug、异常、失败或性能回退。</when>
-  </route>
-  <route id="architecture" order="5" root="workflow" path="routes/architecture.md">
-    <when>需要扫描或讨论代码仓深化机会。</when>
-  </route>
-  <route id="review" order="6" root="workflow" path="routes/review.md">
-    <when>需要从固定点审查 diff 或作为实现收尾。</when>
-  </route>
-  <route id="merge-conflicts" order="7" root="workflow" path="routes/merge-conflicts.md">
-    <when>仓库正处于 merge 或 rebase 冲突中。</when>
-  </route>
-  <route id="research-prototype" order="8" root="workflow" path="routes/research-prototype.md">
-    <when>需要一手资料研究或一次性原型回答单个设计问题。</when>
-  </route>
-  <route id="productivity" order="9" root="workflow" path="routes/productivity.md">
-    <when>需要 handoff、教学或 skill 写作指导。</when>
-  </route>
-  <route id="experimental" order="10" root="workflow" path="routes/experimental.md">
-    <when>用户明确要求使用 vendor/in-progress 中的实验能力。</when>
-  </route>
-</routes>
-```
+先读取 [PERSISTENCE.md](./PERSISTENCE.md)。该文件是 runtime roots、store、change 启动和副作用边界的唯一来源；本入口只负责选择组合 route 或单个 atomic skill。
 
 ## 进入协议
 
 ```xml
 <sequence>
-  <phase id="select-change" order="1">
-    <skill root="skills" path="runtime-context/SKILL.md" activation="required" />
-    <artifact root="state" path="status.json" />
-    <completion>已选择唯一 active change，或原子创建新 change 与 .status.json。</completion>
+  <phase id="load-persistence" order="1">
+    <instructions root="workflow" path="PERSISTENCE.md" activation="required" />
+    <completion>runtime context 与 current change 已按唯一持久化契约解析。</completion>
   </phase>
   <phase id="route" order="2">
-    <skill root="vendor:matt-pocock" path="engineering/ask-matt/SKILL.md" activation="required" />
-    <completion>已根据用户意图选择一个 route；歧义时一次只澄清一个决策。</completion>
+    <instructions root="workflow" path="atomic-skills/ask-matt.md" activation="required" />
+    <completion>已根据用户意图选择一个组合 route 或 atomic skill；歧义时一次只澄清一个决策。</completion>
   </phase>
   <phase id="lazy-config" order="3">
     <instructions root="workflow" path="routes/setup.md" />
@@ -98,48 +31,73 @@ keywords: [matt-pocock, engineering, productivity, grilling, tdd, review]
 </sequence>
 ```
 
-## 依赖
+## 路由
 
 ```xml
-<dependencies>
-  <dependency kind="hard" root="vendor:matt-pocock" path="README.md">
-    选择本 workflow 时必须安装完整 matt-pocock vendor 目录。
-  </dependency>
-</dependencies>
+<routes>
+  <route id="idea-to-delivery" order="1" root="workflow" path="routes/idea-to-delivery.md"><when>用户要把想法、需求或明确任务推进为规范、实现和交付。</when></route>
+  <route id="wayfinder" order="2" root="workflow" path="routes/wayfinder.md"><when>目标庞大且跨多个上下文窗口，通往终点的决策路径仍不可见。</when></route>
+  <route id="triage" order="3" root="workflow" path="routes/triage.md"><when>需要分类收到的 issue 或外部 PR/MR。</when></route>
+  <route id="diagnose" order="4" root="workflow" path="routes/diagnose.md"><when>存在疑难 bug、异常、失败或性能回退。</when></route>
+  <route id="architecture" order="5" root="workflow" path="routes/architecture.md"><when>需要扫描或讨论代码仓深化机会。</when></route>
+  <route id="review" order="6" root="workflow" path="routes/review.md"><when>需要从固定点审查 diff 或作为实现收尾。</when></route>
+  <route id="merge-conflicts" order="7" root="workflow" path="routes/merge-conflicts.md"><when>仓库正处于 merge 或 rebase 冲突中。</when></route>
+  <route id="research-prototype" order="8" root="workflow" path="routes/research-prototype.md"><when>需要一手资料研究或一次性原型回答单个设计问题。</when></route>
+  <route id="productivity" order="9" root="workflow" path="routes/productivity.md"><when>需要 handoff、教学或 skill 写作指导。</when></route>
+  <route id="experimental" order="10" root="workflow" path="routes/experimental.md"><when>用户明确要求使用 vendor/in-progress 中的实验能力。</when></route>
+</routes>
 ```
 
-## 状态扩展字段
+## 原子能力
 
 ```xml
-<state-schema>
-  <field name="current_route" type="string" />
-  <field name="route_history" type="array" />
-  <field name="skill_history" type="array" />
-  <field name="external_refs" type="array" />
-  <field name="legacy_source" type="object|null" />
-</state-schema>
+<atomic-skills source-root="vendor:matt-pocock" coverage="complete">
+  <atomic-skill id="ask-matt" order="1" root="workflow" path="atomic-skills/ask-matt.md"><when>询问应使用哪种 skill 或 route。</when></atomic-skill>
+  <atomic-skill id="claude-handoff" order="2" root="workflow" path="atomic-skills/claude-handoff.md"><when>明确要求把会话交给 Claude 后台 agent。</when></atomic-skill>
+  <atomic-skill id="code-review" order="3" root="workflow" path="atomic-skills/code-review.md"><when>从固定点进行标准与规范双轴审查。</when></atomic-skill>
+  <atomic-skill id="codebase-design" order="4" root="workflow" path="atomic-skills/codebase-design.md"><when>设计深层模块、接口或 seam。</when></atomic-skill>
+  <atomic-skill id="diagnosing-bugs" order="5" root="workflow" path="atomic-skills/diagnosing-bugs.md"><when>以反馈循环诊断疑难 bug 或性能回退。</when></atomic-skill>
+  <atomic-skill id="domain-modeling" order="6" root="workflow" path="atomic-skills/domain-modeling.md"><when>精炼领域词汇、上下文或 ADR。</when></atomic-skill>
+  <atomic-skill id="grill-me" order="7" root="workflow" path="atomic-skills/grill-me.md"><when>用户明确要求对计划或设计进行访谈打磨。</when></atomic-skill>
+  <atomic-skill id="grill-with-docs" order="8" root="workflow" path="atomic-skills/grill-with-docs.md"><when>在已有代码仓中访谈并同步领域决策。</when></atomic-skill>
+  <atomic-skill id="grilling" order="9" root="workflow" path="atomic-skills/grilling.md"><when>其他能力需要复用逐问访谈循环。</when></atomic-skill>
+  <atomic-skill id="handoff" order="10" root="workflow" path="atomic-skills/handoff.md"><when>用户明确要求为另一个会话保存交接上下文。</when></atomic-skill>
+  <atomic-skill id="implement" order="11" root="workflow" path="atomic-skills/implement.md"><when>用户明确要求实现既有 spec 或 tickets。</when></atomic-skill>
+  <atomic-skill id="improve-codebase-architecture" order="12" root="workflow" path="atomic-skills/improve-codebase-architecture.md"><when>用户明确要求扫描架构深化机会。</when></atomic-skill>
+  <atomic-skill id="loop-me" order="13" root="workflow" path="atomic-skills/loop-me.md"><when>用户明确要求实验性的工作流规格访谈。</when></atomic-skill>
+  <atomic-skill id="prototype" order="14" root="workflow" path="atomic-skills/prototype.md"><when>用一次性逻辑或 UI 原型回答设计问题。</when></atomic-skill>
+  <atomic-skill id="research" order="15" root="workflow" path="atomic-skills/research.md"><when>需要以一手来源调查问题。</when></atomic-skill>
+  <atomic-skill id="resolving-merge-conflicts" order="16" root="workflow" path="atomic-skills/resolving-merge-conflicts.md"><when>解决进行中的 merge 或 rebase 冲突。</when></atomic-skill>
+  <atomic-skill id="setup-matt-pocock-skills" order="17" root="workflow" path="atomic-skills/setup-matt-pocock-skills.md"><when>用户明确要求配置 tracker、标签或领域布局。</when></atomic-skill>
+  <atomic-skill id="tdd" order="18" root="workflow" path="atomic-skills/tdd.md"><when>以红绿重构循环构建一个垂直切片。</when></atomic-skill>
+  <atomic-skill id="teach" order="19" root="workflow" path="atomic-skills/teach.md"><when>用户明确要求跨会话学习主题。</when></atomic-skill>
+  <atomic-skill id="to-spec" order="20" root="workflow" path="atomic-skills/to-spec.md"><when>用户明确要求把既有讨论综合为 spec。</when></atomic-skill>
+  <atomic-skill id="to-tickets" order="21" root="workflow" path="atomic-skills/to-tickets.md"><when>用户明确要求把计划或 spec 拆为 tickets。</when></atomic-skill>
+  <atomic-skill id="triage" order="22" root="workflow" path="atomic-skills/triage.md"><when>用户明确要求分类 issue 或外部 PR。</when></atomic-skill>
+  <atomic-skill id="wayfinder" order="23" root="workflow" path="atomic-skills/wayfinder.md"><when>用户明确要求为大型模糊目标建立调查地图。</when></atomic-skill>
+  <atomic-skill id="wizard" order="24" root="workflow" path="atomic-skills/wizard.md"><when>用户明确要求实验性生成交互式 bash 向导。</when></atomic-skill>
+  <atomic-skill id="writing-beats" order="25" root="workflow" path="atomic-skills/writing-beats.md"><when>用户明确要求用节拍路径组装文章。</when></atomic-skill>
+  <atomic-skill id="writing-fragments" order="26" root="workflow" path="atomic-skills/writing-fragments.md"><when>用户明确要求访谈并积累写作碎片。</when></atomic-skill>
+  <atomic-skill id="writing-great-skills" order="27" root="workflow" path="atomic-skills/writing-great-skills.md"><when>用户明确要求设计或审查 skill。</when></atomic-skill>
+  <atomic-skill id="writing-shape" order="28" root="workflow" path="atomic-skills/writing-shape.md"><when>用户明确要求逐段塑造文章结构。</when></atomic-skill>
+</atomic-skills>
 ```
 
-## 状态转移
+## 依赖与状态转移
+
+```xml
+<dependencies>
+  <dependency kind="hard" root="vendor:matt-pocock" path="README.md">选择本 workflow 时必须安装完整 matt-pocock vendor 目录。</dependency>
+</dependencies>
+```
 
 ```xml
 <transitions>
-  <transition from="route" to="phase">
-    <when>route 已选定且所需 namespace 可用。</when>
-  </transition>
-  <transition from="phase" to="route">
-    <when>当前能力完成并需要进入另一条路线；同一目标继续复用当前 change。</when>
-  </transition>
+  <transition from="route" to="phase"><when>route 已选定且所需 namespace 可用。</when></transition>
+  <transition from="phase" to="route"><when>当前能力完成并需要进入另一条路线；同一目标继续复用当前 change。</when></transition>
   <transition from="active" to="archived">
     <command root="commands" path="finalize.md" />
     <when>用户确认交付边界且完成门禁通过。</when>
   </transition>
 </transitions>
 ```
-
-## 持久化与副作用
-
-- 所有本地记录先写入当前 change；长期知识、规则、集成配置和 backlog 只写入已声明的 state namespace。
-- 原 skill 指向根目录、`.scratch/`、`docs/agents/` 或系统临时目录时，改用当前 change 或声明 namespace 中的等价路径。
-- 发布 issue、评论、标签、提交代码、合并或删除 worktree 前必须展示动作并获得明确确认；结果写入 `external_refs`。
-- 项目代码、测试和用户要求更新的项目文档不是 Speculo 运行时产物。临时原型必须删除，保留其结论。

package/template/workflows/matt-pocock/atomic-skills/ask-matt.md

@@ -0,0 +1,21 @@
+---
+id: ask-matt
+type: atomic-skill
+workflow: matt-pocock
+name: Ask Matt
+description: 为当前情况选择合适的 Matt Pocock skill 或 route。
+stability: stable
+invocation: user-only
+---
+
+# Ask Matt
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与写入边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/ask-matt/SKILL.md" activation="adapted" /><completion>目标 skill 已执行并记录 skill history；后续 skill 名称继续解析到本目录 wrapper。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/claude-handoff.md

@@ -0,0 +1,21 @@
+---
+id: claude-handoff
+type: atomic-skill
+workflow: matt-pocock
+name: Claude Handoff
+description: 将当前对话交给新的 Claude 后台 agent。
+stability: experimental
+invocation: user-only
+---
+
+# Claude Handoff
+
+本能力不稳定，仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与后台 agent 确认边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/claude-handoff/SKILL.md" activation="adapted" /><completion>目标 skill 已执行；启动结果已脱敏并记录到 skill history/external refs。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/code-review.md

@@ -0,0 +1,21 @@
+---
+id: code-review
+type: atomic-skill
+workflow: matt-pocock
+name: Code Review
+description: 从固定点执行标准与规范双轴代码审查。
+stability: stable
+invocation: model-allowed
+---
+
+# Code Review
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与写入边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/code-review/SKILL.md" activation="adapted" /><completion>双轴结果已返回，实际报告路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/codebase-design.md

@@ -0,0 +1,21 @@
+---
+id: codebase-design
+type: atomic-skill
+workflow: matt-pocock
+name: Codebase Design
+description: 使用深层模块词汇设计接口与 seam。
+stability: stable
+invocation: model-allowed
+---
+
+# Codebase Design
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与知识边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/codebase-design/SKILL.md" activation="adapted" /><completion>设计结论已返回，实际产物路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/diagnosing-bugs.md

@@ -0,0 +1,21 @@
+---
+id: diagnosing-bugs
+type: atomic-skill
+workflow: matt-pocock
+name: Diagnosing Bugs
+description: 用紧凑反馈循环诊断疑难 bug 或性能回退。
+stability: stable
+invocation: model-allowed
+---
+
+# Diagnosing Bugs
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与诊断产物边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/diagnosing-bugs/SKILL.md" activation="adapted" /><completion>诊断结果与回归证据已返回，路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/domain-modeling.md

@@ -0,0 +1,21 @@
+---
+id: domain-modeling
+type: atomic-skill
+workflow: matt-pocock
+name: Domain Modeling
+description: 精炼领域词汇、上下文和架构决策。
+stability: stable
+invocation: model-allowed
+---
+
+# Domain Modeling
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 knowledge namespace 已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="adapted" /><completion>术语与决策先在 change 中形成，确认后的长期路径已记录。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/grill-me.md

@@ -0,0 +1,21 @@
+---
+id: grill-me
+type: atomic-skill
+workflow: matt-pocock
+name: Grill Me
+description: 通过逐问访谈打磨计划或设计。
+stability: stable
+invocation: user-only
+---
+
+# Grill Me
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与访谈记录边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/grill-me/SKILL.md" activation="adapted" /><completion>访谈已收敛或明确 blocked，记录路径已写入 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/grill-with-docs.md

@@ -0,0 +1,21 @@
+---
+id: grill-with-docs
+type: atomic-skill
+workflow: matt-pocock
+name: Grill With Docs
+description: 在代码仓中访谈并同步领域语言与决策。
+stability: stable
+invocation: user-only
+---
+
+# Grill With Docs
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 knowledge namespace 已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/grill-with-docs/SKILL.md" activation="adapted" /><completion>访谈与确认后的知识路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/grilling.md

@@ -0,0 +1,21 @@
+---
+id: grilling
+type: atomic-skill
+workflow: matt-pocock
+name: Grilling
+description: 复用逐问访谈循环直至关键分支清晰。
+stability: stable
+invocation: model-allowed
+---
+
+# Grilling
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与访谈记录边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="adapted" /><completion>访谈决策已返回，记录路径已写入 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/handoff.md

@@ -0,0 +1,21 @@
+---
+id: handoff
+type: atomic-skill
+workflow: matt-pocock
+name: Handoff
+description: 为另一个 agent 或会话保存脱敏交接文档。
+stability: stable
+invocation: user-only
+---
+
+# Handoff
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已替代 raw 临时目录作为持久化边界。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/handoff/SKILL.md" activation="adapted" /><completion>脱敏交接文档路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/implement.md

@@ -0,0 +1,21 @@
+---
+id: implement
+type: atomic-skill
+workflow: matt-pocock
+name: Implement
+description: 基于既有 spec 或 tickets 实现并验证工作。
+stability: stable
+invocation: user-only
+---
+
+# Implement
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、项目产物与确认边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/implement/SKILL.md" activation="adapted" /><completion>实现与验证结果已返回；项目变更和运行记录各自位于正确边界。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/improve-codebase-architecture.md

@@ -0,0 +1,21 @@
+---
+id: improve-codebase-architecture
+type: atomic-skill
+workflow: matt-pocock
+name: Improve Codebase Architecture
+description: 扫描代码仓并呈现架构深化机会。
+stability: stable
+invocation: user-only
+---
+
+# Improve Codebase Architecture
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已替代 raw 系统临时目录作为报告边界。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/improve-codebase-architecture/SKILL.md" activation="adapted" /><completion>报告与选择结果已返回，实际路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/loop-me.md

@@ -0,0 +1,21 @@
+---
+id: loop-me
+type: atomic-skill
+workflow: matt-pocock
+name: Loop Me
+description: 通过有状态访谈形成可实施的工作流规格。
+stability: experimental
+invocation: user-only
+---
+
+# Loop Me
+
+本能力不稳定，仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已作为实验工作区。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/loop-me/SKILL.md" activation="adapted" /><completion>工作流规格路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/prototype.md

@@ -0,0 +1,21 @@
+---
+id: prototype
+type: atomic-skill
+workflow: matt-pocock
+name: Prototype
+description: 用一次性逻辑或 UI 原型回答单个设计问题。
+stability: stable
+invocation: model-allowed
+---
+
+# Prototype
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、项目原型与清理边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/prototype/SKILL.md" activation="adapted" /><completion>原型结论已保留，临时代码已删除或吸收，路径已记录。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/research.md

@@ -0,0 +1,21 @@
+---
+id: research
+type: atomic-skill
+workflow: matt-pocock
+name: Research
+description: 以一手来源调查问题并形成带引用结论。
+stability: stable
+invocation: model-allowed
+---
+
+# Research
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与后台研究确认边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/research/SKILL.md" activation="adapted" /><completion>研究结论与来源已返回，实际文件路径已记录。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/resolving-merge-conflicts.md

@@ -0,0 +1,21 @@
+---
+id: resolving-merge-conflicts
+type: atomic-skill
+workflow: matt-pocock
+name: Resolving Merge Conflicts
+description: 查明双方意图并解决进行中的 merge 或 rebase 冲突。
+stability: stable
+invocation: model-allowed
+---
+
+# Resolving Merge Conflicts
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与继续 merge/rebase 的确认边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/resolving-merge-conflicts/SKILL.md" activation="adapted" /><completion>冲突结果与验证证据已记录；继续或提交仅在确认后执行。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/setup-matt-pocock-skills.md

@@ -0,0 +1,21 @@
+---
+id: setup-matt-pocock-skills
+type: atomic-skill
+workflow: matt-pocock
+name: Setup Matt Pocock Skills
+description: 配置 tracker、triage 标签和领域知识布局。
+stability: stable
+invocation: user-only
+---
+
+# Setup Matt Pocock Skills
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、integrations 与 knowledge namespaces 已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/SKILL.md" activation="adapted" /><completion>确认后的配置写入声明 namespace，实际路径已记录。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/tdd.md

@@ -0,0 +1,21 @@
+---
+id: tdd
+type: atomic-skill
+workflow: matt-pocock
+name: TDD
+description: 以红绿重构循环构建一个垂直切片。
+stability: stable
+invocation: model-allowed
+---
+
+# TDD
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、项目测试与记录边界已解析。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/tdd/SKILL.md" activation="adapted" /><completion>红绿重构证据已返回，实际记录路径已写入 skill history。</completion></phase>
+</sequence>
+```
+

package/template/workflows/matt-pocock/atomic-skills/teach.md

@@ -0,0 +1,21 @@
+---
+id: teach
+type: atomic-skill
+workflow: matt-pocock
+name: Teach
+description: 在持久化教学工作区中跨会话教授主题。
+stability: stable
+invocation: user-only
+---
+
+# Teach
+
+直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
+
+```xml
+<sequence>
+  <phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已替代 raw 当前目录作为教学工作区。</completion></phase>
+  <phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/teach/SKILL.md" activation="adapted" /><completion>教学状态与课程产物路径已记录到 skill history。</completion></phase>
+</sequence>
+```
+