@namewta/speculo 0.1.21 → 0.2.0

package/template/workflows/dev/R-review/security-checklist.md

@@ -1,126 +0,0 @@
-# 安全与可靠性清单
-
-服务 `R-review.md` 的 **Engineering 维度**。审查 diff 是否引入安全漏洞或运行时风险时读取本文。每条命中都要同时说明**可利用性（exploitability）**与**影响（impact）**，并按下方"严重度提示"定级。
-
-## 输入 / 输出安全
-
-- **XSS**：不安全的 HTML 注入、`dangerouslySetInnerHTML`、未转义模板、`innerHTML` 赋值
-- **注入**：通过字符串拼接或模板串构造的 SQL / NoSQL / 命令 / GraphQL 注入
-- **SSRF**：用户可控 URL 在无 allowlist 校验下访问内部服务
-- **路径穿越**：用户输入未经清洗进入文件路径（`../` 攻击）
-- **原型污染**：JavaScript 中用用户输入做不安全的对象合并（`Object.assign`、带用户输入的展开）
-
-## 认证 / 授权（AuthN/AuthZ）
-
-- 读写操作缺少租户或归属（ownership）校验
-- 新端点没有 auth guard 或 RBAC 约束
-- 信任客户端传入的 role / flag / ID
-- 越权访问（IDOR —— 不安全的直接对象引用）
-- 会话固定或弱会话管理
-
-## JWT 与令牌安全
-
-- 算法混淆攻击（期望 `RS256` 却接受 `none` 或 `HS256`）
-- 弱密钥或硬编码密钥
-- 缺少 `exp` 过期或未校验
-- 敏感数据放进 JWT payload（token 是 base64，不是加密）
-- 不校验 `iss`（签发者）或 `aud`（受众）
-
-## 密钥与 PII
-
-- API key、token、凭据出现在代码 / 配置 / 日志
-- 密钥进入 git 历史，或环境变量暴露给客户端
-- 过度记录 PII 或敏感载荷
-- 错误信息缺少数据脱敏
-
-## 供应链与依赖
-
-- 未锁版本的依赖，允许恶意更新
-- 依赖混淆（私有包名冲突）
-- 从不可信源或 CDN 引入且无完整性校验
-- 含已知 CVE 的过期依赖
-
-## CORS 与响应头
-
-- 过宽的 CORS（带 credentials 时 `Access-Control-Allow-Origin: *`）
-- 缺少安全响应头（CSP、X-Frame-Options、X-Content-Type-Options）
-- 暴露内部头或堆栈信息
-
-## 运行时风险
-
-- 无界循环、递归调用或大块内存缓冲
-- 外部调用缺少超时、重试或限流
-- 请求路径上的阻塞操作（async 上下文中的同步 I/O）
-- 资源耗尽（文件句柄、连接、内存）
-- ReDoS（正则表达式拒绝服务）
-
-## 密码学
-
-- 弱算法（用于安全目的的 MD5、SHA1）
-- 硬编码 IV 或 salt
-- 只加密不认证（ECB 模式、无 HMAC）
-- 密钥长度不足
-
-## 竞态条件（Race Conditions）
-
-竞态是引发间歇性故障和安全漏洞的隐蔽缺陷，重点关注：
-
-### 共享状态访问
-- 多线程 / 协程 / 异步任务无同步地访问共享变量
-- 并发修改全局状态或单例
-- 无正确加锁的惰性初始化（double-checked locking 问题）
-- 在并发上下文使用非线程安全集合
-
-### 先检查后行动（TOCTOU）
-- `if (exists) then use` 无原子操作
-- `if (authorized) then perform`，而授权可能变化
-- 文件存在性检查后再做文件操作
-- 余额检查后扣减（金融操作）
-- 库存检查后下单
-
-### 数据库并发
-- 缺少乐观锁（`version` 列、`updated_at` 校验）
-- 缺少悲观锁（`SELECT FOR UPDATE`）
-- 无事务隔离的 read-modify-write
-- 非原子的计数器自增（应用 `UPDATE SET count = count + 1`）
-- 并发插入触发唯一约束冲突
-
-### 分布式系统
-- 共享资源缺少分布式锁
-- 领导选举竞态
-- 缓存失效竞态（写后读到脏数据）
-- 缺少正确排序的事件顺序依赖
-- 集群操作的脑裂
-
-### 需要标记的危险模式
-```
-# 危险模式：
-if not exists(key):       # TOCTOU
-    create(key)
-
-value = get(key)          # read-modify-write
-value += 1
-set(key, value)
-
-if user.balance >= amount:  # 先检查后行动
-    user.balance -= amount
-```
-
-### 追问
-- "两个请求同时进入这段代码会怎样？"
-- "这个操作是原子的，还是可被打断？"
-- "这段代码访问了哪些共享状态？"
-- "高并发下它的行为如何？"
-
-## 数据完整性
-
-- 缺少事务、部分写入或状态更新不一致
-- 持久化前校验薄弱（类型强转问题）
-- 可重试操作缺少幂等性
-- 并发修改导致的丢失更新（lost update）
-
-## 严重度提示
-
-- 可被利用的安全漏洞、数据丢失风险、敏感信息泄露 → **P0**（阻断合并）
-- 需特定条件触发但影响显著的安全 / 可靠性缺陷 → **P1**
-- 纵深防御缺口、低影响硬化项 → **P2**

