log-diff-entrylisted

> 🔧 项目无关骨架版 · 项目专属配置见 PROJECT-PROFILE.md # Skill · log-diff-entry > 一句话定位：当 PRD 与实际实现不一致时，用差异条目模板创建一条新的差异，并追加到 `baseline/02-PRD-实现差异台账.md`。 ## 触发条件 - 验收过程中发现 PRD 与代码 / 接口 / UI 不一致 - 同步代码后发现接口消失、字段变更、枚举调整 - 测试发现页面功能与 PRD 描述存在偏差 - 用户明确说「记录一条差异」「这是个 GAP」 ## 输入 | 输入 | 是否必填 | 示例 | |---|---|---| | 模块名 | ✅ | <模块名>（见 PROJECT-PROFILE.md § 四/五）| | 页面路由 | ✅ | `/<端>/<模块>/<页面>` | | PRD 章节 / 出处 | ✅ | PRD §4.3 | | 实际实现位置 | ✅ | `code/<仓库名>/<前端包>/src/pages/<模块>/...`（端结构见 PROJECT-PROFILE.md § 五）| | 差异类型 | ✅ | PRODUCT_GAP / PLACEHOLDER_FRONTEND / MOCK_DATA / API_CONTRACT / ... | | 优先级 | ✅ | P0 / P1 / P2 | | 影响面 | ✅ | 影响哪些用户 / 业务链路 | ## 步骤 1. **读 `baseline/templates/差异条目模板.md`**：拷贝完整模板字段，禁止删字段、禁止改字段顺序 2. **生成编号**：扫 `baseline/02-PRD-实现差异台账.md` 已有 DIFF-XXX，编号顺延（如 DIFF-00N、DIFF-00N+1 ...） 3. **填写完整字段**： - 编号 / 模块 / 页面路由 / PRD 章节 - 差异类型 / 优先级 / 状态（默认「待裁决」） - PRD 描述 / 实际实现 / 差异点 - 影响面 / 推荐处理方式 - 关联接口 / 关联文件 - 登记人 / 登记日期 - 裁决人 / 裁决日期 / 裁决结论（待填） - 修复负责人 / 修复完成日期 / 验收结果（待填） 14. **追加到台账**：在 `baseline/02-PRD-实现差异台账.md` 表格末尾追加一行 15. **更新 `说明文档.md`**：第三节进度记录追加「新增差异条目 DIFF-XXX」 16. **如属 P0 且阻塞当前任务**：立即停止当前修复，等待裁决 ## 输出 ```md ## 已登记差异条目 - 编号：DIFF-XXX - 模块 / 页面：xxx / /admin/xxx - 类型 / 优先级：API_CONTRACT / P0 - 状态：待裁决 - 摘要：（一句话差异点） - 推荐处理：（候选方案 1 / 候选方案 2） - 等待：产品负责人 + 技术负责人 联合裁决 ``` ## 禁止事项 - ❌ 不用模板，直接在台账上写散文 - ❌ 修改已存在的差异条目（应追加新条目或更新状态字段） - ❌ 跳过编号顺延规则 - ❌ 状态默认填「已关闭」（必须经过裁决 + 修复 + 验收） - ❌ 不更新「说明文档.md」进度记录