@namewta/speculo 0.1.7 → 0.1.9

package/{speculo → template}/workflows/dev/H-diagnose/H-diagnose.md

@@ -19,13 +19,13 @@ keywords: [diagnose, hotfix, bug, debug, performance, 回归]
 ### 输入
 
 - 用户描述的失败现象、日志、复现步骤或性能症状
-- 当前 change 目录：`.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-fix-login-bug`）
+- 当前 change 目录：`speculo/.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-fix-login-bug`）
 - 可运行的测试、脚本、服务或其他反馈循环
 
 ### 输出
 
-- `.speculo/dev/<change>/diagnosis.md`
-- `.speculo/dev/<change>/regression.md`
+- `speculo/.speculo/dev/<change>/diagnosis.md`
+- `speculo/.speculo/dev/<change>/regression.md`
 - 诊断记录、假设列表、插桩结果、修复与回归验证结论
 - 若缺少可信反馈循环，输出已尝试方法和需要用户提供的材料
 

package/{speculo → template}/workflows/dev/H-diagnose/diagnose-fix.md

@@ -10,7 +10,7 @@
 
 ## 产物
 
-- `.speculo/dev/<change>/regression.md`，由 `../_templates/regression-template.md` 填写
+- `speculo/.speculo/dev/<change>/regression.md`，由 `../_templates/regression-template.md` 填写
 
 ## 填写引导
 
@@ -25,7 +25,7 @@
 
 - 不提交未验证修复。
 - 不自动归档 change。
-- 不修改 `.speculo/.config/RULES.md` 或用户未明确授权的项目规则文档。
+- 不修改 `speculo/.speculo/.config/RULES.md` 或用户未明确授权的项目规则文档。
 
 ## 完成准则
 

package/{speculo → template}/workflows/dev/H-diagnose/diagnose-loop.md

@@ -9,7 +9,7 @@
 
 ## 产物
 
-- `.speculo/dev/<change>/diagnosis.md`，由 `../_templates/diagnosis-template.md` 填写
+- `speculo/.speculo/dev/<change>/diagnosis.md`，由 `../_templates/diagnosis-template.md` 填写
 
 ## 填写引导
 

package/{speculo → template}/workflows/dev/I-to-issues/I-to-issues.md

@@ -18,11 +18,11 @@ keywords: [issues, slices, vertical, AFK, HITL, 切片]
 
 - PRD、计划、设计记录、bug 诊断结论或当前对话上下文
 - 用户明确提供的 issue tracker 配置和标签词汇表（如果存在）
-- 当前 change 目录：`.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-user-auth`）
+- 当前 change 目录：`speculo/.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-user-auth`）
 
 ### 输出
 
-- `.speculo/dev/<change>/slices.md`
+- `speculo/.speculo/dev/<change>/slices.md`
 - 垂直切片清单、依赖关系、HITL/AFK 标记和验收标准
 - 可选的外部 issue 引用
 
@@ -38,6 +38,18 @@ keywords: [issues, slices, vertical, AFK, HITL, 切片]
 
 默认只生成本地切片计划。只有 tracker 已配置且用户明确要求时，才发布外部 issue；发布时按依赖顺序发布，以便被阻塞字段引用真实 issue 标识符。不要关闭或修改任何父级 issue。
 
+### 切片计划质量准则
+
+`slices.md` 不是清单，而是一份可被下游直接接手的**切片计划**。借鉴高质量 plan 的纪律：
+
+- **Context 先行**：先写清*为什么*、**已确认决策**（范围拍板，防下游重新扯皮）与**关键核实结论**（探索得到的事实），再展开切片。
+- **存疑即问**：方案有未决分支时，按本工作流「存疑时的提问协议」用 `AskUserQuestion` 一次一问、带推荐、逐步锁定，不臆测。
+- **行号现场核对**：引用的行号/路径均为*近似*，实施时以现场代码为准；在计划内写明这一点，避免下游照搬过期行号。
+- **保留/不动同等重要**：每个切片既写「改什么」，也写「**保留/不动什么**」——告诉执行者哪些不能碰。
+- **验证分层**：删除型切片的验收须含残留扫描（grep 0 命中）；change 级验证总览走真实运行的冒烟与（如涉及）迁移测试。
+- **复用优先于新造**：能复用就不新建，在切片「复用」字段与 §1 REUSE 列显式记录。
+- **重型小节按需**：风险登记、退役清单、架构上下文是条件段——复杂 change 铺开，单文件小改可省。
+
 ## 阶段
 
 ### 1. Slice Issues — 垂直切片分解
