@namewta/speculo 0.1.0

package/speculo/workflows/dev/H-diagnose/diagnose-loop.md

@@ -0,0 +1,32 @@
+# Diagnose Loop Phase
+
+## 输入
+
+- 用户描述的失败现象、日志、trace、性能症状或失败测试
+- 可运行的测试、脚本、服务、CLI 或浏览器自动化
+- `H-diagnose.md` 中的内置诊断指引
+- 同目录 `diagnose-guide.md`
+
+## 产物
+
+- `.speculo/dev/<change>/diagnosis.md`，由 `../_templates/diagnosis-template.md` 填写
+
+## 填写引导
+
+1. 遵循 `H-diagnose.md` 的内置诊断指引，并按需读取 `diagnose-guide.md`。
+2. 先建立快速、确定、可信的反馈循环。
+3. 没有反馈循环时停止假设阶段，记录已尝试方法和需要用户提供的材料。
+4. 复现后提出 3-5 个排序假设，并把每个假设写成可证伪预测。
+5. 插桩必须映射到具体预测，并使用可清理的唯一调试标记。
+6. 性能回退先建立基线测量，再二分或假设检验；先测量，后修复。
+
+## 边界
+
+- 不在未复现或无可信反馈循环时进入修复。
+- 不把无关日志批量加入代码。
+- 不默认保留一次性调试脚本。
+
+## 完成准则
+
+- `diagnosis.md` 无残留 `[TODO:]`
+- `.status.json` 已记录 `feedback_loop` 和 `hypothesis_status`

package/speculo/workflows/dev/H-diagnose/scripts/hitl-loop.template.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# 人在环路的复现循环。
+# 复制此文件，编辑下方步骤，然后运行。
+# agent 运行脚本；用户在终端中跟随提示操作。
+#
+# 用法：
+#   bash hitl-loop.template.sh
+#
+# 两个辅助函数：
+#   step "<指令>"          → 显示指令，等待 Enter
+#   capture VAR "<问题>"   → 显示问题，将回答读入 VAR
+#
+# 结束时，捕获的值以 KEY=VALUE 格式打印供 agent 解析。
+
+set -euo pipefail
+
+step() {
+  printf '\n>>> %s\n' "$1"
+  read -r -p "    [完成后按 Enter] " _
+}
+
+capture() {
+  local var="$1" question="$2" answer
+  printf '\n>>> %s\n' "$question"
+  read -r -p "    > " answer
+  printf -v "$var" '%s' "$answer"
+}
+
+# --- edit below ---------------------------------------------------------
+
+step "在浏览器中打开 http://localhost:3000 并登录。"
+
+capture ERRORED "点击「导出」按钮。是否报错了？(y/n)"
+
+capture ERROR_MSG "粘贴错误信息（或输入 'none'）："
+
+# --- edit above ---------------------------------------------------------
+
+printf '\n--- 已捕获 ---\n'
+printf 'ERRORED=%s\n' "$ERRORED"
+printf 'ERROR_MSG=%s\n' "$ERROR_MSG"

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