package/template/workflows/dev/R-review/solid-checklist.md

@@ -1,73 +0,0 @@
-# SOLID 与架构异味清单
-
-服务 `R-review.md` 的 **Engineering 维度**。在审查 diff 的设计质量时读取本文，按 SOLID 与常见代码异味定位结构性问题，并对照下方"严重度提示"给出 P0–P3。
-
-## SOLID 异味提示
-
-### SRP（单一职责）
-
-- 一个文件承担互不相关的关注点（如 HTTP + DB + 领域规则混在一起）
-- 大类 / 大模块内聚低，存在多个变更原因
-- 函数编排了大量互不相关的步骤
-- 知道太多系统细节的 God Object
-- **追问**："这个模块只因为哪一个原因而改变？"
-
-### OCP（开闭）
-
-- 新增一种行为要修改多个 switch / if 分支
-- 功能增长需要改核心逻辑，而不是扩展点
-- 没有 plugin / strategy / hook 等变化点
-- **追问**："不动现有代码能加一个新变体吗？"
-
-### LSP（里氏替换）
-
-- 子类检查具体类型，或对基类方法抛异常
-- 重写方法弱化了前置条件、强化了后置条件
-- 子类忽略或空实现父类行为
-- **追问**："调用方无感知地替换任意子类能成立吗？"
-
-### ISP（接口隔离）
-
-- 接口方法很多，实现者大多用不到
-- 调用方为很窄的需求依赖很宽的接口
-- 接口方法出现空 / 桩实现
-- **追问**："每个实现者都用到了全部方法吗？"
-
-### DIP（依赖倒置）
-
-- 高层逻辑直接依赖具体 IO、存储或网络类型
-- 硬编码实现，而不是抽象或注入
-- import 链把业务逻辑耦合到基础设施
-- **追问**："不改业务逻辑能换掉实现吗？"
-
-## 常见代码异味（SOLID 之外）
-
-| 异味 | 信号 |
-|------|------|
-| **Long method** | 函数 > 30 行，多层嵌套 |
-| **Feature envy** | 方法用别的类的数据多过用自己的 |
-| **Data clumps** | 同一组参数反复一起传递 |
-| **Primitive obsession** | 用 string / number 代替领域类型 |
-| **Shotgun surgery** | 一处改动要散落地改多个文件 |
-| **Divergent change** | 一个文件因多个无关原因反复改 |
-| **Dead code** | 不可达或从不被调用的代码（详见 `removal-checklist.md`） |
-| **Speculative generality** | 为假想的未来需求做的抽象 |
-| **Magic numbers/strings** | 没有命名常量的硬编码值 |
-
-## 重构启发式
-
-1. **按职责拆，而不是按体积拆** —— 小文件也可能违反 SRP
-2. **需要时才引入抽象** —— 等到第二个用例再抽
-3. **重构保持增量** —— 先隔离行为再搬移
-4. **先保行为** —— 重构前先有测试兜底
-5. **按意图命名** —— 命名困难往往说明抽象有问题
-6. **组合优于继承** —— 继承带来强耦合
-7. **让非法状态不可表达** —— 用类型固化不变量
-
-## 严重度提示
-
-- 导致正确性问题或架构性返工的结构缺陷 → **P1**
-- 明显但局部的 SOLID 违背、可维护性隐患 → **P2**
-- 命名、轻微异味、可选改进 → **P3**
-
-> 提出重构时，必须说明它**为什么**改善内聚 / 降低耦合，并给出最小、安全的拆分；非平凡重构给增量计划，不给大重写。

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

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

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