@@ -45,8 +57,10 @@ keywords: [issues, slices, vertical, AFK, HITL, 切片]
 - 模板：`../_templates/issues-slices-template.md`
 - 产物：`slices.md`
 - 完成准则：
-  - 每个切片都有标题、类型、依赖、覆盖的用户故事或来源
+  - §0 战略与背景含**已确认决策**与**关键核实结论**（独立进入时自采集，有上游则继承）
+  - 每个切片都有标题、类型、依赖、覆盖来源、验收切片；删除型切片标注**保留/不动**
   - 已确认粒度、依赖和 HITL/AFK 标记
+  - §8 验证总览存在（静态 → 残留扫描 → 冒烟，按适用项）
   - `slices.md` 无残留 `[TODO:]`
 
 ## 依赖

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

@@ -0,0 +1,154 @@
+# Slice Issues Phase
+
+> 本阶段将 PRD、计划或诊断结论拆为**可独立验证的垂直切片**（tracing bullet），产出一份可被下游直接接手的**切片计划** `slices.md`。
+> `slices.md` 借鉴高质量 plan 的纪律——以厚 Context（已确认决策 + 关键核实结论）开篇，按依赖排序的切片展开，
+> 每切片标注保留/不动，并以分层验证收口；同时保留 HITL/AFK 标记、用户确认与 issue 发布流程。
+
+## 输入
+
+- `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 引用）
+
+## 产物
+
+- `speculo/.speculo/dev/<change>/slices.md`，由 `../_templates/issues-slices-template.md` 填写
+
+## `slices.md` 结构规范
+
+`issues-slices-template.md` 提供模板骨架；AI 填写时按下述结构展开。`[必填]` 段每份都要，`[条件]` 段有则填、单文件小改可省。
+> 最小形态（单文件小改）：§0(简) + §1 + §3(单切片) + §5 + §8。复杂 change：全段铺开。
+
+### 0. 战略与背景（Context）—— [必填]
+
+本段是整份切片计划的决策锚点，含四块：
+
+- **一句话战略**：单句概括「做什么 + 为什么 + 怎么做到（以现有系统为基底 / 新建 / 复用）」。
+- **已确认决策**：逐条列出与用户拍板的范围/取舍决策，防止下游重新扯皮。**有 `decision-log.md` 则继承其「已确认决策」段；独立进入（无上游）时在此自采集**。
+- **关键核实结论**：探索阶段确认的事实（依赖关系、唯一调用点、可删/须留边界等）。**必须显式写明「行号为近似、实施时以现场代码为准」**，避免下游照搬过期行号。
+- **预期产出**：1–2 句描述本 change 完成后的可观察结果。
+
+### 1. 范围边界（IN / REUSE / OUT）—— [必填]
+
+三列表格，逐条列出：
+- **IN** —— 本次必造的新能力（每项可对应后续一个或多个切片）
+- **REUSE** —— 复用现有系统的能力（不改动，只收编进新地基）
+- **OUT** —— 本期不做、留给后续迭代的内容（吸收「明确不做」边界）
+
+表格来源优先从 PRD 或用户指令提取；若来源未明确，用 `[待确认]` 标记并提请用户补充。
+
+### 2. 架构上下文 —— [条件]
+
+若 change 涉及多模块或改动既有架构，本节记录：
+- 涉及的 `core/` / `src/` / `src-tauri/`（或本项目对应分层）模块及其职责分工
+- 新增模块的定位（一句话职责 + 落点目录）
+- 不可逾越约束（来自 `AGENTS.md` 或 PRD 的硬性规则）
+- 可选 ASCII 分层图，标出依赖方向（如 `src → core → src-tauri`）
+
+单文件修复或热点 patch 可省略本节。
+
+### 3. 切片（slices）—— [必填]
+
+每个切片是**一个从数据到 UI 的端到端闭环**（窄而完整）。切片按依赖顺序排列；每个切片包含：
+
+```markdown
+### 切片 N · 切片名称
+<phase id="<phase-id>" status="未开始"><!-- 未开始 → 已实现(dev/03) → 已验证(dev/04) --></phase>
+
+- **类型：** `AFK` | `HITL`
+- **阻塞于：** 切片 M（或「无」）
+- **覆盖：** PRD 章节 / US 编号 / 用户故事简述
+- **交付物：** 该切片产出的具体文件/模块/功能清单
+- **保留/不动：** 本切片**不能碰**的代码/契约/数据（如冻结常量、共享依赖、邻近功能）；无则写「无」
+- **复用：** 复用哪些现有能力（模块/文件/命令）
+- **验收切片：** 一个可独立执行的验证命令或手动检查步骤，证明本切片完成；**删除型切片须含残留扫描**（如 `grep -rn "<符号>" <范围>` 应 0 命中）
+- **对齐：** PRD FR-xxx 或 issue 引用
+- **ADR 引用：** （可选）关联的工程层 ADR 编号
+```
+
+- `<phase id="...">` 是稳定的阶段标识（如 `phase0-node-base`、`phase1-templates`），供 `dev/03` TDD 工作流引用。单阶段 change 用 `phase0-<slug>`。
+- `status` 枚举：`未开始`（切片创建时） → `已实现`（TDD finish 置入） → `已验证`（finalize 置入）。状态只前进不回退。
+- 切片改动面较宽时，可在「交付物」下用 `| 文件 | 改动 |` 表逐文件列出（新增/修改/删除/**保留**），提升信息密度。
+
+### 4. 横切关注点与铁律（贯穿所有切片）—— [必填]
+
+列出跨切片一致的规则、约束与不可违反的铁律，如：
+- **数据安全铁律**：必须冻结的常量 / wire-format / 密文格式（改了即用户数据损坏）——显式列出，标「不动」。
+- **契约先行**：磁盘契约先改 zod + fixtures 再改解析。
+- **删缓存可重建**铁律。
+- 范围隔离规则（不 import 旧子系统等）、命名消歧规则。
+- **行号现场核对纪律**：本计划内所有行号为近似，实施时以现场代码为准。
+
+### 5. 依赖顺序速查 —— [必填]
+
+ASCII 依赖链，展示切片先后顺序：
+
+```
+P0  切片0  名称    ← 不可回退,最先
+P1  切片1  名称
+P2  切片2  名称    依赖 P0+P1
+...
+```
+
+### 6. 风险与回滚 —— [条件]
+
+本期涉及删除、数据迁移、外部副作用或高耦合改动时填写；纯增量的单文件小改可省。逐条列出风险、触发条件、缓解与回滚手段（表格形式）。**有 `prd-overview.md` 的「风险与未知点」则继承并细化**。
+
+### 7. 退役清单 —— [条件]
+
+仅当本 change **删除既有能力**时填写：用「项 / 处置 / 验证」表逐条记录被删/被迁的内容及其去向，作为兜底核对。
+
+### 8. 验证总览 —— [必填（轻）]
+
+change 级验证 roll-up，补足每切片「验收切片」的整体闭环（按适用项填，不适用标「N/A」）：
+- **静态检查**：构建 / 类型 / lint。
+- **测试**：单测 / 契约校验。
+- **残留扫描**：对删除项 grep，应 0 命中。
+- **E2E 冒烟**：真实运行应用走查关键路径。
+- **迁移测试**：若涉及持久化 / 格式 / 键名迁移，预置旧数据验证向后兼容。
+
+> **判据：** 每个切片的「验收切片」全部通过即该切片完成；§8 验证总览整体通过 = change 可进入 `dev/04` 收尾。
+
+## 存疑时的提问协议（决策树）
+
+切分切片或填 §0「已确认决策」时若有未决分支，**不要臆测**——用 `AskUserQuestion` 按决策树逐一锁定；本协议产出的共识即写入 §0：
+
+1. **定位关键问题**：识别当前最影响方案正确性的那一个未决问题。
+2. **先查后问**：若答案能用本地代码 / 文档 / 配置确认，先读相关材料；能定则不问。
+3. **一次一问**：每次只问一个问题，不打包问题组。
+4. **带推荐**：每个问题给出推荐答案并说明理由。
+5. **回答后收敛**：用户回答后，更新 §0「已确认决策」与剩余分支。
+6. **遍历至共识**：沿决策树继续，直到核心分支达成共识或用户叫停。
+
+## 填写引导
+
+1. 遵循 `I-to-issues.md` 的内置切片指引与「切片计划质量准则」，以及本文件的结构规范。
+2. **写 Context（§0）**：提炼一句话战略；**采集或继承已确认决策**（有 `decision-log.md` 则继承）与**关键核实结论**（写明行号为近似、现场核对）；点明预期产出。未决分支按「存疑时的提问协议」逐一锁定。
+3. **采集范围**：从 PRD / decision-log / diagnosis / 用户指令中提取 IN/REUSE/OUT 三列、架构上下文和 ADR 引用；不确定的标记 `[待确认]`。
+4. **切分垂直切片**：优先窄而完整、优先 AFK；每个切片必须有用户可独立验证的「验收切片」，并标注**保留/不动**；删除型切片在验收里配残留扫描。
+5. **标注 phase id**：为每个切片生成稳定的 `<phase id="...">` 标识（kebab-case），供 TDD 阶段直接引用。
+6. **填条件段**：涉及删除 / 迁移 / 外部副作用时补 §6 风险与回滚、§7 退役清单；多模块时补 §2 架构上下文。
+7. **收口验证（§8）**：列出静态 / 测试 / 残留扫描 / E2E / 迁移的整体验证项。
+8. 用编号列表向用户确认粒度、依赖、HITL/AFK 标记、phase id 和是否需要发布外部 issue。
+9. 按依赖顺序记录切片；发布外部 issue 时也按依赖顺序发布。
+10. 迭代直到用户批准分解；未批准前不发布外部 issue。
+
+## 边界
+
+- 不关闭或修改父级 issue。
+- 不默认发布到外部 tracker。
+- 不写实现代码。
+- 不编造来源；PRD/ADR/issue 引用必须真实存在。
+- 不照搬过期行号：所有行号为近似，实施期以现场代码为准。
+
+## 完成准则
+
+- `slices.md` 无残留 `[TODO:]`
+- §0 战略与背景含已确认决策与关键核实结论（独立进入时自采集，有上游则继承）
+- 存疑点已按「存疑时的提问协议」逐一与用户锁定，或显式标记 `[待确认]`
+- 每个切片都有 `<phase id="...">` 标识、类型、依赖、覆盖来源、验收切片；删除型切片标注保留/不动且验收含残留扫描
+- IN/REUSE/OUT 表格完整（无法确定时标 `[待确认]` 并已获用户补充）
+- §8 验证总览存在（静态 / 残留扫描 / 冒烟按适用项填）
+- 适用时已填条件段（§2 架构 / §6 风险 / §7 退役）
+- `.status.json` 已记录 `slice_count`、`hitl_slice_count` 和 `issue_tracker_mode`

package/{speculo → template}/workflows/dev/R-review/R-review.md

@@ -10,7 +10,7 @@ keywords: [review, diff, spec, engineering, standards, security, solid, pr, 审
 
 本工作流是 `dev/R` 入口，用于审查 `HEAD` 与用户提供的固定点之间的 diff。审查以**资深工程师视角**进行，结果必须分成三个**互相独立、互不掩盖**的维度，每条 finding 带严重度，最后给出整体裁决。
 
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-review-auth-module`）。审查产物写入 `.speculo/dev/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-review-auth-module`）。审查产物写入 `speculo/.speculo/dev/<change>/`。
 
 ## 内置指引
 