@@ -0,0 +1,70 @@
+---
+id: dev/I-to-issues
+category: dev
+name: To Issues
+description: 将 PRD、计划或诊断结论拆成可独立接手的垂直切片 issue
+keywords: [issues, slices, vertical, AFK, HITL, 切片]
+---
+
+# To Issues 工作流执行指引
+
+本工作流是 `dev/I` 入口。它既可独立执行，也可嵌入 `dev/01`、`dev/02`、`dev/03` 或 `dev/H`，用于生成垂直切片。垂直切片和 issue 发布指引已内置在本 workflow 目录中。
+
+## 内置指引
+
+使用垂直切片（示踪弹）将计划、规格或 PRD 分解为可独立接手的 issue。
+
+### 输入
+
+- PRD、计划、设计记录、bug 诊断结论或当前对话上下文
+- 用户明确提供的 issue tracker 配置和标签词汇表（如果存在）
+- 当前 change 目录：`.speculo/dev/<change>/`
+
+### 输出
+
+- `.speculo/dev/<change>/slices.md`
+- 垂直切片清单、依赖关系、HITL/AFK 标记和验收标准
+- 可选的外部 issue 引用
+
+### 垂直切片规则
+
+- 每个切片交付一条贯穿所有层（schema、API、UI、测试）的窄但完整的路径。
+- 完成的切片可独立演示或验证。
+- 优先选择多个薄切片而非少数厚切片。
+
+切片可以是 `HITL` 或 `AFK`。HITL 切片需要人类交互，例如架构决策或设计评审。AFK 切片可以在无人类交互的情况下实现和合并。尽可能优先选择 AFK 而非 HITL。
+
+默认只生成本地切片计划。只有 tracker 已配置且用户明确要求时，才发布外部 issue；发布时按依赖顺序发布，以便被阻塞字段引用真实 issue 标识符。不要关闭或修改任何父级 issue。
+
+## 阶段
+
+### 1. Slice Issues — 垂直切片分解
+- 规范：`issues-slices.md`
+- 模板：`../_templates/issues-slices-template.md`
+- 产物：`slices.md`
+- 完成准则：
+  - 每个切片都有标题、类型、依赖、覆盖的用户故事或来源
+  - 已确认粒度、依赖和 HITL/AFK 标记
+  - `slices.md` 无残留 `[TODO:]`
+
+## 依赖
+
+- 软依赖：`../02-prd/02-prd.md`，scope: same-change
+- 硬依赖：无；可从用户计划、issue、诊断结论或 PRD 直接进入
+
+## 状态扩展字段
+
+本工作流需在同 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 使用状态
+
+## 完成与状态更新
+
+- 默认只生成本地 `slices.md`。
+- 只有 tracker 已配置且用户明确要求时才发布外部 issue。
+- 完成后不自动完成 change；通常移交 `../03-tdd/03-tdd.md`。

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

@@ -0,0 +1,31 @@
+# Slice Issues Phase
+
+## 输入
+
+- `prd.md`、`decision-log.md`、`diagnosis.md`、现有 issue 或用户计划
+- 可选 issue tracker 配置和标签词汇表
+- `I-to-issues.md` 中的内置切片指引
+
+## 产物
+
+- `.speculo/dev/<change>/slices.md`，由 `../_templates/issues-slices-template.md` 填写
+
+## 填写引导
+
+1. 遵循 `I-to-issues.md` 的内置切片指引。
+2. 先本地起草切片，按垂直切片原则覆盖端到端行为。
+3. 用编号列表向用户确认粒度、依赖、HITL/AFK 标记和是否需要发布。
+4. 按依赖顺序记录切片；发布外部 issue 时也按依赖顺序发布。
+5. 每个切片展示标题、类型、被哪些切片阻塞、覆盖的用户故事或来源。
+6. 迭代直到用户批准分解；未批准前不发布外部 issue。
+
+## 边界
+
+- 不关闭或修改父级 issue。
+- 不默认发布到外部 tracker。
+- 不写实现代码。
+
+## 完成准则
+
+- `slices.md` 无残留 `[TODO:]`
+- `.status.json` 已记录 `slice_count`、`hitl_slice_count` 和 `issue_tracker_mode`

package/speculo/workflows/dev/R-review/R-review.md