@@ -1,45 +0,0 @@
-> **服务工作流：** `../D-docs-sync/D-docs-sync.md`
-> **产物文件名：** `docs-sync-report.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Docs Sync Report
-
-## Range
-
-[TODO: 记录 `<LAST_SYNC_SHA>..HEAD`；bootstrap 模式写 `<bootstrap>..HEAD`，并说明本次为首次文档初始化。]
-
-## Bootstrap Initialization
-
-[TODO: 仅 bootstrap 模式填写：记录项目事实盘点、自动推导的 tracked assets、缺失文档清单和初始化动作；常规同步写 `N/A`。]
-
-## Diff Summary
-
-[TODO: 记录 git log、name-status、路径分组、archive/.config 相关 diff 摘要。]
-
-## Archive Sources
-
-[TODO: 列出本次读取的 `speculo/.speculo/archive/` 产物路径；没有相关归档时写 `[]` 和原因。]
-
-## Knowledge Suggestions
-
-[TODO: 记录从归档提取的 ADR / CONTEXT / RULES / LESSONS / 文档漂移候选，包含来源路径和动作。]
-
-## Config Audit
-
-[TODO: 记录 `.config` 审计结果，按 add / update / delete / keep / propose-only 分组；RULES 写入确认单独记录。]
-
-## Mapping
-
-[TODO: 说明哪些变更或 bootstrap 初始化发现映射到哪些 tracked assets。]
-
-## Synced Assets
-
-[TODO: 列出实际创建或修改的资产和一句话说明；空同步时写 `[]`。]
-
-## Verification
-
-[TODO: 记录运行的校验命令、结果，或无法运行原因。]
-
-## State
-
-[TODO: 记录 `speculo/.speculo/dev/docs-sync-state.json` 的 old/new baseline。]

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

@@ -1,14 +0,0 @@
-{
-  "schema_version": 2,
-  "skill": "docs-sync",
-  "state_path": "speculo/.speculo/dev/docs-sync-state.json",
-  "tracked_assets": [],
-  "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_assets": []
-}

package/template/workflows/dev/_templates/domain-model-log-template.md

@@ -1,20 +0,0 @@
-> **服务工作流：** `../M-domain-modeling/M-domain-modeling.md`
-> **产物文件名：** `domain-model-log.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Domain Model Log
-
-## 术语沉淀
-[TODO: 逐条记录本会话挑战或锐化的术语。每条含：术语、结论（规范词 + 避免使用的别名）、是否已写入 `speculo/.speculo/.config/context/CONTEXT.md`（已写入 / `[待确认]`）。]
-
-## 场景压测
-[TODO: 记录用于界定边界的具体场景，以及由此确定的概念边界结论。无则写「无」。]
-
-## 代码交叉核对
-[TODO: 记录领域陈述与代码现实的核对结果（一致 / 矛盾及处置）。无则写「无」。]
-
-## ADR 候选与裁决
-[TODO: 逐条列出 ADR 候选。每条按三条判据（难以逆转 / 缺上下文会令人意外 / 真实权衡）裁决：`created`（编号 + `.config/adr/` 路径）或 `skipped`（原因）。无则写「无」。]
-
-## 待确认
-[TODO: 仍需用户决策的术语 / 边界 / 决策分支，每条一行。无则写「无」。]

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

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

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

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

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