package/{speculo → template}/workflows/dev/R-review/review-axes.md

@@ -2,7 +2,7 @@
 
 ## 输入
 
-- `.speculo/dev/<change>/review-sources.md`
+- `speculo/.speculo/dev/<change>/review-sources.md`
 - `git diff <fixed-point>...HEAD`
 - spec 来源文件或 `no spec available`
 - standards 来源文件或覆盖空白说明
@@ -10,7 +10,7 @@
 
 ## 产物
 
-- `.speculo/dev/<change>/review-report.md`，由 `../_templates/review-report-template.md` 填写
+- `speculo/.speculo/dev/<change>/review-report.md`，由 `../_templates/review-report-template.md` 填写
 
 ## 填写引导
 

package/{speculo → template}/workflows/dev/R-review/review-setup.md

@@ -4,11 +4,11 @@
 
 - 用户提供的 fixed point；如果缺失，先询问
 - 当前 git 仓库
-- 当前 change 目录：`.speculo/dev/<change>/`
+- 当前 change 目录：`speculo/.speculo/dev/<change>/`
 
 ## 产物
 
-- `.speculo/dev/<change>/review-sources.md`，由 `../_templates/review-sources-template.md` 填写
+- `speculo/.speculo/dev/<change>/review-sources.md`，由 `../_templates/review-sources-template.md` 填写
 
 ## 填写引导
 