@@ -0,0 +1,82 @@
+---
+id: dev/R-review
+category: dev
+name: Review
+description: 从固定比较点开始，按 Standards 与 Spec 两个维度审查当前 diff
+keywords: [review, diff, standards, spec, pr, 审查]
+---
+
+# Review 工作流执行指引
+
+本工作流是 `dev/R` 入口，用于审查 `HEAD` 与用户提供的固定点之间的 diff。审查结果必须分成两个并行维度：Standards 与 Spec，避免一个维度掩盖另一个维度。
+
+## 内置指引
+
+### 何时使用
+
+当用户想审查分支、PR、进行中的变更，或要求 `review since <fixed-point>` 时使用。
+
+### 输入
+
+- 固定比较点：commit SHA、分支名、tag、`main`、`HEAD~5` 等
+- 当前 change 目录：`.speculo/dev/<change>/`
+- 可发现的标准来源：`.speculo/.config/RULES.md`、`.speculo/.config/context/`、`.speculo/.config/adr/`、`AGENTS.md`、`CONTRIBUTING.md`、配置文件等
+- spec 来源：当前 change 的 PRD、slices、用户提供路径、commit message 中引用的 issue 或其他规格文档
+
+### 输出
+
+- `.speculo/dev/<change>/review-sources.md`
+- `.speculo/dev/<change>/review-report.md`
+- Standards 与 Spec 两个分区的 findings，不合并、不重排
+
+### 执行原则
+
+用户说的任何东西都是固定点。若用户没有指定固定点，先询问固定点；拿到前不要继续。
+
+比较命令使用三点语法：`git diff <fixed-point>...HEAD`。同时记录 `git log <fixed-point>..HEAD --oneline`。
+
+Standards 维度检查 diff 是否违反仓库已记录标准；Spec 维度检查 diff 是否忠实实现来源 issue、PRD 或 spec。若缺少 spec，Spec 维度跳过并报告 `no spec available`。
+
+如果环境支持并行子代理，Standards 与 Spec 审查应并行执行；如果不支持，按两个独立上下文顺序执行，并在报告中保持分离。
+
+## 阶段
+
+### 1. Review Setup — 固定点与来源收集
+- 规范：`review-setup.md`
+- 模板：`../_templates/review-sources-template.md`
+- 产物：`review-sources.md`
+- 完成准则：
+  - 已记录 fixed point、diff 命令、commit 列表
+  - 已列出 standards 来源和 spec 来源，或记录 spec 缺失
+  - `review-sources.md` 无残留 `[TODO:]`
+
+### 2. Two-Axis Review — 双维度审查
+- 规范：`review-two-axis.md`
+- 模板：`../_templates/review-report-template.md`
+- 产物：`review-report.md`
+- 完成准则：
+  - Standards 与 Spec 分区独立呈现
+  - 每条 finding 有文件/行或 hunk 依据，以及对应标准或 spec 引用
+  - `review-report.md` 无残留 `[TODO:]`
+
+## 依赖
+
+- 软依赖：`../02-prd/02-prd.md` 或 `../I-to-issues/I-to-issues.md`，scope: same-change
+- 硬依赖：无；用户提供 fixed point 即可进入
+
+## 状态扩展字段
+
+本工作流需在同 change 的 `.status.json` 追加：
+
+- `dev_entry` (string) — 固定为 `dev/R`
+- `review_fixed_point` (string) — 用户提供的比较点
+- `review_diff_command` (string) — 实际使用的 diff 命令
+- `standards_sources` (array) — Standards 审查读取的规则来源
+- `spec_sources` (array) — Spec 审查读取的规格来源
+- `review_status` (collecting | reviewing | completed | blocked) — 审查状态
+
+## 完成与状态更新
+
+- 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
+- 完成 setup 后写入 fixed point、diff 命令和来源清单。
+- 完成报告后更新 `review_status`，但不自动完成 change；是否进入修复或收尾由用户决定。

package/speculo/workflows/dev/R-review/review-setup.md

@@ -0,0 +1,39 @@
+# Review Setup Phase
+
+## 输入
+
+- 用户提供的 fixed point；如果缺失，先询问
+- 当前 git 仓库
+- 当前 change 目录：`.speculo/dev/<change>/`
+
+## 产物
+
+- `.speculo/dev/<change>/review-sources.md`，由 `../_templates/review-sources-template.md` 填写
+
+## 填写引导
+
+1. 沿用用户提供的 fixed point，不自行替换为其他分支。
+2. 记录 `git diff <fixed-point>...HEAD` 和 `git log <fixed-point>..HEAD --oneline`。
+3. 寻找 spec 来源，顺序为：
+   - commit message 中的 issue / PR 引用
+   - 用户作为参数传入的路径
+   - `.speculo/dev/<change>/prd.md`、`slices.md`、`decision-log.md`
+   - 仓库中与分支名或功能匹配的规格文档
+4. 寻找 standards 来源，常见路径包括：
+   - `.speculo/.config/RULES.md`
+   - `.speculo/.config/context/`
+   - `.speculo/.config/adr/`
+   - `AGENTS.md`、`CONTRIBUTING.md`
+   - `.editorconfig`、`eslint.config.*`、`biome.json`、`prettier.config.*`、`tsconfig.json`
+5. 机器强制的标准只记录来源，不重复检查工具已覆盖的内容。
+
+## 边界
+
+- 不开始主观审查，先完成来源收集。
+- 找不到 spec 时不要编造；记录 `no spec available`。
+
+## 完成准则
+
+- fixed point、diff 命令、commit 列表已记录
+- standards 与 spec 来源已记录
+- `.status.json` 的 review setup 字段已更新

