@namewta/speculo 0.1.19 → 0.1.21

package/template/workflows/dev/A-improve-architecture/architecture-grill.md

@@ -0,0 +1,30 @@
+# Architecture Grill Phase — 质询所选候选并沉淀
+
+## 输入
+
+- 用户选中的深化候选（来自 `architecture-review.html`）
+- `speculo/.speculo/dev/<change>/architecture-candidates.md`
+- `speculo/.speculo/.config/context/CONTEXT.md`、`speculo/.speculo/.config/adr/`
+
+## 产物
+
+- `speculo/.speculo/dev/<change>/architecture-design.md`
+- 经用户确认后更新 `.config/context/`、`.config/adr/`
+
+## 填写引导
+
+1. 用 `../../../skills/grill-me/SKILL.md` 与用户走设计树：约束、依赖、深化后模块形态、接缝后面是什么、哪些测试存活。
+2. 决策结晶时按 `../M-domain-modeling/M-domain-modeling.md` 内联沉淀：深化模块用了 CONTEXT 没有的概念 → 加术语；锐化了模糊术语 → 更新 CONTEXT；用户以关键理由否决候选 → 按 ADR 三判据决定是否记 ADR。
+3. 想探索深化模块的备选接口时，按 `../../../vendor/codebase-design/DESIGN-IT-TWICE.md` 的「设计两次」并行子代理模式。
+
+## 边界
+
+- 写 `.config/context/` 或 `.config/adr/` 前必须经用户确认。
+- 本 phase 不落地代码实现（交由 `../03-tdd/03-tdd.md`）。
+
+## 完成准则
+
+- 选中候选的接口、依赖策略与适配器、存活测试已记入 `architecture-design.md`
+- 决策结晶处的术语 / ADR 已按 `../M-domain-modeling/` 沉淀（经用户确认）
+- `architecture-design.md` 无残留 `[TODO:]`
+- `.status.json` 写入 `selected_candidate`，置 `architecture_status: designed`

package/template/workflows/dev/A-improve-architecture/architecture-review.md

@@ -0,0 +1,29 @@
+# Architecture Review Phase — 可视化架构审查报告
+
+## 输入
+
+- `speculo/.speculo/dev/<change>/architecture-candidates.md`
+- `speculo/.speculo/.config/context/CONTEXT.md`
+
+## 产物
+
+- `speculo/.speculo/dev/<change>/architecture-review.html`
+
+## 填写引导
+
+1. 按 `../HTML-REPORT.md` 编写**自包含** HTML（Tailwind + Mermaid 走 CDN），每个候选一张卡片含**前后对比图**，结尾「首要推荐」段。
+2. 写入 `speculo/.speculo/dev/<change>/architecture-review.html`（**不写临时目录**），用 OS 命令打开（macOS `open`、Linux `xdg-open`、Windows `start`），并告知用户绝对路径。
+3. 领域用 CONTEXT 词汇、架构用 codebase-design 词汇。
+4. 此时不提接口设计；写入并打开后，询问用户：「这些候选你想探索哪一个？」
+
+## 边界
+
+- 本 phase 不做接口设计或质询。
+- 报告必须写入 change 目录，禁止 `temp/` 或项目根目录。
+
+## 完成准则
+
+- HTML 自包含、每个候选有前后对比图与推荐强度徽章、含首要推荐段
+- 报告已为用户打开
+- 已请用户选择候选
+- `.status.json` 写入 `candidate_count`、`report_path`，置 `architecture_status: reported`

package/template/workflows/dev/A-improve-architecture/architecture-scan.md

@@ -0,0 +1,37 @@
+# Architecture Scan Phase — 探索深化候选
+
+## 输入
+
+- 当前 git 仓库与待改进的代码区域
+- `speculo/.speculo/.config/context/CONTEXT.md`、触及区域的 `speculo/.speculo/.config/adr/` ADR
+- 设计词汇单一事实源 `../../../vendor/codebase-design/SKILL.md`、`DEEPENING.md`
+
+## 产物
+
+- `speculo/.speculo/dev/<change>/architecture-candidates.md`
+
+## 核心原则（引用 codebase-design）
+
+- **删除测试**：对任何疑似浅的模块，想象删除它——复杂性会集中（好信号）还是只是移动？
+- **深度是接口的属性**：小接口 + 大量实现；深化 = 缩小接口、把复杂性吸收进实现。
+- **接缝纪律**：一个适配器 = 假设接缝，两个 = 真实接缝。
+- 完整原则见 `../../../vendor/codebase-design/SKILL.md` 与 `DEEPENING.md`，本 phase 不复制。
+
+## 填写引导
+
+1. 先读 `speculo/.speculo/.config/context/CONTEXT.md` 与触及区域的 `.config/adr/`。
+2. 用 Agent 工具（`subagent_type=Explore`）遍历代码库，注意摩擦：理解一个概念要在许多小模块间跳转？模块浅？纯函数仅为可测试性而提取？紧耦合泄漏？难以通过当前接口测试？
+3. 对每个疑似浅模块应用**删除测试**，保留「删除会集中复杂性」的候选。
+4. 每个候选记录：**涉及文件**、**问题**、**解决方案**、**收益**（局部性 / 杠杆 / 测试改善）、**依赖类别**（进程内 / 本地可替换 / 端口与适配器 / mock）、**推荐强度**（强烈 / 值得探索 / 推测性）。
+5. 与现有 ADR 冲突的候选，仅在摩擦真实到值得重审 ADR 时保留，并显式标注。
+
+## 边界
+
+- 本 phase 不写 HTML 报告、不做接口设计。
+- 候选均用 codebase-design 词汇命名，不散用「组件 / 服务 / 边界」。
+
+## 完成准则
+
+- 每个候选含文件、问题、解决方案、收益、依赖类别、推荐强度
+- `architecture-candidates.md` 无残留 `[TODO:]`
+- `.status.json` 写入 `candidate_count`，置 `architecture_status: scanning`

