@namewta/speculo 0.2.3 → 0.2.7

package/template/skills/change-lifecycle/SKILL.md

@@ -1,25 +0,0 @@
----
-id: change-lifecycle
-type: skill
-name: Change Lifecycle
-description: 验证、完成和归档任意 Speculo workflow change，返回可确认的状态与目录移动计划。
----
-
-# Change Lifecycle
-
-## 输入
-
-- `runtime-context` 返回的 workflow、state、changes、archive 和可选 change 根。
-- `mode: finalize-active | archive-completed`。
-- 当前 route/phase 完成准则、change 状态与可选 worktree 状态。
-
-## 流程
-
-1. `finalize-active` 按 `references/completion-gate.md` 收集新鲜证据；任一关键结论缺证据即返回 blocked。
-2. 两种模式均按 `references/finalize-archive.md` 验证名称、状态、索引和目标冲突。
-3. 返回状态修改、移动、索引更新和可选 worktree 清理计划，等待调用方取得用户确认。
-4. 调用方执行后重新读取源、目标、change 状态和 workflow 索引；存在部分完成即返回 blocked。
-
-完成标准：返回 `verified | blocked | archived` 中唯一裁决及完整证据；本 skill 未自行持久化或执行未确认的破坏性动作。
-
-报告模板见 `assets/completion-verification-template.md` 与 `assets/completion-summary-template.md`。

package/template/skills/change-lifecycle/assets/completion-summary-template.md

@@ -1,25 +0,0 @@
-> **服务命令：** `../../../commands/finalize.md`
-> **产物文件名：** `completion-summary.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Completion Summary
-
-## 交付边界
-
-[TODO: 本 change 交付了什么、不含什么。]
-
-## 关键变更
-
-[TODO: 用 3-6 条概括主要变更。]
-
-## 验证证据
-
-[TODO: 指向 `completion-verification.md` 的关键结论与命令证据。]
-
-## 遗留事项
-
-[TODO: 已知遗留、后续建议或转交的工作；无则写"无"。]
-
-## 归档记录
-
-[TODO: 归档时间、源路径 → `speculo/.speculo/<workflow>/archive/<YYYY-MM>/<change>/`、用户确认记录。]

package/template/skills/change-lifecycle/assets/completion-verification-template.md

@@ -1,29 +0,0 @@
-> **服务命令：** `../../../commands/finalize.md`
-> **产物文件名：** `completion-verification.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Completion Verification
-
-## 已运行命令（含证据）
-
-[TODO: 逐条记录本次运行的验证命令、退出码、通过/失败计数；无证据不得声称通过。]
-
-## 未运行命令
-
-[TODO: 列出相关但未运行的命令及原因；对应结论不得声称通过。]
-
-## 需求逐项核对
-
-[TODO: 重读来源，逐项列出需求 + satisfied/missing/partial + 来源引用。]
-
-## 回归证据（如适用）
-
-[TODO: 记录红-绿循环验证；无 bug 修复可写 N/A。]
-
-## 调试残留检查
-
-[TODO: 临时日志、DEBUG 标记、一次性脚本、推测性功能的清理结果。]
-
-## 验证结论
-
-[TODO: verified 或 blocked；blocked 时写明实际状态与缺口。]

package/template/skills/change-lifecycle/references/completion-gate.md

@@ -1,19 +0,0 @@
-# Completion Verification
-
-本门控只服务 `finalize-active`。没有本次运行的新鲜证据时返回 blocked。
-
-## 输入与产物
-
-- 输入：当前 change 产物、route/phase 完成准则、需求来源、VCS diff 和项目验证命令。
-- 产物：当前 change 下的 `completion-verification.md`，使用 `../assets/completion-verification-template.md`。
-
-## 门控
-
-1. 运行相关测试、类型检查、lint 和构建，逐条记录命令、退出码与通过/失败计数。
-2. 重读 PRD、issue、spec 或用户任务，逐项标记 `satisfied | missing | partial` 并引用来源。
-3. Bug 修复确认回归测试经过红、绿、回退修复再红、恢复再绿；无法证明时记录缺口。
-4. 子代理参与时以 VCS diff 和实际文件为证据，不使用代理自报结论。
-5. 搜索调试日志、一次性脚本、DEBUG 标记和未启用功能，清理或记录阻塞。
-6. 全部关键项有证据时写 `verification_status: verified`，否则写 `blocked` 并停止归档。
-
-完成标准：需求清单与每项结论均有新鲜证据，产物无 `[TODO:]`，change 状态已记录验证命令、需求清单和裁决。