@@ -1,106 +0,0 @@
-> **服务工作流：** `../I-to-issues/I-to-issues.md`
-> **产物文件名：** `slices.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-> **填写纪律：** 本模板遵循六段高质量 plan 纪律——当前现状 → 需读文件 → 需改文件 → 数据库表 → 实现要点 → 关键决策；标「条件段」的小节按需填写，单文件小改的最小形态为 §0(简) + §1 + §3(单切片) + §5 + §8。
-
-# 切片计划（Vertical Slices）
-
-> 本文件是一份可被下游直接接手的切片计划：以厚 Context（已确认决策 + 当前现状 + 关键核实结论）开篇，
-> 按依赖排序的切片展开，每切片标注需读/需改文件、实现要点与保留/不动，并以分层验证收口。
-> 每个切片有 `<phase id="...">` 标识，供 TDD 工作流直接引用。
-> 标「条件段」的小节按需填写；单文件小改的最小形态为 §0(简) + §1 + §3(单切片) + §5 + §8。
-
-## 0. 战略与背景（Context）
-
-- **一句话战略：** [TODO: 做什么 + 为什么 + 怎么做到（新建 / 复用 / 以现有系统为基底）。]
-- **已确认决策：** [TODO: 逐条列出与用户拍板的范围/取舍决策；有 decision-log.md 则继承其「已确认决策」段。]
-- **当前现状：** [TODO: 逐条列出与需求不符的现有实现——文件路径:行号 + 当前值/行为 + 为什么不满足需求；独立进入时从代码库探索采集。]
-- **关键核实结论：** [TODO: 探索确认的事实（依赖 / 唯一调用点 / 可删须留边界）。注明：行号为近似，实施时以现场代码为准。]
-- **预期产出：** [TODO: 1–2 句，本 change 完成后的可观察结果。]
-
-## 1. 范围边界（IN / REUSE / OUT）
-| | 内容 |
-|---|---|
-| **IN 必造** | [TODO: 本次必造的新能力] |
-| **REUSE 复用现有** | [TODO: 复用不改动的现有能力] |
-| **OUT 本期不做** | [TODO: 留给后续迭代的内容 / 明确不做] |
-
-## 2. 架构上下文
-[TODO: 条件段——涉及的模块与职责分工、新增模块定位、不可逾越约束；可附 ASCII 分层图与依赖方向。单文件修复可删除本节。]
-
-## 2.5. 涉及的数据库表
-[TODO: 条件段——若涉及 schema 变更，用 | 表 | 变更 | 表记录：
-- 新建表：列出全部字段 + PK + UK + INDEX，注明 DDL 追加到哪个 sql 文件末尾
-- 新增字段：字段名 类型 DEFAULT 默认值 COMMENT '注释'，注明 ALTER TABLE 追加位置
-- 字段语义调整：旧字段名 → 新语义（不变更结构）
-- 无 schema 变更则删除本节]
-
-## 3. 切片
-
-### 切片 1 · [切片名称]
-<phase id="[phase-id]" status="未开始"><!-- 未开始 → 已实现(dev/03) → 已验证(dev/04) --></phase>
-
-- **类型：** AFK | HITL
-- **阻塞于：** 无
-- **覆盖：** [TODO: PRD 章节 / US 编号 / 用户故事]
-- **需阅读的文件：** [TODO: | 文件 | 目的 |；单文件小改可省略]
-- **交付物：** [TODO: 具体文件/模块/功能；改动面宽时可用 | 文件 | 改动 | 表逐文件列出]
-- **需修改的文件：** [TODO: | 文件 | 改动内容 |；新增文件标 **新增**，重度重构标 **重度重构**]
-- **保留/不动：** [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]
-- **实现要点：** [TODO]
-- **验收切片：** [TODO]
-- **对齐：** [TODO]
-- **ADR 引用：** [TODO]
-
-[TODO: 按需增加更多切片，每个有独立的 phase id]
-
-## 4. 横切关注点与铁律
-[TODO: 跨切片一致的规则、约束与不可违反的铁律（数据安全冻结常量、契约先行、删缓存可重建、范围隔离、命名消歧）；并声明「行号为近似，实施时现场核对」。]
-
-## 5. 依赖顺序速查
-```
-[TODO: ASCII 依赖链，如:
-P0  phase0-xxx  切片名称  ← 不可回退,最先
-P1  phase1-xxx  切片名称  依赖 P0
-]
-```
-
-## 5.5. 关键决策
-[TODO: 汇总影响全局或跨切片的技术选型与取舍，如方案选择（工具类 vs 正则）、字段复用/新建决策、SQL 追加规则等。防止下游对同一问题反复争论。单文件小改可删除本节。]
-
-## 6. 风险与回滚
-[TODO: 条件段——本期涉及删除/数据迁移/外部副作用/高耦合时填：风险 / 触发条件 / 缓解 / 回滚 表；有 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/template/workflows/dev/_templates/overview-template.md

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

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

@@ -1,26 +0,0 @@
-> **服务工作流：** `../02-prd/02-prd.md`
-> **产物文件名：** `prd.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# 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/template/workflows/dev/_templates/regression-template.md

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

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