@@ -22,12 +22,12 @@
 5. 寻找 spec 来源，顺序为：
    - commit message 中的 issue / PR 引用
    - 用户作为参数传入的路径
-   - `.speculo/dev/<change>/prd.md`、`slices.md`、`decision-log.md`
+   - `speculo/.speculo/dev/<change>/prd.md`、`slices.md`、`decision-log.md`
    - 仓库中与分支名或功能匹配的规格文档
 6. 寻找 standards 来源，常见路径包括：
-   - `.speculo/.config/RULES.md`
-   - `.speculo/.config/context/`
-   - `.speculo/.config/adr/`
+   - `speculo/.speculo/.config/RULES.md`
+   - `speculo/.speculo/.config/context/`
+   - `speculo/.speculo/.config/adr/`
    - `AGENTS.md`、`CONTRIBUTING.md`
    - `.editorconfig`、`eslint.config.*`、`biome.json`、`prettier.config.*`、`tsconfig.json`
 7. 机器强制的标准只记录来源，不重复检查工具已覆盖的内容。

package/{speculo → template}/workflows/dev/R-review/review-verdict.md

@@ -2,12 +2,12 @@
 
 ## 输入
 
-- `.speculo/dev/<change>/review-report.md`（三维度 findings）
+- `speculo/.speculo/dev/<change>/review-report.md`（三维度 findings）
 - `.status.json` 的 `severity_summary`
 
 ## 产物
 