package/speculo/workflows/dev/R-review/review-two-axis.md

@@ -0,0 +1,33 @@
+# Two-Axis Review Phase
+
+## 输入
+
+- `.speculo/dev/<change>/review-sources.md`
+- `git diff <fixed-point>...HEAD`
+- standards 来源文件
+- spec 来源文件或 `no spec available`
+
+## 产物
+
+- `.speculo/dev/<change>/review-report.md`，由 `../_templates/review-report-template.md` 填写
+
+## 填写引导
+
+1. Standards 审查：阅读标准文档，再阅读 diff；报告违反已记录标准的位置，引用标准来源。
+2. Spec 审查：阅读 spec，再阅读 diff；报告缺失需求、范围蔓延、看似实现但有问题的需求，引用 spec 原文。
+3. 如果可用，使用两个并行子代理分别审查 Standards 与 Spec。
+4. 如果没有子代理，分两个独立小节顺序执行，不让 Standards 结论影响 Spec 结论。
+5. 最终报告在 `## Standards` 和 `## Spec` 下并排呈现，可以轻微清理措辞，但不要合并或重新排序 findings。
+6. 最后一行总结每个维度的 findings 数量和最严重单个问题。
+
+## 边界
+
+- 不修复代码。
+- 不把两个维度混成一个优先级列表。
+- 缺少 spec 时跳过 Spec 审查，并明确写 `no spec available`。
+
+## 完成准则
+
+- `review-report.md` 已按 Standards / Spec 分区
+- 每条 finding 有明确依据
+- `.status.json` 的 `review_status` 已更新

package/speculo/workflows/dev/_templates/diagnosis-template.md

@@ -0,0 +1,19 @@
+> **服务工作流：** `../H-diagnose/H-diagnose.md`
+> **产物文件名：** `diagnosis.md`
+
+# Diagnosis
+
+## 用户症状
+[TODO: 描述用户报告的 Bug、异常、失败测试或性能回退。]
+
+## 反馈循环
+[TODO: 描述已建立的反馈循环、运行方式、速度、稳定性和信号质量。]
+
+## 复现结果
+[TODO: 记录复现步骤、失败输出、频率和是否匹配用户症状。]
+
+## 假设列表
+[TODO: 列出 3-5 个排序假设，每个假设包含可证伪预测。]
+
+## 插桩结果
+[TODO: 记录每个探针对应的假设、观察结果和结论。]

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

@@ -0,0 +1,28 @@
+> **服务工作流：** `../D-docs-sync/D-docs-sync.md`
+> **产物文件名：** `docs-sync-report.md`
+
+# Docs Sync Report
+
+## Range
+
+[TODO: 记录 `<LAST_SYNC_SHA>..HEAD`、commit 数、文件数和 shortstat。]
+
+## Diff Summary
+
+[TODO: 记录 git log、name-status 和路径分组摘要。]
+
+## Mapping
+
+[TODO: 说明哪些变更映射到哪些 tracked docs。]
+
+## Synced Docs
+
+[TODO: 列出实际修改的文档和一句话说明；空同步时写 `[]`。]
+
+## Verification
+
+[TODO: 记录运行的校验命令、结果，或无法运行原因。]
+
+## State
+
+[TODO: 记录 `.speculo/dev/docs-sync-state.json` 的 old/new baseline。]

package/speculo/workflows/dev/_templates/docs-sync-state-template.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": 1,
+  "skill": "docs-sync",
+  "state_path": ".speculo/dev/docs-sync-state.json",
+  "tracked_docs": [],
+  "last_sync_sha": null,
+  "last_sync_short": null,
+  "last_sync_commit_subject": null,
+  "last_sync_commit_date": null,
+  "last_sync_run_at": null,
+  "previous_sync_sha": null,
+  "total_syncs": 0,
+  "synced_docs": []
+}

package/speculo/workflows/dev/_templates/grill-context-map-template.md