package/template/workflows/dev/AGENTS.md

@@ -44,7 +44,7 @@ keywords: [dev, 开发, workflow, index, agents, 状态]
 2. 若只有一个 active change，默认继续该 change；若有多个 active change，要求用户选择。
 3. 若没有 active change，按用户意图创建新的 change。**以下三步为原子操作，不可跳过，前一步失败时停止后续并报告：**
    - **3a. 创建 change 目录** —— `speculo/.speculo/dev/<YYYY-MM-DD>-<kebab-name>/`（使用当前日期，`<kebab-name>` 从用户意图提取，不超过 5 个词）。
-   - **3b. 写入 `.status.json`** —— 在 change 目录下创建 `.status.json`，按 `docs/persistence-contract.md` §2.2 最小初始化模板填入所有必填字段（`name`、`category: "dev"`、`change_status: "active"`、`created_at`、`updated_at`、`current_phase: "00-init"`、`phase_history`）。
+   - **3b. 写入 `.status.json`** —— 在 change 目录下创建 `.status.json`，按 `../../skills/speculo-write/references/persistence-contract-sop.md` 最小初始化模板填入所有必填字段（`name`、`category: "dev"`、`change_status: "active"`、`created_at`、`updated_at`、`current_phase: "00-init"`、`phase_history`）。
    - **3c. 更新 `dev-status.json`** —— 读取 `speculo/.speculo/dev-status.json`，在 `active[]` 中追加该 change 的索引条目（`name`、`current_phase: "00-init"`、`updated_at`），写回文件。
    - 以上三步全部成功后，方可继续推荐入口。
 4. 推荐入口时优先使用用户显式别名；没有别名时按执行模式推荐。
@@ -79,9 +79,17 @@ keywords: [dev, 开发, workflow, index, agents, 状态]
 - worktree 模式 change 额外汇报 `base_branch` / `change_branch` / `worktree_status`
 - 推荐下一步入口和原因
 
+## 续跑协议
+
+1. 读取 change 目录下 `.status.json` 的 `current_phase` 与 `phase_history`。
+2. 跳过 `status: completed` 的 phase；从 `in-progress`、`blocked` 或首个 `pending` phase 继续。
+3. 根据 `current_phase` 匹配 workflow 入口 `## 阶段` 中的机器 id，只读取对应 phase 文件与模板。
+4. 首个 workflow 进入 change 时写入 `execution_mode`（使用入口声明的执行模式名或用户指定别名）。
+5. 不得因续跑而重复创建 change 或重写已完成的 phase 产物。
+
 ## 完成与状态更新
 
 - 所有 dev workflow 必须维护同一 change 的 `.status.json`。
 - 进入 phase 时更新 `current_phase`，并在 `phase_history` 追加 `in-progress` 记录。
 - phase 完成时写入 `completed_at` 和 `status: completed`。
-- 只有完成当前 change 的最终交付边界时，才把 `change_status` 置为 `completed`。
+- 只有 `dev/04-finalize` 或 `archive` 命令可写 `change_status: completed | archived`；其他 dev workflow 只写各自扩展字段。

package/template/workflows/dev/D-docs-sync/D-docs-sync.md

