Superpowers 6.0 SDD 评审重写：文件交接 + 多平台支持¶

Ch05.052 Superpowers 6.0 SDD 评审重写：文件交接 + 多平台支持¶

📊 Level ⭐⭐ | 8.9KB | entities/superpowers-6-sdd-review-redesign-file-handoff.md

Superpowers 6.0 SDD 评审重写¶

Superpowers 6.0（2026-06-16 发布，06-18 v6.0.3 修补）的核心主线不是新增平台或补安全策略，而是重新设计了 AI Agent 软件工程中最贵、最容易跑偏的流程：任务后的代码评审。

与 术哥的反作弊视角 互补——术哥聚焦 reviewer 隔离堵作弊路径，本文聚焦文件交接降低上下文成本 + 多平台 harness 映射。

SDD 评审重写¶

旧版问题¶

5.x 每个任务后跑两个独立评审（spec-compliance + code-quality），各读一遍 diff。同一段上下文被重复消耗，controller 还要把大量 diff 塞进主会话。上下文越长，评审越容易从"检查当前任务"滑向"顺手看完整个仓库"。

6.0 解法：单一 Task Reviewer + 双 Verdict¶

每个任务只派一个 Task Reviewer，一次阅读 diff，同时给出两个裁决： - Spec Compliance：需求是否满足 - Code Quality：质量是否过关

最终阶段仍保留 whole-branch broad review。"任务窄审"和"最终宽审"边界更清晰。

task-reviewer-prompt.md 关键约束： - diff file 是主视图，只有能说出具体风险时才查 diff 之外代码 - 不鼓励重跑整个测试套件，只允许 focused test - implementer report 视为未验证声明，reviewer 必须回到 diff 本身验证

核心判断：评审的价值来自发现具体缺陷，不来自制造"我又完整检查了一遍"的仪式感。

文件交接降低上下文成本¶

这是 6.0 中最被低估的改动——把交接材料文件化：

效果： - 主会话不再被每个 task 的 diff 反复挤占 - reviewer 不需要临场"还原发生了什么" - 评审失败时修复环围绕同一个 brief 和 diff package 继续转

v6.0.3 修补：scratch 目录从 .git/sdd/ 移到 .superpowers/sdd/，避开 Claude Code 对 .git/ 的保护。

多平台 Harness 映射¶

6.0 新增 Kimi Code、Pi、Antigravity 三个 harness。核心变化：skill 层说方法论，harness 层负责工具映射。

skill 文本从 Claude Code 方言（Task tool、CLAUDE.md）改写为 vendor-neutral 动作描述（dispatch a subagent、your instructions file）。

→ Coding Harness Engineering → Harness 作为产品表面

Visual Brainstorming 安全补强¶

server.cjs 增加的安全措施： - per-session key 认证（query key 或 HttpOnly cookie） - WebSocket origin 检查 - HTTP 响应：no-referrer、no-store、frame deny、CSP - 文件服务拒绝 dotfile、symlink、硬链接数异常文件 - 真实路径校验仍在 content 目录内

生命周期改进： - 项目目录复用 .last-port 和 .last-token - 停止时检查 server instance id，避免 stale PID 误杀 - idle timeout 调整为适合长时间头脑风暴

效率收益¶

官方数据：Claude Code 和 Codex 达到相似质量时，速度约快一倍，token 花费近少一半。

收益来源： 1. 合并 spec/quality reviewer → 省一个 subagent + 一遍 diff 读取 2. 预生成 review package → reviewer 不临场跑 git 3. 更细的模型选择建议（最终 broad review 仍用最强模型）

升级检查清单¶

1. 旧 reviewer prompt：spec-reviewer-prompt.md / code-quality-reviewer-prompt.md → 迁到 task-reviewer-prompt.md，适配双 verdict
2. worktree 路径：旧 ~/.config/superpowers/worktrees/ 退出，新路径项目内 .worktrees/
3. scratch 目录：6.0.0-6.0.2 直接升到 6.0.3+，避开 .git/sdd 写入问题

深度分析¶

评审的价值来自发现缺陷，不来自仪式感¶

Superpowers 6.0 评审重写的核心判断是：评审的价值来自发现具体缺陷，不来自制造"我又完整检查了一遍"的仪式感。旧版两个 reviewer 各读一遍 diff，同一段上下文被重复消耗，还容易从"检查当前任务"滑向"顺手看完整个仓库"。新版单一 Task Reviewer + 双 Verdict 的设计，把评审活动范围收窄，反而让发现问题的信号更干净。

文件交接是上下文经济学的关键实践¶

把交接材料文件化（task-brief、review-package、progress ledger）是 6.0 中最被低估的改动。这解决了 Agent 软件工程中的一个结构性问题：主会话的上下文是稀缺资源，不应该被每个 task 的 diff 反复挤占。文件化交接让 implementer 只读当前任务 brief，reviewer 只读预生成的 diff 包，controller 只读 progress ledger——每个角色只加载自己需要的上下文。

"任务窄审"与"最终宽审"的边界设计¶

6.0 把评审分为两个明确的阶段：任务级窄审（每个 task 后，只看当前 diff）和分支级宽审（最终阶段，看整个分支）。这个边界设计解决了 Agent 评审中的常见问题：任务级评审不应该承担跨任务集成风险的检查，那是宽审的职责。清晰的边界让每个评审阶段都有明确的范围和目标。

多平台 Harness 映射的方法论价值¶

skill 层说方法论，harness 层负责工具映射——这个分离让同一套 SDD 方法论可以跑在 Claude Code、Codex、Kimi Code、Pi、Antigravity 等不同平台上。skill 文本从 Claude Code 方言改写为 vendor-neutral 动作描述，是 Agent 工具生态从"平台绑定"走向"方法论可移植"的关键一步。

可恢复性是长任务 Agent 工程的基础设施¶

progress ledger（.superpowers/sdd/progress.md）让长任务在上下文压缩、会话中断、分支暂停后可以恢复。这不是锦上添花，而是多小时、多天 Agent 开发的基础设施。没有可恢复性，Agent 一旦中断就必须从头开始——这对复杂功能开发是不可接受的。

实践启示¶

1. 评审设计应收窄范围而非扩大覆盖：单一 reviewer + 双 verdict 比两个独立 reviewer 更高效。评审的价值密度（发现缺陷/消耗 token）比覆盖率更重要
2. 文件交接是 Agent 上下文管理的最佳实践：把任务 brief、diff 包、进度账本文件化，避免主会话被中间数据挤占。每个角色只加载自己需要的上下文
3. 计划阶段的投入直接影响评审质量：task reviewer 按 brief 评审，计划里没写清楚的边界不能指望 reviewer 自动脑补。Global Constraints、Interfaces、Non-negotiables 必须在计划中明确
4. 方法论与平台解耦是 Agent 工具链的演进方向：用 vendor-neutral 动作描述编写 skill，通过 harness 层映射到具体平台，实现方法论可移植
5. 长任务必须有可恢复机制：progress ledger + git log 的组合让 Agent 在中断后可以找到第一个未完成任务继续做，而非从头开始

相关链接¶

• → 术哥反作弊视角分析 — 互补视角
• → 三器合一工程化实战 — Superpowers + OpenSpec + gstack 串联
• → Superpowers 工作流入门
• → 原文存档