@@ -0,0 +1,19 @@
+> **服务工作流：** `../01-grill-with-docs/01-grill-with-docs.md`
+> **产物文件名：** `context-map.md`
+
+# Context Map
+
+## 变更目标
+[TODO: 用 1-2 段描述用户要澄清或改变的目标。]
+
+## 已读取上下文
+[TODO: 列出已读取的 CONTEXT、ADR、配置、代码路径和每个来源提供的关键事实。]
+
+## 领域术语
+[TODO: 列出已确认术语、冲突术语、模糊术语和需要用户确认的问题。]
+
+## 决策线索
+[TODO: 列出可能需要用户决策的分支、代码现实约束和 ADR 候选。]
+
+## 下一阶段问题
+[TODO: 按优先级列出 Decision Grill 阶段应该首先追问的问题。]

package/speculo/workflows/dev/_templates/grill-decision-log-template.md

@@ -0,0 +1,19 @@
+> **服务工作流：** `../01-grill-with-docs/01-grill-with-docs.md`
+> **产物文件名：** `decision-log.md`
+
+# Decision Log
+
+## 已确认决策
+[TODO: 列出已确认的术语、范围、设计或产品决策，以及用户确认依据。]
+
+## 推荐但未确认
+[TODO: 列出 agent 推荐答案、推荐理由和仍需用户确认的点。]
+
+## 开放问题
+[TODO: 列出被阻塞的问题、缺失信息和下一步需要谁提供什么。]
+
+## CONTEXT 更新
+[TODO: 列出已写入、待写入或不需要写入 CONTEXT.md 的术语项。]
+
+## ADR 候选
+[TODO: 列出符合 ADR 条件的决策、备选方案和是否已获用户确认。]

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

@@ -0,0 +1,19 @@
+> **服务工作流：** `../I-to-issues/I-to-issues.md`
+> **产物文件名：** `slices.md`
+
+# Vertical Slices
+
+## 来源
+[TODO: 记录切片来源，如 PRD、计划、诊断结论、issue 或用户请求。]
+
+## 切片列表
+[TODO: 用编号列表列出每个切片的标题、HITL/AFK 类型、依赖和覆盖的用户故事。]
+
+## 依赖顺序
+[TODO: 按可执行顺序列出切片，并说明阻塞关系。]
+
+## 用户确认
+[TODO: 记录用户对粒度、依赖、HITL/AFK 标记和发布策略的确认。]
+
+## 发布记录
+[TODO: 若发布到外部 issue tracker，记录 issue 引用；否则写明 local-only。]

package/speculo/workflows/dev/_templates/prd-overview-template.md

@@ -0,0 +1,19 @@
+> **服务工作流：** `../02-prd/02-prd.md`
+> **产物文件名：** `overview.md`
+
+# Overview
+
+## 目标区域
+[TODO: 描述本次变更涉及的业务区域、用户目标和现有入口。]
+
+## 模块全景
+[TODO: 列出相关模块、调用者、下游依赖和数据流向。]
+
+## 现有行为
+[TODO: 描述当前代码或产品已经支持什么，以及关键约束。]
+
+## 缺失能力
+[TODO: 描述为满足用户目标仍缺少的能力或行为。]
+
+## 风险与未知点
+[TODO: 列出需要在 PRD 或实现前解决的风险和未知点。]

package/speculo/workflows/dev/_templates/prd-template.md

@@ -0,0 +1,25 @@
+> **服务工作流：** `../02-prd/02-prd.md`
+> **产物文件名：** `prd.md`
+
+# PRD
+
+## Problem Statement
+[TODO: 从用户视角描述当前问题、受影响对象和为什么现在需要解决。]
+
+## Solution
+[TODO: 从用户视角描述目标方案和成功后的行为。]
+
+## User Stories
+[TODO: 用编号列表列出用户故事，格式为 "As an <actor>, I want <feature>, so that <benefit>"。]
+
+## Implementation Decisions
+[TODO: 列出模块边界、接口决策、架构选择、数据模型或 API 合同，不写易过时的具体文件路径。]
+
+## Testing Decisions
+[TODO: 描述要测试的公共行为、目标模块、测试层级和可参考的既有测试。]
+
+## Out of Scope
+[TODO: 明确本 PRD 不包含的功能、迁移、优化或发布动作。]
+
+## Further Notes
+[TODO: 记录后续切片、依赖、风险或需要用户确认的事项。]

package/speculo/workflows/dev/_templates/regression-template.md