-- `.speculo/dev/<change>/review-verdict.md`，由 `../_templates/review-verdict-template.md` 填写
+- `speculo/.speculo/dev/<change>/review-verdict.md`，由 `../_templates/review-verdict-template.md` 填写
 
 ## 填写引导
 

package/{speculo → template}/workflows/dev/_templates/completion-summary-template.md

@@ -22,4 +22,4 @@
 
 ## 归档记录
 
-[TODO: 归档时间、源路径 → `.speculo/archive/dev/<YYYY-MM>/<change>/`、用户确认记录。]
+[TODO: 归档时间、源路径 → `speculo/.speculo/archive/dev/<YYYY-MM>/<change>/`、用户确认记录。]

package/{speculo → template}/workflows/dev/_templates/docs-sync-report-template.md

@@ -26,4 +26,4 @@
 
 ## State
 
-[TODO: 记录 `.speculo/dev/docs-sync-state.json` 的 old/new baseline。]
+[TODO: 记录 `speculo/.speculo/dev/docs-sync-state.json` 的 old/new baseline。]

package/template/workflows/dev/_templates/issues-slices-template.md

@@ -0,0 +1,88 @@
+> **服务工作流：** `../I-to-issues/I-to-issues.md`
+> **产物文件名：** `slices.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
+
+# 切片计划（Vertical Slices）
+
+> 本文件是一份可被下游直接接手的切片计划：以厚 Context（已确认决策 + 关键核实结论）开篇，
+> 按依赖排序的切片展开，每切片标注保留/不动，并以分层验证收口。
+> 每个切片有 `<phase id="...">` 标识，供 TDD 工作流直接引用。
+> 标「条件段」的小节按需填写；单文件小改的最小形态为 §0(简) + §1 + §3(单切片) + §5 + §8。
+
+## 0. 战略与背景（Context）
+
+- **一句话战略：** [TODO: 做什么 + 为什么 + 怎么做到（新建 / 复用 / 以现有系统为基底）。]
+- **已确认决策：** [TODO: 逐条列出与用户拍板的范围/取舍决策；有 decision-log.md 则继承其「已确认决策」段。]
+- **关键核实结论：** [TODO: 探索确认的事实（依赖 / 唯一调用点 / 可删须留边界）。注明：行号为近似，实施时以现场代码为准。]
+- **预期产出：** [TODO: 1–2 句，本 change 完成后的可观察结果。]
+
+## 1. 范围边界（IN / REUSE / OUT）
+| | 内容 |
+|---|---|
+| **IN 必造** | [TODO: 本次必造的新能力] |
+| **REUSE 复用现有** | [TODO: 复用不改动的现有能力] |
+| **OUT 本期不做** | [TODO: 留给后续迭代的内容 / 明确不做] |
+
+## 2. 架构上下文
+[TODO: 条件段——涉及的模块与职责分工、新增模块定位、不可逾越约束；可附 ASCII 分层图与依赖方向。单文件修复可删除本节。]
+
+## 3. 切片
+
+### 切片 1 · [切片名称]
+<phase id="[phase-id]" status="未开始"><!-- 未开始 → 已实现(dev/03) → 已验证(dev/04) --></phase>
+
+- **类型：** AFK | HITL
+- **阻塞于：** 无
+- **覆盖：** [TODO: PRD 章节 / US 编号 / 用户故事]
+- **交付物：** [TODO: 具体文件/模块/功能；改动面宽时可用 | 文件 | 改动 | 表逐文件列出]
+- **保留/不动：** [TODO: 本切片不能碰的代码/契约/数据；无则写「无」]
+- **复用：** [TODO: 复用哪些现有能力]
+- **验收切片：** [TODO: 可独立执行的验证命令或步骤；删除型须含残留扫描 grep 0 命中]
+- **对齐：** [TODO: PRD FR-xxx 或 issue 引用]
+- **ADR 引用：** [TODO: 关联的 ADR 编号，可选]
+
+### 切片 2 · [切片名称]
+<phase id="[phase-id]" status="未开始"><!-- 未开始 → 已实现(dev/03) → 已验证(dev/04) --></phase>
+
+- **类型：** AFK | HITL
+- **阻塞于：** 切片 1
+- **覆盖：** [TODO]
+- **交付物：** [TODO]
+- **保留/不动：** [TODO]
+- **复用：** [TODO]
+- **验收切片：** [TODO]
+- **对齐：** [TODO]
+- **ADR 引用：** [TODO]
+
+[TODO: 按需增加更多切片，每个有独立的 phase id]
+
+## 4. 横切关注点与铁律
+[TODO: 跨切片一致的规则、约束与不可违反的铁律（数据安全冻结常量、契约先行、删缓存可重建、范围隔离、命名消歧）；并声明「行号为近似，实施时现场核对」。]
+
+## 5. 依赖顺序速查
+```
+[TODO: ASCII 依赖链，如:
+P0  phase0-xxx  切片名称  ← 不可回退,最先
+P1  phase1-xxx  切片名称  依赖 P0
+]
+```
+
+## 6. 风险与回滚
+[TODO: 条件段——本期涉及删除/数据迁移/外部副作用/高耦合时填：风险 / 触发条件 / 缓解 / 回滚 表；有 prd-overview.md 风险则继承细化。纯增量小改可删除本节。]
+
+## 7. 退役清单
+[TODO: 条件段——仅当删除既有能力时填：项 / 处置 / 验证 表，逐条记录被删或被迁内容及其去向。无删除则删除本节。]
+
+## 8. 验证总览
+[TODO: change 级验证 roll-up，按适用项填、不适用标 N/A：
+- 静态检查（构建 / 类型 / lint）
+- 测试（单测 / 契约）
+- 残留扫描（删除项 grep 应 0 命中）
+- E2E 冒烟（真实运行走查关键路径）
+- 迁移测试（涉及持久化 / 格式 / 键名迁移时预置旧数据验证）]
+
+## 用户确认
+[TODO: 记录用户对粒度、依赖、HITL/AFK 标记、phase id 和发布策略的确认。]
+
+## 发布记录
+[TODO: 若发布到外部 issue tracker，记录 issue 引用；否则写明 local-only。]

package/{speculo → template}/workflows/dev/_templates/tdd-plan-template.md

@@ -10,6 +10,12 @@
 ## 切片来源
 [TODO: 记录来自 PRD、slices、diagnosis 还是用户直接请求。]
 
+## 保留/不动（约束）
+[TODO: 承接本切片「保留/不动」：实现中不能碰的代码/契约/数据（冻结常量、共享依赖、邻近功能）；无则写「无」。]
+
+## 现场核对（关键核实结论复核）
+[TODO: 承接本切片「关键核实结论」，并以现场代码复核其依赖/调用点/边界；切片行号为近似，记录现场实际位置。]
+
 ## 公共接口
 [TODO: 描述需要新增或修改的公共接口、命令、页面、API 或模块边界。]
 
@@ -21,3 +27,6 @@
 
 ## 验证命令
 [TODO: 列出应运行的测试、类型检查、lint 或构建命令。]
+
+## 验收切片（承接 slices）
+[TODO: 承接本切片「验收切片」：Finish 阶段须运行的可独立验证命令/步骤；删除型切片含残留扫描（`grep` 应 0 命中）。]

package/{speculo → template}/workflows/dev/_templates/tdd-verification-template.md

@@ -10,11 +10,17 @@
 ## 已运行命令
 [TODO: 列出实际运行的测试、类型检查、lint 或构建命令及结果。]
 
+## 验收切片结果（含残留扫描）
+[TODO: 承接 slices 本切片「验收切片」的运行结果；删除型切片记录残留扫描命令与命中数（应 0）。]
+
 ## 未运行命令
 [TODO: 列出未运行但相关的命令，以及原因。]
 
 ## 调试残留检查
 [TODO: 记录临时日志、DEBUG 标记、一次性脚本和推测性功能的清理结果。]
 
+## 保留/不动核对
+[TODO: 核对实现未触碰本切片「保留/不动」清单（冻结常量 / 共享依赖 / 邻近功能）；逐项标 OK 或说明偏离。]
+
 ## 完成结论
 [TODO: 说明 change 是否已完成、仍被阻塞或需要后续 review/handoff。]

package/{speculo → template}/workflows/doc/00-INDEX.md

@@ -8,9 +8,11 @@ keywords: [doc, writing, article, fragments, edit, 文档, 写作]
 
 # Doc Workflow Index
 
-本文件是 doc 分类的导航入口。进入时先读取 `../../.speculo/doc-status.json`，再按其中 active change 读取 `../../.speculo/doc/<change>/.status.json`，根据用户意图推荐横向 workflow。
+> ⚠️ **持久化铁律：本文件及所有 doc workflow 的全部产物，必须且只能写入 `speculo/.speculo/doc/<change>/`。绝对禁止写入项目根目录的 `.speculo/`、`temp/` 或其他任何非规范位置。**
 
-> **命名铁律：** 所有 change 目录必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-draft`）。不符合此格式的目录视为 `malformed`，仅汇报不自动操作。详见 `../../docs/persistence-contract.md` §0。
+本文件是 doc 分类的导航入口。进入时先读取 `speculo/.speculo/doc-status.json`，再按其中 active change 读取 `speculo/.speculo/doc/<change>/.status.json`，根据用户意图推荐横向 workflow。
+
+> **命名铁律：** 所有 change 目录必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-draft`）。不符合此格式的目录视为 `malformed`，仅汇报不自动操作。
 
 ## 入口别名
 
@@ -25,10 +27,10 @@ keywords: [doc, writing, article, fragments, edit, 文档, 写作]
 
 ## 进入协议
 
-1. 若用户未指定 change，扫描 `../../.speculo/doc-status.json` 和 `../../.speculo/doc/*/.status.json`，列出 active changes。
+1. 若用户未指定 change，扫描 `speculo/.speculo/doc-status.json` 和 `speculo/.speculo/doc/*/.status.json`，列出 active changes。
    - **命名校验**：扫描时仅处理符合 `YYYY-MM-DD-<kebab-name>` 格式的目录。不符合的目录标记为 `malformed`，单独列出路径并提示用户修复或手动清理，不自动删除或重命名。
 2. 若只有一个 active change，默认继续该 change；若有多个 active change，要求用户选择。
-3. 若没有 active change，按用户意图创建新的 doc change 目录，**目录名必须为 `YYYY-MM-DD-<kebab-name>`**（使用当前日期，`<kebab-name>` 从用户意图提取），并初始化 `.status.json` 与 `../../.speculo/doc-status.json`。
+3. 若没有 active change，按用户意图创建新的 doc change 目录，**目录名必须为 `YYYY-MM-DD-<kebab-name>`**（使用当前日期，`<kebab-name>` 从用户意图提取），并初始化 `.status.json` 与 `speculo/.speculo/doc-status.json`。
 4. 推荐入口时优先使用用户显式别名；没有别名时按用户意图推荐一个横向 workflow。
 5. 执行任何 workflow 前，读取该 workflow 入口文件、阶段文件和模板。
 

package/{speculo → template}/workflows/doc/B-writing-beats/B-writing-beats.md

@@ -10,7 +10,7 @@ keywords: [beats, narrative, article, writing, 叙事, 文章]
 
 本工作流用于把文章塑造成一段由 beat 组成的旅程。用户从原始素材中选择起始 beat；执行者只写当前 beat，然后给出下一步转向选项，直到文章自然结束。
 
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-notes`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-notes`）。产物写入 `speculo/.speculo/doc/<change>/`。
 
 ## 内置指引
 
@@ -21,13 +21,13 @@ keywords: [beats, narrative, article, writing, 叙事, 文章]
 ### 输入
 
 - 用户提供的原始素材 Markdown 路径，或同 change 的 `fragments.md`
-- 当前文章文件：默认 `.speculo/doc/<change>/article.md`
-- 当前 doc change 目录：`.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-article-notes`）
+- 当前文章文件：默认 `speculo/.speculo/doc/<change>/article.md`
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-article-notes`）
 
 ### 输出
 
