58 lines
4.0 KiB
Markdown
58 lines
4.0 KiB
Markdown
# 交接文档与视觉证据精简设计
|
||
|
||
> 日期：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，不修改页面、路由、接口或运行资产。
|
||
|