package/template/skills/change-lifecycle/references/finalize-archive.md

@@ -1,32 +0,0 @@
-# Finalize And Archive
-
-归档是破坏性目录移动，调用方必须先展示完整计划并取得明确确认。
-
-## 共同预检
-
-- change 名称符合日期 kebab 规则（格式校验来源与 `runtime-context/SKILL.md` 第4步相同，创建时已保证；此处为冗余验证），且 `.status.json` 可解析。
-- 源位于 runtime context 的 `changes_root`，目标位于 `archive_root/<YYYY-MM>/<change>`。
-- 目标不存在，workflow `status.json` 与 change 状态一致。
-- worktree 模式已经合并回目标分支并清理，或调用方明确记录 blocked。
-
-## finalize-active
-
-1. 要求 `verification_status: verified`。
-2. 在当前 change 写 `completion-summary.md`，记录交付边界、证据指针和遗留事项。
-3. 将 `change_status` 置为 `completed`；若 workflow 允许沉淀经验，只写入其声明的 knowledge store。
-4. 展示归档计划并等待确认，随后执行共同归档步骤。
-
-## archive-completed
-
-1. 仅接受 `change_status: completed`，不重新运行完成门控。
-2. 批量模式先为全部候选完成共同预检；任一冲突、malformed 或 broken change 会阻塞整批动作。
-3. 展示逐项计划并等待一次明确确认，随后按稳定顺序执行共同归档步骤。
-
-## 共同归档步骤
-
-1. 创建 archive 月目录并移动整个 change。
-2. 从 workflow `status.json#active` 删除该 change。
-3. 更新已移动的 `.status.json`：`change_status: archived`、`archived: true`、project-relative `archive_path`。
-4. 重新读取目标、索引和状态；失败时返回已完成/未完成清单，不猜测成功。
-
-完成标准：源不存在、目标完整、active 索引已移除且归档状态字段一致。

package/template/skills/knowledge-prune/SKILL.md

@@ -1,29 +0,0 @@
----
-id: knowledge-prune
-type: skill
-name: Knowledge Prune
-description: dry-run 审计 workflow 声明的知识与策略 namespace，返回可安全删除、合并或改写的候选清单。
----
-
-# Knowledge Prune
-
-默认只分析，不自行写报告或修改文件。调用方负责 runtime context、用户确认和持久化。
-
-## 输入
-
-- `runtime-context` 返回的 workflow/state 根。
-- `PERSISTENCE.md#persistence` 中 role 为 knowledge、policy 或 legacy-knowledge 的 namespace。
-- 用户确认状态：`dry-run | confirmed`。
-
-## 流程
-
-1. 读取 `references/audit-rules.md`，仅扫描已声明且真实存在的 namespace。
-2. 为每个候选收集当前代码、文档、active change、archive 和交叉引用证据。
-3. 按 `delete | merge | rewrite | keep | needs-confirmation` 返回候选；dry-run 到此完成。
-4. confirmed 模式重新验证真实路径包含关系，再逐项执行用户批准的动作并返回结果。
-
-完成标准：每个候选都有来源、证据和风险；未确认时文件系统未发生变化；本 skill 未自行选择报告路径。
-
-## 渐进披露
-
-- `references/audit-rules.md`：生成候选、判定保护项或执行确认后的修改时读取。

package/template/skills/knowledge-prune/references/audit-rules.md

