jiapuapp/docs/superpowers/specs/2026-07-15-handoff-evidence-simplification-design.md

交接文档与视觉证据精简设计

日期：2026-07-15
状态：用户已确认“正文精简、证据不删除”方向
范围：仅整理交接、审核入口与证据索引，不修改页面代码、视觉资产、路由或接口

目标

让更换电脑后的新 GPT 只阅读一个简洁入口，就能准确知道当前停点、必须调用的技能、禁止事项、页面审核方式和验证要求；同时减少连续阅读前后对比图、多尺寸截图与历史废稿造成的视觉疲劳。

信息结构

1. docs/交接记录.md 作为唯一快速入口，只保留：
   • 54 条最终路由、7 个已验收页、47 个待审核候选的准确状态；
   • 下一步是按 docs/规划.md 逐页审核，而不是继续批量设计或对接接口；
   • 新 GPT 的必读顺序、技能调用顺序、禁止事项和最小恢复检查；
   • 一处“视觉证据归档”链接，不逐张罗列历史对比图。
2. docs/design/视觉设计交接手册.md 保留完整操作方法，但删除重复、陈旧的截图清单和过期停点；截图规则改为“审核时默认只看一张代表图，状态复杂时看一张状态联系表，发现问题后才展开历史对比与多尺寸证据”。
3. 新增 docs/design/视觉证据索引.md，集中保存现有代表截图、状态联系表、历史前后对比和模块设计记录的路径。证据文件不删除、不移动。
4. .superpowers/sdd/task-1-report.md 明确标记为早期 A02 专项报告，不再承担当前总交接职责；当前交接以 docs/交接记录.md 为准。

新 GPT 的启动契约

交接入口必须明确写出以下顺序：

1. 完整阅读 AGENTS.md、docs/交接记录.md、docs/规划.md 和视觉交接手册，先运行 git status --short，不得覆盖未提交改动。
2. 设计或审视页面时，先调用 product-design:index；基于真实运行截图调用 product-design:audit。
3. 只有缺少完整位图视觉资产时才调用 imagegen；按钮、卡片、边框和装饰面不得用 CSS 伪造。
4. 修改页面行为、路由或可审计视觉结构前调用 superpowers:test-driven-development，先更新最小契约测试。
5. 测试、截图、路由或构建异常时调用 superpowers:systematic-debugging。
6. 宣称完成前调用 superpowers:verification-before-completion，运行受影响测试、真实截图复核和 git diff --check。
7. 不使用 worktree、多代理、git add、commit、push、上传、reset 或 checkout。

视觉审核降噪规则

• 默认审核材料：每页一张 360×800 代表截图。
• 同页包含关键状态时：使用一张状态联系表代替多张连续截图。
• 412×915、小屏、多尺寸和前后对比图只在发现比例问题、回归问题或用户要求时展开。
• 历史废稿与 before/after 图保留在证据索引的“历史审计”区域，不出现在快速交接正文。
• 用户明确通过一页后才把 docs/规划.md 的 [~] 改为 [x]；要求返工时改为 [!]。

需要修正的当前矛盾

• 将已验收数量统一为 7：A01、A02、A04、A05、A06、G01、G03。
• 将候选数量统一为 47，并保持“候选不等于用户验收”。
• 删除 G06“结果态、无结果态截图尚未完成”的陈旧描述；保留 G06 尚未获用户视觉验收的事实。
• 删除“下一项继续推进 F/R/N/M”的旧停点，改为“全部候选已覆盖，等待逐页审核”。
• 明确 H5 截图是候选审计证据，最终 Android/HBuilderX 真机或模拟器复核仍在视觉审核之后。

验证

• 用文本检索确认交接文档不再出现“六个已验收”“G06 结果态未截图”“继续推进 F/R/N/M”等陈旧表述。
• 确认快速交接入口包含全部六类技能调用规则和 Git/多代理禁令。
• 确认 docs/规划.md 仍为 7 个 [x]、47 个 [~]、0 个遗漏项。
• 运行 git diff --check。
• 不删除任何现有 PNG，不修改页面、路由、接口或运行资产。