@@ -1,30 +0,0 @@
-> **服务工作流：** `../R-review/R-review.md`
-> **产物文件名：** `review-report.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Review Report
-
-> 每条 finding 格式：`[严重度] [file:line 或 hunk] 标题` + 问题描述 + 修复建议 + 来源引用。
-> 严重度取值 P0 / P1 / P2 / P3，见 `../R-review/R-review.md` 的严重度模型。
-
-## Spec
-
-[TODO: 按 Spec 维度列出 findings（缺失需求、范围蔓延、看似实现但有问题的需求），引用 spec 原文。缺失 spec 时写 `no spec available`。]
-
-## Engineering
-
-### SOLID 与架构
-[TODO: 依据 `../R-review/solid-checklist.md` 列出 findings。]
-
-### 安全与可靠性
-[TODO: 依据 `../R-review/security-checklist.md` 列出 findings，含可利用性与影响。]
-
-### 代码质量
-[TODO: 依据 `../R-review/code-quality-checklist.md` 列出 findings。]
-
-### 删除候选
-[TODO: 依据 `../R-review/removal-checklist.md` 列出死代码 / 删除候选与计划。]
-
-## Standards
-
-[TODO: 按 Standards 维度列出违反已记录标准的 findings，引用标准来源；无成文标准时记录覆盖空白。]

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

@@ -1,33 +0,0 @@
-> **服务工作流：** `../R-review/R-review.md`
-> **产物文件名：** `review-sources.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Review Sources
-
-## Fixed Point
-
-[TODO: 记录用户提供的 fixed point。]
-
-## Diff Command
-
-[TODO: 记录 `git diff <fixed-point>...HEAD`。]
-
-## Commits
-
-[TODO: 粘贴或摘要 `git log <fixed-point>..HEAD --oneline`。]
-
-## Scope
-
-[TODO: 记录 `--stat` 规模、是否大 diff、分批策略；无变更时记录处理方式。]
-
-## Critical Paths
-
-[TODO: 列出 diff 触及的关键路径：auth / 支付 / 数据写入 / 网络 / 并发。]
-
-## Spec Sources
-
-[TODO: 列出 PRD、issue、slices、用户路径；缺失写 `no spec available`。]
-
-## Standards Sources
-
-[TODO: 列出已发现的规则、上下文、ADR、贡献指南或配置文件；无成文标准时记录覆盖空白。]

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

@@ -1,33 +0,0 @@
-> **服务工作流：** `../R-review/R-review.md`
-> **产物文件名：** `review-verdict.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# 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/template/workflows/dev/_templates/tdd-log-template.md

@@ -1,23 +0,0 @@
-> **服务工作流：** `../03-tdd/03-tdd.md`
-> **产物文件名：** `tdd/<phase-id>/implementation-log.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Implementation Log
-
-## 阶段标识
-[TODO: 本阶段 `<phase-id>`（与同目录 `tdd-plan.md` 一致）。]
-
-## Git 状态变化
-[TODO: 记录相对 `tdd-plan.md` 执行前基线新增/变化的 dirty、staged、untracked 文件，以及未知改动的处理结论。]
-
-## 循环记录
-[TODO: 对每轮 RED/GREEN/REFACTOR 记录切片、行为、测试、实现摘要、重构摘要和验证结果。]
-
-## 接口变化
-[TODO: 记录对公共接口、用户可见行为或集成边界的实际变化。]
-
-## 偏离计划
-[TODO: 记录实现中发现的计划偏差、原因和用户确认情况。]
-
-## 剩余切片
-[TODO: 列出尚未完成的切片、阻塞原因或已明确取消的范围。]