-- `.speculo/doc/<change>/article.md`
-- `.speculo/doc/<change>/beat-log.md`
+- `speculo/.speculo/doc/<change>/article.md`
+- `speculo/.speculo/doc/<change>/beat-log.md`
 - 每轮 2-3 个候选下一个 beat
 
 ### 执行原则

package/{speculo → template}/workflows/doc/B-writing-beats/writing-beats-append.md

@@ -3,12 +3,12 @@
 ## 输入
 
 - 用户在 Beat Options 阶段选择的 beat
-- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/article.md`
+- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/article.md`
 
 ## 产物
 
-- `.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
 
 ## 填写引导
 

package/{speculo → template}/workflows/doc/B-writing-beats/writing-beats-options.md

@@ -2,13 +2,13 @@
 
 ## 输入
 
-- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
-- `.speculo/doc/<change>/beat-log.md`
+- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
+- `speculo/.speculo/doc/<change>/beat-log.md`
 
 ## 产物
 
-- `.speculo/doc/<change>/beat-log.md`，由 `../_templates/writing-beat-options-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/beat-log.md`，由 `../_templates/writing-beat-options-template.md` 填写或追加
 
 ## 填写引导
 

package/{speculo → template}/workflows/doc/E-edit-article/E-edit-article.md

@@ -10,7 +10,7 @@ keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
 
 本工作流用于编辑已有文章草稿。先按标题和信息依赖确认章节顺序，再逐节重写，提升清晰度、连贯性和流畅度。
 
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-edit-article`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-edit-article`）。产物写入 `speculo/.speculo/doc/<change>/`。
 
 ## 内置指引
 
@@ -20,14 +20,14 @@ keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
 
 ### 输入
 
-- 用户提供的文章草稿路径，或 `.speculo/doc/<change>/article.md`
+- 用户提供的文章草稿路径，或 `speculo/.speculo/doc/<change>/article.md`
 - 用户明确的发布目标、语气偏好或约束
-- 当前 doc change 目录：`.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-edit-article`）
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-edit-article`）
 
 ### 输出
 