@@ -1,24 +0,0 @@
-# Knowledge Prune Audit Rules
-
-## 扫描范围
-
-1. 读取目标 workflow `PERSISTENCE.md` 的 `<persistence>`，选择 role 为 `knowledge | policy | legacy-knowledge` 且真实存在的 store。
-2. `create="lazy"` 但不存在的 store 记为 `missing`，不为审计而创建；`existing-only` store 只读。
-3. 扫描代码、文档、active changes 和 archive 中对 ADR、CONTEXT、LESSONS、RULES 及具体文件名的引用。
-
-## 候选
-
-- 指向不存在知识文件的引用。
-- 已 superseded、超过 30 天且无 active 引用的 ADR。
-- 只含占位符、模板说明或空内容的长期知识文件。
-- 当前代码、文档和 archive 均无证据支撑的领域术语。
-- 重复、过时、仅适用单次 change 或已被规则/ADR 吸收的经验。
-
-## 保护规则
-
-- 仍被代码、文档、archive 或 active change 引用的内容归入 `keep`。
-- RULES、术语冲突、ADR/CONTEXT 改写和 existing-only legacy store 一律归入 `needs-confirmation`。
-- 删除前解析真实路径，确认仍位于目标 workflow state root 和已声明 store 内。
-- 不跨 workflow 合并知识，不修改 docs-sync state。
-
-完成标准：所有已声明且存在的知识 store 均已扫描，每个候选恰好属于一个分组。

package/template/skills/runtime-context/SKILL.md

@@ -1,54 +0,0 @@
----
-id: runtime-context
-type: skill
-name: Runtime Context
-description: 解析 Speculo 项目根、资产根和 workflow 状态根，向 command/workflow/skill 返回经过边界校验的统一路径上下文。
----
-
-# Runtime Context
-
-从项目根注册表和 workflow `PERSISTENCE.md` 构造一次运行所需的全部路径。调用方持有持久化责任；本 skill 只解析和验证路径。
-
-## 输入
-
-- 当前工作目录或用户指定的项目目录。
-- workflow id，以及对应 `PERSISTENCE.md` 中的 `<runtime-context>` 和 `<persistence>`。
-- 可选 change 名称和 command id。
-
-## 流程
-
-1. 按 `references/path-resolution.md` 向上定位 `speculo/.speculo/workspace.json`；找不到唯一项目根时返回 blocked。
-2. 读取注册表与 workflow 的 `PERSISTENCE.md`，解析 `workflow/state/commands/skills/vendor`。
-   - 对每个解析后的 vendor root 执行存在性验证：目标目录必须存在，否则返回明确错误信息指明缺失的具体路径，禁止静默跳过。
-   - 任一路径越界或目标缺失时返回 blocked。
-3. 读取 `speculo/config.json`（若存在）；不存在时以默认值静默降级（`language: "en"`、`persistence.root_override: null`、`defaults.confirm_before_external_write: true`、`defaults.report_language: "en"`）。
-4. 读取固定状态骨架 `status.json/changes/archive`；选择 change 时派生 `change_root`，不把派生绝对路径写回状态。
-   - **Change 名称格式校验：** change 名称必须匹配 `^\d{4}-\d{2}-\d{2}-[a-z0-9]+(-[a-z0-9]+)*$`（即 `YYYY-MM-DD-<kebab-topic>`）。
-   - 创建 change 时自动以当天日期为前缀（`YYYY-MM-DD-`），用户只需提供 topic 部分。
-   - 手动指定完整 change 名时，不匹配格式则阻塞并提示正确格式：`YYYY-MM-DD-<kebab-topic>`。
-   - 已有不带日期前缀的历史 change 标注为遗留，不阻塞但记录警告。
-   - 校验逻辑定义为单一来源（本步骤），归档端（`finalize-archive.md`）的日期 kebab 检查引用同一格式规则。
-5. 返回 project-relative runtime context，供后续所有 skills 复用；后续调用不得重新猜测路径。
-
-## 输出
-
-```text
-project_root
-workflow_root
-state_root
-changes_root
-archive_root
-change_root?
-commands_root
-skills_root
-vendor_roots[]
-config?
-```
-
-`config` 字段包含已解析的 `{language, persistence: {root_override}, defaults: {confirm_before_external_write, report_language}}`。
-
-完成标准：所有返回路径均为项目根相对路径、位于声明根内且对应静态资产真实存在；vendor root 已通过存在性验证；change 名称已通过格式校验；本 skill 未创建任何运行时产物。
-
-## 渐进披露
-
-- `references/path-resolution.md`：定位根注册表、解析 XML 根别名、config 定位与降级规则、change 名称格式约束或检查路径越界时读取。

