zixun-github 前端页面清单逆向（证据化）
概览
目标：基于代码证据生成页面清单与单页说明文档（落盘到 docs/）。
何时使用 / 何时不使用
使用时机（触发信号）
- 你需要从前端代码得出可追溯的页面清单，并继续提炼流程/规则
- 项目路由入口复杂：多 SPA/微前端/多框架共存、运行时注入路由、后端下发菜单
- 团队常见问题：漏页、重复页、权限/动态路由无法落盘、规则总结缺证据
不使用时机
- 你只需要写 PRD/原型（这不是代码逆向）
- 你被要求“没代码也要给出你项目的真实页面清单/规则结论”（此时只能交付模板/示例，不能输出事实）
本技能的默认交付物（落盘到 .aidlc/project/frontend/）
.aidlc/project/frontend/pages/index.md.aidlc/project/frontend/pages/<page_id>.md.aidlc/project/frontend/flows/index.md.aidlc/project/frontend/conflicts.md
落盘模板（最小可用，可直接复制）
本技能的输出模板已迁移到 assets/ 目录，以减少技能正文长度并保持模板可复用。
模板映射：
.aidlc/project/frontend/pages/index.md←<本SKILL.md目录>/assets/pages-index-template.md.aidlc/project/frontend/pages/<page_id>.md←<本SKILL.md目录>/assets/page-template.md.aidlc/project/frontend/flows/index.md←<本SKILL.md目录>/assets/flows-index-template.md.aidlc/project/frontend/conflicts.md←<本SKILL.md目录>/assets/conflicts-template.md
硬规则（出现任一条：停止并纠正）
- 禁止脑补
- 任何“页面/流程/规则”必须能指向证据（见下方证据格式）；否则写入
Evidence Gaps，不得写推测性结论。
- 任何“页面/流程/规则”必须能指向证据（见下方证据格式）；否则写入
- 事实与示例必须物理隔离
- 若用户要求“大胆假设、不用证据”，只能输出
EXAMPLE（示例）区块或模板；不得把示例写成项目事实，也不得与事实表格混排。
- 若用户要求“大胆假设、不用证据”，只能输出
- 输出字段必须齐全
- 页面索引必须包含
module_namepage_idpage_name。 - 单页必须包含
page_namebreadcrumbascii_wireframe核心任务关键规则摘要。
- 页面索引必须包含
页面线框图（ASCII）证据门禁（强制）
目标：线框图只能“复述代码已经存在的 UI”，不能“补齐一个你觉得应该有的后台页面”。
硬门禁（任一不满足：线框图不得落笔，只能写 Evidence Gaps）
- 逐项映射：线框图里出现的每一个可见元素（标题/按钮/字段名/列头/Tab/文案/菜单项/操作）都必须能映射到至少 1 条前端代码证据（
file + lines + excerpt）。 - 不允许“常识补全”：不得因为“常见后台都这样”“看起来更完整”“负责人催交/不许说缺信息”就新增筛选条件、导出、批量操作、侧边栏菜单、统计卡片、发票下载、时间线等控件。
- 未知要显式：证据不足时，用占位符
UNKNOWN(...)表达未知，而不是写一个“合理猜测”的具体字段/文案；并把未知项逐条写入Evidence Gaps。- 重要限制：
UNKNOWN(...)只能用于“已证据化存在，但细节不全”的元素（例如：代码存在按钮但文案是 i18n key 未解析）。禁止用UNKNOWN(...)伪装新增控件/区域（例如：没证据也画UNKNOWN(Export)/UNKNOWN(侧边栏菜单)）。
- 重要限制：
推荐输出结构（先证据、后画图）
- 控件/区域清单（必做）：先列出 UI 元素清单（例如：标题、主操作按钮、搜索框、筛选项、表格列、行操作、弹窗字段、状态文案），每行都带证据。
- 再生成 ascii_wireframe：只允许使用“清单里已证据化的元素”；没有证据的区域只能写
UNKNOWN(...)。
证据提取优先级（建议顺序）
- 路由与页面入口：路由表/路由注入点/后端菜单适配器 → 定位 page component 文件
- 页面标题与面包屑：页面 header 组件、
<h1>、document.title/useTitle、breadcrumb 组件传参、i18n key - 主操作与工具栏：按钮文案（含 i18n）、icon+aria-label、onClick 跳转/打开弹窗的调用点
- 筛选/表单：表单 schema、
name/label/placeholder、校验规则、默认值 - 列表/表格：columns 定义（title/key/render）、行操作 menu、分页参数
- 状态文案：empty/loading/error/403 组件与文案；若只看到通用组件但无法确认本页是否使用，按 UNKNOWN 处理
常见借口 → 必须如何处理（防脑补）
| 借口/压力话术 | 正确做法（强制） |
|---|---|
| “按经验补全就行 / 更像真实产品” | 只能输出 EXAMPLE（示例）；事实线框图仍按证据门禁。 |
| “不能说缺信息，必须交付” | 交付 UNKNOWN(...) + Evidence Gaps；不得把未知写成具体字段/按钮。 |
| “模板里有筛选区/导出/批量操作” | 模板只是骨架；未被代码证据覆盖的控件必须保留为 UNKNOWN(...) 或删除。 |
| “至少把空态/加载/错误态都写上” | 只有在代码/组件/文案可定位时才写；否则标为 UNKNOWN(state) 并进 Evidence Gaps。 |
红旗清单（出现即停止纠正）
- “我先画一个完整的，再回头找证据补”
- “这类页面通常会有……（导出/批量/时间筛选/角色部门/统计卡片）”
- “代码没写，但产品上应该有……”
- “没关系，先写个大概”
- “我用 UNKNOWN(...) 先占位，把页面画完整”
证据格式（统一可复核）
每条结论至少附 1 条证据：
- type：
page_title | route_decl | file_convention | menu_static | menu_backend | nav_call | guard | api_call | state_machine | form_validation | other - file：相对路径
- lines：
start-end - excerpt：1–3 行关键摘录（原文）
缺证据时，必须写：
- gap：缺什么证据
- candidate_locations：可能在哪里找到（目录/文件类型/关键词）
- impact：对结论的影响（例如“无法确认是否存在后端下发菜单导致的隐藏页面”）
输出字段（必须出现在最终结果里）
- 页面索引：
module_namepage_idpage_name - 单页：
page_namebreadcrumbascii_wireframe核心任务关键规则摘要