jiapuapp/docs/交接记录.md

家谱 APP 交接记录

更新日期：2026-07-15 这是更换电脑或交给新 GPT 时的唯一快速入口。详细操作见 视觉设计交接手册，页面审核状态以 总规划 为准。

1. 当前准确停点

• pages.json 当前登记 54 条最终路由；重复状态已经收敛到同一页面，例如 G02→G01、G04→G03、G07→G06、T02→T01。
• 当前有 7 个已验收页面：A01、A02、A04、A05、A06、G01、G03。除非用户提出明确调整，不得改变这些页面已经验收的可见效果。
• 其余 47 个待审核候选已经完成页面实现、H5 运行截图和内部视觉审视，统一在 docs/规划.md 标记为 [~]。候选不等于用户验收，只有用户明确通过后才能改为 [x]；要求返工时改为 [!]。
• 下一步是按 docs/规划.md 逐页视觉审核，不再批量新增页面。接口资料只用于理解功能、字段和状态位置；本阶段不对接接口。
• H5 Chrome 截图是候选审计证据，最终 Android/HBuilderX 真机或模拟器复核仍需在视觉审核后完成。

2. 新 GPT 启动顺序

1. 全程使用中文。先完整阅读 AGENTS.md、本文件、docs/规划.md、docs/design/视觉设计交接手册.md、docs/design/D1_安卓视觉规范与页面壳.md、docs/design/P00_页面结构与资产清单.md 和 design-qa.md。
2. 运行 git status --short，识别并保留全部未提交改动。不要把旧提交状态当成当前工作区状态。
3. 先向用户简洁复述：54 条路由、7 个已验收、47 个待审核，以及准备审核的具体页面；在用户给出页面反馈前不要盲目重做。
4. 审核时先看 视觉证据索引 的默认代表图；发现具体问题后再展开多尺寸、before/after 或历史废稿。

3. 必须调用的能力

新 GPT 必须实际具备并按触发条件调用：

• product-design:index：开始设计、审视或评价页面时先调用，用于选择正确的产品设计工作流。
• product-design:audit：必须基于真实运行截图审视页面，不能只看源码判断好不好看。
• imagegen：仅在缺少完整位图视觉资产时调用。完整按钮、卡片、边框和装饰面必须使用独立位图，不能用 CSS 伪造。
• superpowers:test-driven-development：修改页面行为、路由或可审计视觉结构前，先写或更新最小契约测试并确认 RED。
• superpowers:systematic-debugging：测试、截图、路由或构建出现异常时，先复现并定位根因再修改。
• superpowers:verification-before-completion：宣称完成前，运行受影响测试、真实截图复核和 git diff --check。

能力缺失时应先安装或启用同等能力，不得假装已经完成视觉审计、位图生成或验证。

4. 视觉审核降噪规则

• 默认每页只看一张 360×800 代表截图。
• 同页有多个关键状态时，优先看一张状态联系表，不连续展示多张相似截图。
• 412×915、小屏、多尺寸和前后对比图仅在发现比例问题、回归问题或用户要求时展开。
• 历史废稿和 before/after 证据不删除，但只保留在 docs/design/视觉证据索引.md 的历史审计区。
• 审核结论记录在 docs/规划.md；不要因为内部测试或 Product Design 审视通过就替用户勾选。

5. 禁止事项与完成验证

• 不使用 worktree 或多代理。
• 不执行 git add、commit、push、上传、reset、checkout，也不覆盖用户现有文件。
• 不擅自对接接口、修改接口契约、打 Android 包或把截图放入 static/assets/ 当运行资源。
• 只修改用户当前反馈涉及的页面和对应测试、截图、设计记录；不要顺手重构冻结页或相邻模块。
• 完成一次页面返工前，至少运行对应契约测试、运行时 smoke、真实路由截图复核和 git diff --check；无法执行的检查必须明确说明。