@@ -0,0 +1,19 @@
+> **服务工作流：** `../H-diagnose/H-diagnose.md`
+> **产物文件名：** `regression.md`
+
+# Regression
+
+## 确认原因
+[TODO: 记录最终确认的根因和为什么其他假设被排除。]
+
+## 回归测试
+[TODO: 描述新增回归测试；若无法添加，记录缺少正确接缝的原因。]
+
+## 修复摘要
+[TODO: 描述修复行为、用户可见影响和不包含的范围。]
+
+## 重新验证
+[TODO: 记录原始反馈循环和相关测试的重新运行结果。]
+
+## 清理与后续
+[TODO: 记录调试残留清理、架构改善建议和后续 issue。]

package/speculo/workflows/dev/_templates/review-report-template.md

@@ -0,0 +1,16 @@
+> **服务工作流：** `../R-review/R-review.md`
+> **产物文件名：** `review-report.md`
+
+# Review Report
+
+## Standards
+
+[TODO: 按 Standards 维度列出 findings；引用文件/行或 hunk，以及对应标准来源。]
+
+## Spec
+
+[TODO: 按 Spec 维度列出 findings；引用 spec 来源。若缺失 spec，写 `no spec available`。]
+
+## Summary
+
+[TODO: 一行总结每个维度 findings 数量和最严重单个问题。]

package/speculo/workflows/dev/_templates/review-sources-template.md

@@ -0,0 +1,24 @@
+> **服务工作流：** `../R-review/R-review.md`
+> **产物文件名：** `review-sources.md`
+
+# Review Sources
+
+## Fixed Point
+
+[TODO: 记录用户提供的 fixed point。]
+
+## Diff Command
+
+[TODO: 记录 `git diff <fixed-point>...HEAD`。]
+
+## Commits
+
+[TODO: 粘贴或摘要 `git log <fixed-point>..HEAD --oneline`。]
+
+## Standards Sources
+
+[TODO: 列出已发现的规则、上下文、ADR、贡献指南或配置文件。]
+
+## Spec Sources
+
+[TODO: 列出 PRD、issue、slices、用户路径或 `no spec available`。]

package/speculo/workflows/dev/_templates/tdd-log-template.md

@@ -0,0 +1,16 @@
+> **服务工作流：** `../03-tdd/03-tdd.md`
+> **产物文件名：** `implementation-log.md`
+
+# Implementation Log
+
+## 循环记录
+[TODO: 对每轮 RED/GREEN/REFACTOR 记录切片、行为、测试、实现摘要、重构摘要和验证结果。]
+
+## 接口变化
+[TODO: 记录对公共接口、用户可见行为或集成边界的实际变化。]
+
+## 偏离计划
+[TODO: 记录实现中发现的计划偏差、原因和用户确认情况。]
+
+## 剩余切片
+[TODO: 列出尚未完成的切片、阻塞原因或已明确取消的范围。]

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

@@ -0,0 +1,19 @@
+> **服务工作流：** `../03-tdd/03-tdd.md`
+> **产物文件名：** `tdd-plan.md`
+
+# TDD Plan
+
+## 切片来源
+[TODO: 记录来自 PRD、slices、diagnosis 还是用户直接请求。]
+
+## 公共接口
+[TODO: 描述需要新增或修改的公共接口、命令、页面、API 或模块边界。]
+
+## 行为优先级
+[TODO: 列出最重要的可观察行为和测试优先级。]
+
+## 第一个 Tracing Slice
+[TODO: 描述第一条端到端薄切片、失败信号和成功判据。]
+
+## 验证命令
+[TODO: 列出应运行的测试、类型检查、lint 或构建命令。]

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

@@ -0,0 +1,16 @@
+> **服务工作流：** `../03-tdd/03-tdd.md`
+> **产物文件名：** `verification.md`
+
+# Verification
+
+## 已运行命令
+[TODO: 列出实际运行的测试、类型检查、lint 或构建命令及结果。]
+
+## 未运行命令
+[TODO: 列出未运行但相关的命令，以及原因。]
+
+## 调试残留检查
+[TODO: 记录临时日志、DEBUG 标记、一次性脚本和推测性功能的清理结果。]
+
+## 完成结论
+[TODO: 说明 change 是否已完成、仍被阻塞或需要后续 review/handoff。]