-- `.speculo/doc/<change>/edit-plan.md`
-- `.speculo/doc/<change>/edited-article.md`
+- `speculo/.speculo/doc/<change>/edit-plan.md`
+- `speculo/.speculo/doc/<change>/edited-article.md`
 - 已确认的章节顺序、依赖关系和逐节编辑结果
 
 ### 执行原则

package/{speculo → template}/workflows/doc/E-edit-article/edit-article-plan.md

@@ -2,12 +2,12 @@
 
 ## 输入
 
-- 用户提供的文章草稿路径，或 `.speculo/doc/<change>/article.md`
+- 用户提供的文章草稿路径，或 `speculo/.speculo/doc/<change>/article.md`
 - 用户明确的语气、长度、发布目标和不可改变的主张
 
 ## 产物
 
-- `.speculo/doc/<change>/edit-plan.md`，由 `../_templates/edit-article-plan-template.md` 填写
+- `speculo/.speculo/doc/<change>/edit-plan.md`，由 `../_templates/edit-article-plan-template.md` 填写
 
 ## 填写引导
 

package/{speculo → template}/workflows/doc/E-edit-article/edit-article-rewrite.md

@@ -2,13 +2,13 @@
 
 ## 输入
 
-- `.speculo/doc/<change>/edit-plan.md`
+- `speculo/.speculo/doc/<change>/edit-plan.md`
 - 用户确认后的章节顺序
 - 原始草稿
 
 ## 产物
 
-- `.speculo/doc/<change>/edited-article.md`，由 `../_templates/edit-article-template.md` 填写
+- `speculo/.speculo/doc/<change>/edited-article.md`，由 `../_templates/edit-article-template.md` 填写
 
 ## 填写引导