@@ -55,7 +55,16 @@ keywords: [docs-sync, changelog, readme, agents, config, archive, adr, context,
 
 ## 阶段
 
+| Phase | id | agent | 规范 | 产物 |
+|-------|-----|-------|------|------|
+| 1. State Read | `state-read` | — | `docs-sync-state.md` | `docs-sync-state.json` |
+| 2. Diff Collect | `diff-collect` | `agents/docs-diff-agent.md` | `docs-sync-diff.md` | `docs-sync-report.md` |
+| 3. Knowledge Extract | `knowledge-extract` | — | `knowledge-extract.md` | `docs-sync-report.md` |
+| 4. Asset Audit & Update | `asset-audit-update` | `agents/docs-update-agent.md` | `docs-sync-update.md` | `docs-sync-report.md` |
+| 5. State Write | `state-write` | `agents/docs-update-agent.md` | `docs-sync-finish.md` | `docs-sync-state.json` |
+
 ### 1. State Read — 读取同步状态
+- id：`state-read`
 - 规范：`docs-sync-state.md`
 - 模板：`../_templates/docs-sync-state-template.json`
 - 产物：`speculo/.speculo/dev/docs-sync-state.json`
@@ -65,6 +74,7 @@ keywords: [docs-sync, changelog, readme, agents, config, archive, adr, context,
   - 首次空 state 已进入 `bootstrap` 模式，并已生成首批 `tracked_assets` 候选与初始化范围
 
 ### 2. Diff Collect — 收集 git 差异
+- id：`diff-collect`
 - 规范：`docs-sync-diff.md`
 - 模板：无
 - 产物：`docs-sync-report.md`
@@ -74,6 +84,7 @@ keywords: [docs-sync, changelog, readme, agents, config, archive, adr, context,
   - 已判断哪些资产需要新增、删除、修改或保留
 
 ### 3. Knowledge Extract — 归档知识沉淀
+- id：`knowledge-extract`
 - 规范：`knowledge-extract.md`
 - 模板：`../_templates/docs-sync-report-template.md`
 - 产物：`docs-sync-report.md`
@@ -83,6 +94,7 @@ keywords: [docs-sync, changelog, readme, agents, config, archive, adr, context,
   - 不确定或多语义项已转交 `../M-domain-modeling/M-domain-modeling.md` 或标记为待确认
 
 ### 4. Asset Audit & Update — 审计并差量更新资产
+- id：`asset-audit-update`
 - 规范：`docs-sync-update.md`
 - 模板：`../_templates/docs-sync-report-template.md`
 - 产物：`docs-sync-report.md`
@@ -94,6 +106,7 @@ keywords: [docs-sync, changelog, readme, agents, config, archive, adr, context,
   - `docs-sync-report.md` 无残留 `[TODO:]`
 
 ### 5. State Write — 验证与写回状态
+- id：`state-write`
 - 规范：`docs-sync-finish.md`
 - 模板：`../_templates/docs-sync-report-template.md`
 - 产物：`speculo/.speculo/dev/docs-sync-state.json`
@@ -124,4 +137,4 @@ keywords: [docs-sync, changelog, readme, agents, config, archive, adr, context,
 
 - 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
 - 只有验证完成后才原子写回 `speculo/.speculo/dev/docs-sync-state.json`。
-- 本 workflow 不自动完成 change；用户要求仅同步文档时，可在报告完成后把 `change_status` 置为 `completed`。
+- 本 workflow 不自动完成 change；同步完成后仅更新 `docs_sync_status` 等扩展字段。需要收尾时移交 `../04-finalize/04-finalize.md`；不得自行写入 `change_status: completed`。

package/template/workflows/dev/D-docs-sync/agents/docs-diff-agent.md

@@ -0,0 +1,34 @@
+---
+id: dev/D-docs-sync/docs-diff-agent
+type: agent
+name: Docs Diff Agent
+description: 隔离执行 State Read 与 Diff Collect phase：读取同步状态并收集 git 差异
+---
+
+## 使命
+
+读取 docs-sync state，收集 git 差异与 bootstrap 盘点结果，初始化 `docs-sync-report.md`。
+
+## 输入契约
+
+- change 路径：`speculo/.speculo/dev/<change>/`
+- `current_phase` / phase-id：`diff-collect`（承接 `state-read` 完成后）
+- 全局 state：`speculo/.speculo/dev/docs-sync-state.json`
+- 规范：`../docs-sync-state.md`、`../docs-sync-diff.md`
+
+## 执行规范
+
+- 先按 `../docs-sync-state.md` 确定 `LAST_SYNC_SHA`、`HEAD_SHA` 与 bootstrap 模式。
+- 再按 `../docs-sync-diff.md` 收集 git log、name-status、路径分组。
+- bootstrap 模式执行全量项目盘点。
+- 报告写入 `speculo/.speculo/dev/<change>/docs-sync-report.md`。
+
+## 产物与状态
+
+- 产物：`docs-sync-report.md`（diff 段）
+- `.status.json`：更新 `docs_sync_range`、`docs_sync_status`
+
+## 边界
+
+- 不修改 tracked assets 正文；不写回 docs-sync state。
+- 不写 `change_status`。

package/template/workflows/dev/D-docs-sync/agents/docs-update-agent.md

@@ -0,0 +1,34 @@
+---
+id: dev/D-docs-sync/docs-update-agent
+type: agent
+name: Docs Update Agent
+description: 隔离执行 Knowledge Extract、Asset Audit & Update 与 State Write phase
+---
+
+## 使命
+
+从归档提取知识、差量更新 tracked assets、验证后原子写回 docs-sync state。
+
+## 输入契约
+
+- change 路径：`speculo/.speculo/dev/<change>/`
+- `current_phase` / phase-id：`asset-audit-update` 或 `state-write`
+- 上游产物：`docs-sync-report.md`（diff 段已完成）
+- 规范：`../knowledge-extract.md`、`../docs-sync-update.md`、`../docs-sync-finish.md`
+- 契约：`../readme-contract.md`、`../agents-contract.md`、`../changelog-contract.md`、`../config-contract.md`
+
+## 执行规范
+
+- 按 `../knowledge-extract.md` 读取 archive 高信号产物。
+- 按 `../docs-sync-update.md` 差量更新 tracked assets；术语不稳定时转交 `../../M-domain-modeling/M-domain-modeling.md`。
+- 按 `../docs-sync-finish.md` 验证并原子写回 `speculo/.speculo/dev/docs-sync-state.json`。
+
+## 产物与状态
+
+- 产物：`docs-sync-report.md`（完整）、更新后的 tracked assets、`docs-sync-state.json`
+- `.status.json`：更新 `synced_assets`、`config_audit_status`、`docs_sync_status: synced`
+
+## 边界
+
+- RULES.md 删除或改写须用户确认。
+- 不写 `change_status`；需要收尾时移交 `../../04-finalize/04-finalize.md`。

package/template/workflows/dev/D-docs-sync/config-contract.md

@@ -62,7 +62,7 @@ ADR 记录难以逆转、缺上下文会令人意外、存在真实权衡的决
 
 ## 删除与 Prune
 
-docs-sync 可以直接删除 tracked 文档中的过期段落；对 `.config` 文件级删除默认进入 `../../../commands/config-prune.md --dry-run` 候选。
+docs-sync 可以直接删除 tracked 文档中的过期段落；对 `.config` 文件级删除默认进入 `../../../skills/config-prune/SKILL.md` 审计候选。
 
 可进入 prune 候选的典型情况：
 

package/template/workflows/dev/D-docs-sync/docs-sync-update.md

@@ -34,7 +34,7 @@
 - 常规同步不整页重写 README 或代理手册；`bootstrap` 模式只在文件缺失时创建完整初始文件，已有文件仍以审计和差量修订为主。
 - 不添加没有对应代码来源的计划中能力。
 - 不把 docs-sync state 放回 skill 或 workflow 目录。
-- 不自动删除 `.config` 文件；删除候选进入 report 或 `../../../commands/config-prune.md` dry-run，执行删除需要用户确认。
+- 不自动删除 `.config` 文件；删除候选进入 report 或交由 `../../../skills/config-prune/SKILL.md` 审计，执行删除需要用户确认。
 - 不把归档产物正文大段复制到长期文档；只沉淀可复用结论，并保留路径引用。
 
 ## 完成准则

package/template/workflows/dev/H-diagnose/H-diagnose.md

@@ -45,7 +45,7 @@ keywords: [diagnose, hotfix, bug, debug, performance, 回归]
 
 **独立进入流程：**
 
-1. **change 目录**：若用户未指定 `<change>` 目录，按 `YYYY-MM-DD-<kebab-name>` 格式创建（如 `2026-06-17-fix-login-timeout`），初始化 `.status.json` 并更新 `dev-status.json`。
+1. **change 目录**：若无 active change，执行 `../AGENTS.md` 进入协议步骤 3（原子三步），不得内联自初始化 JSON。
 2. **信息自采集**：若同 change 目录下无上游产物（PRD、decision-log 等），**自行通过代码库探索采集诊断所需上下文**，不要求用户先执行其他工作流：
    - `git log --oneline -30` 查找近期相关变更
    - 搜索错误信息/堆栈中的关键符号（`grep -rn` 在项目中定位）
@@ -54,31 +54,19 @@ keywords: [diagnose, hotfix, bug, debug, performance, 回归]
 3. **深度搜索**：反馈循环构建受阻时，不轻易放弃——按 `diagnose-guide.md` 的 10 种方法逐项尝试；代码库中找不到线索时，搜索项目文档、issue tracker、CI 日志。
 4. **仅必要时询问**：仅在代码库探索无法确定的关键决策点（如需要访问外部环境、需要用户提供日志文件）使用 `AskUserQuestion`。
 
-### 缺少 change 目录时的自初始化
-
-若当前无对应 change 目录，按以下步骤创建：
-
-1. 从用户报告的 Bug/异常提取 `<kebab-name>`（如 `fix-login-timeout`、`fix-payment-npe`）
-2. 创建 `speculo/.speculo/dev/<YYYY-MM-DD>-<kebab-name>/`
-3. 初始化 `.status.json`：
-   ```json
-   {
-     "dev_entry": "dev/H",
-     "current_phase": "1. Diagnose Loop",
-     "phase_history": [],
-     "change_status": "active",
-     "embedded_guides": ["diagnose"],
-     "feedback_loop": "none",
-     "hypothesis_status": "open",
-     "regression_test": "blocked",
-     "debug_artifacts": []
-   }
-   ```
-4. 在 `speculo/.speculo/dev-status.json` 的 `active` 数组中追加该 change 目录名
+### 缺少 change 目录时
+
+若无 active change，执行 `../AGENTS.md` 进入协议步骤 3（原子三步），不得内联自初始化 JSON。
 
 ## 阶段
 
+| Phase | id | agent | 规范 | 模板 | 产物 |
+|-------|-----|-------|------|------|------|
+| 1. Diagnose Loop | `diagnose-loop` | `agents/diagnose-agent.md` | `diagnose-loop.md` | `../_templates/diagnosis-template.md` | `diagnosis.md` |
+| 2. Fix Regression | `fix-regression` | `agents/fix-agent.md` | `diagnose-fix.md` | `../_templates/regression-template.md` | `regression.md` |
+
 ### 1. Diagnose Loop — 反馈循环与假设
+- id：`diagnose-loop`
 - 规范：`diagnose-loop.md`
 - 模板：`../_templates/diagnosis-template.md`
 - 产物：`diagnosis.md`
@@ -88,6 +76,7 @@ keywords: [diagnose, hotfix, bug, debug, performance, 回归]
   - `diagnosis.md` 无残留 `[TODO:]`
 
 ### 2. Fix Regression — 修复与回归
+- id：`fix-regression`
 - 规范：`diagnose-fix.md`
 - 模板：`../_templates/regression-template.md`
 - 产物：`regression.md`
@@ -116,4 +105,4 @@ keywords: [diagnose, hotfix, bug, debug, performance, 回归]
 
 - 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
 - 若需要 TDD 实现修复，可嵌入 `../03-tdd/03-tdd.md` 的 Slice Loop。
-- 修复验证完成后可把 `change_status` 置为 `completed`，或移交后续 review/handoff。
+- 修复验证完成后移交 `../04-finalize/04-finalize.md` 或 `../R-review/R-review.md`；不得自行写入 `change_status: completed`。

package/template/workflows/dev/H-diagnose/agents/diagnose-agent.md

@@ -0,0 +1,33 @@
+---
+id: dev/H-diagnose/diagnose-agent
+type: agent
+name: Diagnose Agent
+description: 隔离执行 Diagnose Loop phase：反馈循环与假设验证
+---
+
+## 使命
+
+建立可信反馈循环，记录复现、假设与插桩结果，产出 `diagnosis.md`。
+
+## 输入契约
+
+- change 路径：`speculo/.speculo/dev/<change>/`
+- `current_phase` / phase-id：`diagnose-loop`
+- 用户描述的失败现象、日志、复现步骤
+- 模板：`../_templates/diagnosis-template.md`
+
+## 执行规范
+
+- 按 `../diagnose-loop.md` 与 `../diagnose-guide.md` 执行诊断循环。
+- HITL 场景按 `../scripts/hitl-loop.template.sh` 建立结构化循环。
+- 产物写入 `speculo/.speculo/dev/<change>/diagnosis.md`。
+
+## 产物与状态
+
+- 产物：`diagnosis.md`
+- `.status.json`：更新 `current_phase: diagnose-loop`、`feedback_loop`、`hypothesis_status`
+
+## 边界
+
+- 不越过本 phase；不实施修复或回归测试。
+- 不写 `change_status`。

package/template/workflows/dev/H-diagnose/agents/fix-agent.md

@@ -0,0 +1,34 @@
+---
+id: dev/H-diagnose/fix-agent
+type: agent
+name: Fix Agent
+description: 隔离执行 Fix Regression phase：修复与回归验证
+---
+
+## 使命
+
+在正确接缝实施修复并验证回归，产出 `regression.md`。
+
+## 输入契约
+
+- change 路径：`speculo/.speculo/dev/<change>/`
+- `current_phase` / phase-id：`fix-regression`
+- 上游产物：`diagnosis.md`
+- 模板：`../_templates/regression-template.md`
+
+## 执行规范
+
+- 按 `../diagnose-fix.md` 实施修复。
+- 可在接缝添加回归测试；必要时嵌入 `../../03-tdd/03-tdd.md` 的 Slice Loop。
+- 重新验证原始反馈循环。
+- 产物写入 `speculo/.speculo/dev/<change>/regression.md`。
+
+## 产物与状态
+
+- 产物：`regression.md`
+- `.status.json`：更新 `current_phase: fix-regression`、`regression_test`
+
+## 边界
+
+- 不越过本 phase；不写 `change_status`。
+- 完成后移交 `../../04-finalize/04-finalize.md` 或 `../../R-review/R-review.md`。

package/template/workflows/dev/I-to-issues/I-to-issues.md

@@ -8,130 +8,69 @@ keywords: [issues, slices, vertical, AFK, HITL, 切片]
 
 # To Issues 工作流执行指引
 
-本工作流是 `dev/I` 入口。它既可独立执行，也可嵌入 `dev/01`、`dev/02`、`dev/03` 或 `dev/H`，用于生成垂直切片。垂直切片和 issue 发布指引已内置在本 workflow 目录中。
+本工作流是 `dev/I` 入口。它既可独立执行，也可嵌入 `dev/01`、`dev/02`、`dev/03` 或 `dev/H`，用于生成垂直切片。
 
-## 内置指引
-
-使用垂直切片（示踪弹）将计划、规格或 PRD 分解为可独立接手的 issue。
-
-### 铁律
+## 铁律
 
 ```
 没有精确到文件路径的改动清单，不算垂直切片
 ```
 
-每个切片必须指名要读哪些文件、要改哪些文件、改动什么内容。笼统描述（"改一下登录"）不是切片。
-
-### 内置文档
-
-本工作流入口自带以下配套文档，在对应阶段读取：
-
-- `issues-slices.md` — 进行实际切片分解时读取；含有完整结构规范（8 段 slices.md）、独立进入时的深度搜索协议（三轮自采集）、存疑时的提问协议（决策树）
-- `../_templates/issues-slices-template.md` — 写 `slices.md` 时作为骨架填写；头部 blockquote 标注了服务工作流与产物文件名，每个 `[TODO:]` 对应结构规范中的一段
-- `../../../vendor/codebase-design/SKILL.md` — 切分跨层切片、在 §2 架构上下文命名模块与接缝时引用（**设计词汇单一事实源**）：统一使用深模块设计词汇（模块 / 接口 / 接缝 / 适配器 / 深度 / 杠杆 / 局部性），不散用「组件 / 服务 / 边界」；判定某个切片是否值得引入新接缝时，应用「一个适配器 = 假设接缝，两个适配器 = 真实接缝」——不要为单一实现凭空切出接缝。
-
-### 输入
-
-- PRD、计划、设计记录、bug 诊断结论或当前对话上下文
-- 用户明确提供的 issue tracker 配置和标签词汇表（如果存在）
-- 当前 change 目录：`speculo/.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-user-auth`）
-
-### 输出
+## 内置文档
 
-- `speculo/.speculo/dev/<change>/slices.md`
-- 垂直切片清单、依赖关系、HITL/AFK 标记和验收标准
-- 可选的外部 issue 引用
+- `issues-slices.md` — 切片分解规范、深度搜索协议、质量准则与提问协议
+- `../_templates/issues-slices-template.md` — `slices.md` 骨架
+- `../../../vendor/codebase-design/SKILL.md` — 设计词汇单一事实源（模块 / 接口 / 接缝 / 适配器 / 深度 / 杠杆 / 局部性）
 
-（`<change>` 格式：`YYYY-MM-DD-<kebab-name>`）
+## 输入与输出
 
-### 垂直切片规则
+- **输入**：PRD、计划、诊断结论或当前对话；当前 change 目录 `speculo/.speculo/dev/<change>/`
+- **输出**：`slices.md`（垂直切片清单、依赖、HITL/AFK 标记、验收标准）；可选外部 issue 引用
 
-- 每个切片交付一条贯穿所有层（schema、API、UI、测试）的窄但完整的路径。
-- 完成的切片可独立演示或验证。
-- 优先选择多个薄切片而非少数厚切片。
+## 垂直切片规则
 
-切片可以是 `HITL` 或 `AFK`。HITL 切片需要人类交互，例如架构决策或设计评审。AFK 切片可以在无人类交互的情况下实现和合并。尽可能优先选择 AFK 而非 HITL。
+- 每个切片交付一条贯穿所有层的窄但完整路径；优先多个薄切片而非少数厚切片
+- 切片标记 `HITL` 或 `AFK`；尽可能优先 AFK
+- 默认只生成本地切片计划；仅 tracker 已配置且用户明确要求时才发布外部 issue
 
-默认只生成本地切片计划。只有 tracker 已配置且用户明确要求时，才发布外部 issue；发布时按依赖顺序发布，以便被阻塞字段引用真实 issue 标识符。不要关闭或修改任何父级 issue。
+## 独立使用
 
-### 切片计划质量准则
+本工作流**零硬依赖**。只需用户描述任务意图 + 当前 git 仓库即可启动。
 
-`slices.md` 不是清单，而是一份可被下游直接接手的**切片计划**。借鉴高质量 plan 的纪律（参考 TASK plan 的六段结构：当前现状 → 需读文件 → 需改文件 → 数据库表 → 实现要点 → 关键决策）：
+1. **change 目录**：若无 active change，执行 `../AGENTS.md` 进入协议步骤 3（原子三步），不得内联自初始化 JSON。
+2. **信息自采集**：无上游产物时，按 `issues-slices.md`「独立进入时的深度搜索协议」自行采集。
+3. **存疑即问**：仅在代码库探索无法确定的决策分支上，按 `issues-slices.md`「存疑时的提问协议」使用 `AskUserQuestion`。
 
-- **Context 先行**：先写清*为什么*、**已确认决策**（范围拍板，防下游重新扯皮）、**当前现状**（现有实现与需求的差距，精确到文件路径+行号）与**关键核实结论**（探索得到的事实），再展开切片。——映射 slices.md §0
-- **文件级精准**：每个切片须指名**需阅读的文件**（\| 文件 \| 目的 \|）和**需修改的文件**（\| 文件 \| 改动内容 \|，新增标 **新增**，重构标 **重度重构**），杜绝笼统描述。——映射 slices.md §3 切片条目
-- **数据库变更可追溯**：涉及 schema 变更时，用「涉及的数据库表」表记录每张表的变更（新建/新增字段/语义调整），DDL 注明 sql 文件和追加位置。——映射 slices.md §2.5
-- **实现要点前置**：每个切片列出关键实现要点（算法细节、并发控制、兜底策略），让执行者拿到切片就知道怎么下手。——映射 slices.md §3 切片条目
-- **存疑即问**：方案有未决分支时，按本工作流「存疑时的提问协议」用 `AskUserQuestion` 一次一问、带推荐、逐步锁定，不臆测。
-- **行号现场核对**：引用的行号/路径均为*近似*，实施时以现场代码为准；在计划内写明这一点，避免下游照搬过期行号。
-- **保留/不动同等重要**：每个切片既写「改什么」，也写「**保留/不动什么**」——告诉执行者哪些不能碰。
-- **验证分层**：删除型切片的验收须含残留扫描（grep 0 命中）；change 级验证总览走真实运行的冒烟与（如涉及）迁移测试。——映射 slices.md §8
-- **复用优先于新造**：能复用就不新建，在切片「复用」字段与 §1 REUSE 列显式记录。
-- **关键决策收口**：跨切片的技术选型与取舍汇总到「关键决策」段，防止下游对同一问题反复争论。——映射 slices.md §5.5
-- **重型小节按需**：风险登记、退役清单、架构上下文是条件段——复杂 change 铺开，单文件小改可省。
+### 缺少 change 目录时
 
-### 独立使用
-
-本工作流**零硬依赖**，无需预先执行 dev/01、dev/02 等其他工作流即可独立进入。只需用户描述任务意图 + 当前 git 仓库即可启动。
-
-**独立进入流程：**
-
-1. **change 目录**：若用户未指定 `<change>` 目录，按「缺少 change 目录时的自初始化」创建。
-2. **信息自采集**：若同 change 目录下无上游产物（PRD、decision-log、diagnosis 等），按 `issues-slices.md` 的「独立进入时的深度搜索协议」（三轮：全景扫描 → 领域上下文采集 → 锁定未决分支）自行采集切片所需上下文，不要求用户先执行其他工作流。
-3. **存疑即问**：仅在代码库探索无法确定的决策分支上，按「存疑时的提问协议」使用 `AskUserQuestion` 一次一问、带推荐、逐步锁定。
-
-### 缺少 change 目录时的自初始化
-
-若当前无对应 change 目录，按以下步骤创建：
-
-1. 从用户意图提取 `<kebab-name>`（如 `refactor-auth`、`add-export-feature`）
-2. 创建 `speculo/.speculo/dev/<YYYY-MM-DD>-<kebab-name>/`
-3. 初始化 `.status.json`：
-   ```json
-   {
-     "dev_entry": "dev/I",
-     "current_phase": "1. Slice Issues",
-     "phase_history": [],
-     "change_status": "active",
-     "embedded_guides": ["to-issues"],
-     "slice_count": 0,
-     "hitl_slice_count": 0,
-     "published_issue_refs": [],
-     "issue_tracker_mode": "local-only"
-   }
-   ```
-4. 在 `speculo/.speculo/dev-status.json` 的 `active` 数组中追加该 change 目录名
+若无 active change，执行 `../AGENTS.md` 进入协议步骤 3（原子三步），不得内联自初始化 JSON。
 
 ## 阶段
 
 ### 1. Slice Issues — 垂直切片分解
+- id：`slice-issues`
 - 规范：`issues-slices.md`
 - 模板：`../_templates/issues-slices-template.md`
 - 产物：`slices.md`
 - 完成准则：
-  - §0 战略与背景含**已确认决策**、**当前现状**与**关键核实结论**（独立进入时自采集，有上游则继承）
-  - 每个切片都有标题、类型、依赖、覆盖来源、**需阅读/需修改文件表**、**实现要点**、验收切片；删除型切片标注**保留/不动**
-  - 已确认粒度、依赖和 HITL/AFK 标记
-  - 涉及 schema 变更时 §2.5 数据库表已填写
-  - §5.5 关键决策已汇总跨切片技术选型
-  - §8 验证总览存在（静态 → 残留扫描 → 冒烟，按适用项）
+  - §0 含已确认决策、当前现状与关键核实结论
+  - 每个切片有文件表、实现要点、验收切片；删除型切片标注保留/不动
+  - 涉及 schema 变更时 §2.5 已填写；§5.5 关键决策已汇总；§8 验证总览存在
   - `slices.md` 无残留 `[TODO:]`
 
 ## 依赖
 
 - 硬依赖：无
-- 软依赖：无。若同 change 目录下存在其他工作流产物（如 prd.md、decision-log.md、diagnosis.md），可继承其信息加速执行；缺失时自行采集，不阻塞流程。完成后通常移交 `../03-tdd/03-tdd.md`，此为推荐后续而非必须。
+- 软依赖：同 change 下若有 `prd.md`、`diagnosis.md` 等可继承加速；完成后通常移交 `../03-tdd/03-tdd.md`
 
 ## 状态扩展字段
 
-本工作流需在同 change 的 `.status.json` 追加：
-
 - `dev_entry` (string) — 固定为 `dev/I`
 - `embedded_guides` (array) — 包含 `to-issues`
-- `slice_count` (number) — 切片数量
-- `hitl_slice_count` (number) — HITL 切片数量
-- `published_issue_refs` (array) — 已发布 issue 引用，默认空
-- `issue_tracker_mode` (disabled | local-only | publish-requested | published) — issue tracker 使用状态
+- `slice_count` (number)
+- `hitl_slice_count` (number)
+- `published_issue_refs` (array)
+- `issue_tracker_mode` (disabled | local-only | publish-requested | published)
 
 ## 完成与状态更新
 

package/template/workflows/dev/I-to-issues/issues-slices.md

@@ -33,14 +33,14 @@
 - 探索确认的事实 → §0「关键核实结论」（注明行号近似）
 - 从代码/文档提取的约束 → §1 IN/REUSE/OUT、§2 架构约束
 - 无法从代码库确定的 → `[待确认]` 标记，按提问协议处理
-- 从 `prd-overview.md` 或现有文档继承的风险 → §6 风险与回滚
+- 从 `overview.md` 或现有文档继承的风险 → §6 风险与回滚
 
 ## 输入
 
 - `prd.md`、`decision-log.md`、`diagnosis.md`、现有 issue 或用户计划（均为可选；缺失时按「独立进入时的深度搜索协议」自行采集）
 - 可选 issue tracker 配置和标签词汇表
 - `I-to-issues.md` 中的内置切片指引、「切片计划质量准则」与「独立使用」协议
-- 同级 change 目录下已有的 `context-map.md`、`decision-log.md`、`prd-overview.md`（若存在，用于继承领域术语、已确认决策、风险与 ADR 引用；不存在则按深度搜索协议自采集）
+- 同级 change 目录下已有的 `context-map.md`、`decision-log.md`、`overview.md`（若存在，用于继承领域术语、已确认决策、风险与 ADR 引用；不存在则按深度搜索协议自采集）
 
 ## 产物
 
@@ -146,7 +146,7 @@ P2  切片2  名称    依赖 P0+P1
 
 ### 6. 风险与回滚 —— [条件]
 
-本期涉及删除、数据迁移、外部副作用或高耦合改动时填写；纯增量的单文件小改可省。逐条列出风险、触发条件、缓解与回滚手段（表格形式）。**有 `prd-overview.md` 的「风险与未知点」则继承并细化**。
+本期涉及删除、数据迁移、外部副作用或高耦合改动时填写；纯增量的单文件小改可省。逐条列出风险、触发条件、缓解与回滚手段（表格形式）。**有 `overview.md` 的「风险与未知点」则继承并细化**。
 
 ### 7. 退役清单 —— [条件]
 

package/template/workflows/dev/M-domain-modeling/M-domain-modeling.md

@@ -58,34 +58,18 @@ keywords: [domain-modeling, context, adr, ubiquitous-language, 领域建模, 术
 
 ### 独立使用
 
-本工作流**零硬依赖**，无需预先执行其他工作流即可独立进入（`dev/M`）。只需用户的领域讨论 + 当前 git 仓库即可启动；缺 change 目录时按下「自初始化」创建。
-
-### 缺少 change 目录时的自初始化
-
-若当前无对应 change 目录：
-
-1. 从用户意图提取 `<kebab-name>`（如 `model-ordering-terms`）
-2. 创建 `speculo/.speculo/dev/<YYYY-MM-DD>-<kebab-name>/`
-3. 初始化 `.status.json`：
-   ```json
-   {
-     "dev_entry": "dev/M",
-     "current_phase": "1. Model Session",
-     "phase_history": [],
-     "change_status": "active",
-     "embedded_guides": ["domain-modeling"],
-     "terms_resolved": [],
-     "adr_candidates": [],
-     "context_write_status": "none"
-   }
-   ```
-4. 在 `speculo/.speculo/dev-status.json` 的 `active` 数组追加该 change 目录名
+本工作流**零硬依赖**，无需预先执行其他工作流即可独立进入（`dev/M`）。只需用户的领域讨论 + 当前 git 仓库即可启动。
+
+### 缺少 change 目录时
+
+若无 active change，执行 `../AGENTS.md` 进入协议步骤 3（原子三步），不得内联自初始化 JSON。
 
 ## 阶段
 
 > **惰性创建文件**——只在需要写入时才创建。`.config/context/CONTEXT.md` 与 `.config/adr/` 由 Speculo 初始化提供；若目标项目缺失，在第一个术语 / ADR 解决时按需创建。
 
 ### 1. Model Session — 词汇与决策沉淀
+- id：`model-session`
 - 规范：本入口「会话期间（主动纪律）」+ 同目录 `CONTEXT-FORMAT.md`、`ADR-FORMAT.md`
 - 模板：`../_templates/domain-model-log-template.md`
 - 产物：`domain-model-log.md`；经用户确认后更新 `.config/context/` 与 `.config/adr/`