49 lines
4.0 KiB
Markdown
49 lines
4.0 KiB
Markdown
# 家谱 APP 交接记录
|
|
|
|
> 更新日期：2026-07-15
|
|
> 这是更换电脑或交给新 GPT 时的唯一快速入口。详细操作见 [视觉设计交接手册](design/视觉设计交接手册.md)，页面审核状态以 [总规划](规划.md) 为准。
|
|
|
|
## 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. 审核时先看 [视觉证据索引](design/视觉证据索引.md) 的默认代表图；发现具体问题后再展开多尺寸、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`；无法执行的检查必须明确说明。
|