@namewta/speculo 0.1.0 → 0.1.2

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

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

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

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

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

@@ -3,14 +3,27 @@
 
 # Review Report
 
-## Standards
-
-[TODO: 按 Standards 维度列出 findings；引用文件/行或 hunk，以及对应标准来源。]
+> 每条 finding 格式：`[严重度] [file:line 或 hunk] 标题` + 问题描述 + 修复建议 + 来源引用。
+> 严重度取值 P0 / P1 / P2 / P3，见 `../R-review/R-review.md` 的严重度模型。
 
 ## Spec
 
-[TODO: 按 Spec 维度列出 findings；引用 spec 来源。若缺失 spec，写 `no spec available`。]
+[TODO: 按 Spec 维度列出 findings（缺失需求、范围蔓延、看似实现但有问题的需求），引用 spec 原文。缺失 spec 时写 `no spec available`。]
+
+## Engineering
+
+### SOLID 与架构
+[TODO: 依据 `../R-review/solid-checklist.md` 列出 findings。]
 
-## Summary
+### 安全与可靠性
+[TODO: 依据 `../R-review/security-checklist.md` 列出 findings，含可利用性与影响。]
+
+### 代码质量
+[TODO: 依据 `../R-review/code-quality-checklist.md` 列出 findings。]
+
+### 删除候选
+[TODO: 依据 `../R-review/removal-checklist.md` 列出死代码 / 删除候选与计划。]
+
+## Standards
 
-[TODO: 一行总结每个维度 findings 数量和最严重单个问题。]
+[TODO: 按 Standards 维度列出违反已记录标准的 findings，引用标准来源；无成文标准时记录覆盖空白。]

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

@@ -15,10 +15,18 @@
 
 [TODO: 粘贴或摘要 `git log <fixed-point>..HEAD --oneline`。]
 
-## Standards Sources
+## Scope
+
+[TODO: 记录 `--stat` 规模、是否大 diff、分批策略；无变更时记录处理方式。]
+
+## Critical Paths
 
-[TODO: 列出已发现的规则、上下文、ADR、贡献指南或配置文件。]
+[TODO: 列出 diff 触及的关键路径：auth / 支付 / 数据写入 / 网络 / 并发。]
 
 ## Spec Sources
 
-[TODO: 列出 PRD、issue、slices、用户路径或 `no spec available`。]
+[TODO: 列出 PRD、issue、slices、用户路径；缺失写 `no spec available`。]
+
+## Standards Sources
+
+[TODO: 列出已发现的规则、上下文、ADR、贡献指南或配置文件；无成文标准时记录覆盖空白。]

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

@@ -0,0 +1,32 @@
+> **服务工作流：** `../R-review/R-review.md`
+> **产物文件名：** `review-verdict.md`
+
+# Review Verdict
+
+## 整体裁决
+
+[TODO: APPROVE / REQUEST_CHANGES / COMMENT，并一句话说明依据。]
+
+## 严重度汇总
+
+| 严重度 | 数量 |
+|--------|------|
+| P0 | [TODO] |
+| P1 | [TODO] |
+| P2 | [TODO] |
+| P3 | [TODO] |
+
+## Clean Review 声明
+
+### 检查了什么
+[TODO: 覆盖到的文件 / 模块 / 维度。]
+
+### 未覆盖什么
+[TODO: 未审区域及原因，如未验证迁移、大 diff 抽样审查。]
+
+### 残留风险
+[TODO: 建议补充的测试或后续验证。]
+
+## 后续选项
+
+[TODO: 记录向用户给出的选项（修复全部 / 仅 P0·P1 / 指定项 / 不改动）及用户选择；未确认前不实施修复。]

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

@@ -1,33 +0,0 @@
-# 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` 已更新