package/template/skills/runtime-context/references/path-resolution.md

@@ -1,41 +0,0 @@
-# Path Resolution
-
-## 根定位
-
-1. 从当前工作目录向上寻找 `speculo/.speculo/workspace.json`。
-2. 第一个命中的目录是 `project_root`；同时命中多个候选或用户指定目录与候选不一致时停止并澄清。
-3. `workspace.json#path_base` 必须为 `project-root`，所有 roots 必须是 POSIX 风格相对路径。
-
-## Config 定位
-
-1. 在 `project_root` 下查找 `speculo/config.json`。
-2. 若存在，读取并解析其内容；若不存在，以默认值静默降级（`language: "en"`、`persistence.root_override: null`、`defaults.confirm_before_external_write: true`、`defaults.report_language: "en"`）。
-3. config 对象由 runtime-context 统一输出，后续调用方不得重新猜测路径或自行解析。
-
-## Workflow 绑定
-
-读取 workflow 同级 `PERSISTENCE.md` 的 `<runtime-context>`：
-
-- `base` 必须引用 `workspace.json#roots` 中已有根。
-- `path` 不能是绝对路径，不能包含 `..` 或反斜杠。
-- `workflow` 和 `state` 必须分别解析到 `speculo/workflows/<workflow>` 与 `speculo/.speculo/<workflow>`。
-- vendor 可声明零个或多个具名根，例如 `vendor:matt-pocock`。
-
-固定派生规则：
-
-```text
-changes_root = state_root/changes
-archive_root = state_root/archive
-change_root = changes_root/<change>
-```
-
-**Change 名称格式约束：** `<change>` 必须匹配 `^\d{4}-\d{2}-\d{2}-[a-z0-9]+(-[a-z0-9]+)*$`（即 `YYYY-MM-DD-<kebab-topic>`）。创建 change 时自动以当天日期为前缀，用户只需提供 topic 部分。手动指定完整名称时，不匹配格式则阻塞并提示正确格式。此格式约束在创建时即强制执行，归档时的日期 kebab 检查作为冗余验证与此处共享同一校验来源。已有不带日期前缀的历史 change 在文档中标注为遗留，归档时不阻塞。
-
-## 边界检查
-
-- 解析后执行真实路径包含检查；符号链接逃逸与不存在的静态引用均阻塞。
-- **Vendor root 存在性验证：** 解析后的每个 vendor root 必须验证目标目录存在；缺失时返回明确错误信息指明缺失的具体路径，禁止静默跳过。此规则与 workflow/state/commands/skills 根的验证同等生效。
-- `<artifact root="change">` 只能落在当前 change。
-- `<artifact root="state">` 只能落在 `<persistence>` 声明的额外命名空间。
-- command 报告只能落在 `state/commands/<command>/`，skill 不自行选择路径。
-- raw vendor SKILL 只通过同 workflow 的一对一 atomic wrapper 激活；wrapper 先加载 `PERSISTENCE.md`，嵌套 skill 名称继续解析到 wrapper。

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

@@ -1,80 +0,0 @@
-# Matt Pocock Persistence
-
-本文件是 `matt-pocock` 的唯一运行契约。`WORKFLOW.md` 与 `atomic-skills/*.md` 只能引用本文件，不得复制 runtime roots、store、change 启动或副作用规则。无论从 workflow 还是 atomic wrapper 进入，都先读取项目根 `speculo/.speculo/workspace.json`，再执行本文件。
-
-## 运行时根
-
-```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/` 是固定骨架；lazy store 只在产生对应内容并确认长期归属时创建。已有 `.config/` 只读，不接收新内容。
-
-## 启动协议
-
-```xml
-<sequence>
-  <phase id="resolve-runtime" order="1">
-    <skill root="skills" path="runtime-context/SKILL.md" activation="required" />
-    <completion>workspace、config、workflow/state/vendor roots 均已解析并通过边界与存在性检查；同一运行已解析时复用结果。</completion>
-  </phase>
-  <phase id="select-change" order="2">
-    <artifact root="state" path="status.json" />
-    <completion>已选择用户指定或唯一 active change；没有 active change 时原子创建 `changes/YYYY-MM-DD-&lt;kebab-topic&gt;/.status.json` 并更新索引；多个候选时先消歧。</completion>
-  </phase>
-</sequence>
-```
-
-创建 change 时初始化 schema version 1、workflow/name/timestamps、`change_status: active`、空的 `route_history`、`skill_history` 与 `external_refs`。已有 change 缺少这些数组时按空数组读取，在下一次真实更新时补齐，不要求迁移。
-
-## 状态字段
-
-```xml
-<state-schema>
-  <field name="current_route" type="string|null" />
-  <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>
-```
-
-- route 调用维护 `current_route` 与 `route_history`；direct atomic 调用保持二者不变。
-- 每次 atomic wrapper 调用向 `skill_history` 追加 skill id、`direct|route` 模式、进入/完成时间、结果和真实的项目相对产物路径。
-- 外部系统结果只写入 `external_refs`；状态不保存派生绝对路径。
-
-## 路径分配
-
-1. route 的 `<artifact>` 指针优先，wrapper 使用调用方已声明路径。
-2. direct 调用没有 route 产物声明时，运行时文件由目标 skill 在当前 change 内按需新建；只强制 `change_root` 边界，不强制 `atomic-skills/<id>` 子目录。
-3. 项目代码、测试和用户明确要求的项目文档属于项目产物，可写入经确认的项目相对路径；同时把验证或结果指针记录到当前 change。
-4. 长期知识、规则和集成配置先在 change 中形成，经确认后才写入已声明的 lazy store。raw skill 中的 `CONTEXT.md`、ADR、`docs/agents/`、`.out-of-scope/` 等逻辑位置分别映射到 `knowledge`、`integrations` 或 `policy`，不在项目根自行创建私有运行状态。
-5. 临时原型、数据库、脚本和报告必须删除或吸收；保留的结论写入当前 change。raw skill 指向系统临时目录、当前目录或 `.scratch/` 时，同样受本规则约束。
-
-raw skill 内部提及另一个 `/skill` 时，解析到 `atomic-skills/<skill-id>.md`；只有该 wrapper 可以直接引用对应 vendor `SKILL.md`。
-
-## 副作用边界
-
-- 发布 issue、评论、标签，写 secret，启动后台 agent，提交代码，继续 merge/rebase，合并或删除 worktree 前，展示动作与目标并取得明确确认。
-- 已确认动作的结果、URL、commit 或失败状态写入 `external_refs`；敏感值不得写入 change 或状态。
-- vendor 内容保持只读；所有路径改写和确认规则由本文件提供。
-

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

@@ -1,103 +0,0 @@
----
-id: matt-pocock
-type: workflow
-workflow: matt-pocock
-name: Matt Pocock Workflow
-description: 以路由和原子入口组合 Matt Pocock skills，并共享同一持久化契约
-keywords: [matt-pocock, engineering, productivity, grilling, tdd, review]
----
-
-# Matt Pocock Workflow
-
-先读取 [PERSISTENCE.md](./PERSISTENCE.md)。该文件是 runtime roots、store、change 启动和副作用边界的唯一来源；本入口只负责选择组合 route 或单个 atomic skill。
-
-## 进入协议
-
-```xml
-<sequence>
-  <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">
-    <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" />
-    <when>目标 route 依赖尚未配置的 tracker、triage 或 domain 文档。</when>
-    <completion>只补齐目标 route 必需的私有 namespace。</completion>
-  </phase>
-</sequence>
-```
-
-## 路由
-
-```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>
-```
-
-## 原子能力
-
-```xml
-<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="active" to="archived">
-    <command root="commands" path="finalize.md" />
-    <when>用户确认交付边界且完成门禁通过。</when>
-  </transition>
-</transitions>
-```

package/template/workflows/matt-pocock/_state/archive/.gitkeep

@@ -1 +0,0 @@
-

package/template/workflows/matt-pocock/_state/changes/.gitkeep

@@ -1 +0,0 @@
-

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

@@ -1,21 +0,0 @@
----
-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

@@ -1,21 +0,0 @@
----
-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

@@ -1,21 +0,0 @@
----
-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

@@ -1,21 +0,0 @@
----
-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

@@ -1,21 +0,0 @@
----
-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

@@ -1,21 +0,0 @@
----
-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>
-```
-