openharmonyinsight/ohos-req-feature-baseline

OHOS Feature 评审基线

Announce at start: "我正在使用 ohos-req-feature-baseline skill 生成 04-feature.md。"

定位

04-feature.md 是 OHOS SIG 评审会议和 IR 生成的共同输入。工作量分级约束（PIR #152 P1）按端到端总人月推导：简单(≤5)/标准(≤8)/复杂(≤15)三级，复杂特性须有独立验收边界。模块覆盖完整性校验引用 02-feasibility.md §2.1 代码仓库分析表，缺失模块必须补行或写明排除理由。03-arch-decision-record.md §6 遗留问题闭环校验阻断 Not Ready Gate。

⭐ 思维准则

在给出拆分建议前，自问：是否按 R1→R2→R3→R4 顺序逐条评估？是否在首个触发处即停止，还是跳过了某些检查？

• Before checking module coverage, ask yourself: am I cross-checking 02 §2.1 against 04 §4 line-by-line, or eyeballing from memory?
• Before detecting terminology drift, ask yourself: am I comparing every 影响类型 label between 02 and 04, or skipping reusable ones?

输入

• {docs_dir}/01-requirement.md
• {docs_dir}/02-feasibility.md
• {docs_dir}/03-arch-decision-record.md

流程

模板与产物命名

• 模板路径：reference/feature.md（模板文件不带 04- 阶段编号前缀）
• 产物路径：{docs_dir}/04-feature.md

1. 读取 reference/feature.md 和全部输入。
2. 从 01-requirement.md frontmatter 继承 rr_id 到 04-feature.md frontmatter，并在 §1 概述与价值后填写 RR单号表格行。
3. 收敛一句话特性、价值、目标/非目标、优先级范围和 AC。
4. 摘要记录选定方案、未选方案原因及 Phase 2 验证项。
5. 明确仓库、模块、Owner/SIG、交付物、里程碑、依赖和开放项。
6. 补充「需求变更影响性分析」章节（模板外补充章节，不对应模板 §-编号）：对以下五方逐项分析影响类型（正向优化/无影响/需适配）：
   • 北向应用开发者：关注 API 变更、行为变更、兼容性
   • 南向开发者：关注底层接口变更、新增能力
   • 分布式设备：关注跨设备场景影响
   • 系统开发者（跨子系统）：关注子系统间接口/依赖变更
   • 设备使用者：关注用户可感知的功能/体验变更
7. 模块覆盖完整性校验：提取 02-feasibility.md §2.1"关键代码仓库分析"表中所有仓库/模块，与 §4"受影响模块"表对比。02 中出现但 04 中缺失的仓库/模块必须补行或写明排除理由。在 §4 写入 模块覆盖检查结论：pass（齐全）或 warn（有排除理由），供 ohos-req-review-gate 读取。
   • 降级规则：若 02-feasibility.md 不含 §2.1 关键代码仓库分析表，则跳过模块覆盖校验并标注 warn（"模块覆盖校验未执行：02-feasibility.md 缺少 §2.1"），不 fail。
8. 影响类型术语校验：对比同一模块在 02-feasibility.md §2.1 和 §4中的影响类型标签。漂移（如"可复用"→"需扩展"）必须在 §4 补充变更理由备注，并在 §4 写入 术语一致性检查结论：pass（无漂移）或 warn（有漂移已补理由），供 ohos-req-review-gate 读取。
9. 判断是否拆分 proposal，并定义每个 proposal 的独立价值、边界、AC、工作量估算和依赖。拆分表必须包含每个 proposal 的估算工作量（人月）。计算端到端总工作量（= 各 proposal 工作量之和），按总人月推导复杂度（<5 简单 / 5-10 标准 / >10 复杂），填入 §5「端到端总工作量」与「复杂度」字段——此复杂度即 R3 拆分上限（简单≤5 / 标准≤8 / 复杂≤15 人月）的判定依据。
10. ⭐ 拆分结果确认门禁：向用户展示拆分方案（每个 proposal 的边界、工作量、Owner、依赖），等待用户确认或调整后才允许进入 Step 0.5。AI 不自行定稿拆分方案。
11. 保存到 {docs_dir}/04-feature.md。
12. 执行 Review Ready Gate（读取刚保存的 04-feature.md，确保 Gate 判定基于用户已确认的最终版本）。

职责边界

方案选型决策(ADR)由 ohos-req-arch-decision skill 负责，本 skill 只收敛 Feature 评审基线。

遗留问题闭环校验

在生成 04-feature.md 之前，必须校验 03-arch-decision-record.md §6 遗留问题闭环状态：

1. 读取 03-arch-decision-record.md §6 全部遗留项。
2. 对每条遗留项检查：负责人、解决动作、计划关闭时间 三字段是否齐全。
3. 任一遗留项缺少三字段 → Gate 降级为 Not Ready，block_reasons 记录缺失项。
4. §6 为占位（[待用户评审会议后填写]）且无实际遗留项 → Gate 降级为 Not Ready，block_reasons 记录"03-arch-decision-record.md §6 遗留问题未由用户评审会议输入"。
5. §6 无遗留项（用户评审会议认定无需遗留）→ 视为通过，无需阻断。

Review Ready Gate

• Ready：所有检查项通过，可生成 IR 并进入正式评审。
• Conditional Ready：无失败项，所有条件项都有 Owner、关闭动作和时点，可生成带条件 IR。
• Not Ready：存在失败项或无需求导入计划的阻塞项；禁止生成 IR、proposal 或正式需求 PPT。

AC一致性校验

主 Session 在 Gate 后生成 FR→AC 追溯表，检查编号一致性：每条 FR 必须映射到至少一条 AC，AC 编号在 04-feature.md 内唯一且无遗漏。

错误处理

| 场景 | 恢复指导 | |------|---------| | Not Ready (04-feature.md 内容不完整) | 告知用户缺失的具体章节，引导回 Step 0.4 对应子步骤补全 | | Not Ready (01-03 未完成) | 告知用户需先完成上游 Step 0.1-0.3，列出缺失文档 | | Conditional Ready | 列出条件项，引导用户确认是否接受条件放行或退回修改 | | 拆分未确认 (Step 10 gate) | 提示用户确认拆分方案，不可自行定稿 |

拆分规则

拆分规则详见 reference/split-rules.md。核心：R1仓库隔离→R2子系统隔离→R3工作量约束→R4默认不拆。工作量分级：简单≤5/标准≤8/复杂≤15人月。

自检

• [ ] 内容可追溯到 01-03
• [ ] RR单号已从 01-requirement.md 继承（frontmatter rr_id + §一表格）
• [ ] 目标、非目标、AC 和范围可评审
• [ ] 影响范围有 Owner/SIG 和交付物
• [ ] Conditional 项有 Owner 和关闭时点
• [ ] 拆分结论包含事实依据
• [ ] 拆分表每个 proposal 有估算工作量（人月，不超过复杂度上限）
• [ ] §5 端到端总工作量字段已填写（= 各 proposal 工作量之和），复杂度与总工作量匹配
• [ ] 拆分结果已经用户确认（非 AI 自行定稿）
• [ ] 03-arch-decision-record.md §6 遗留问题由用户评审会议输入（非 AI 生成）
• [ ] 03-arch-decision-record.md §6 每条遗留项负责人/解决动作/计划关闭时间齐全

NEVER

• 禁止 AI 自行定稿拆分方案：拆分结果必须经用户确认后才允许进入 Step 0.5（原因：拆分涉及资源分配和交付优先级，属人类决策）
• 禁止 AI 代行 §6 遗留问题生成：遗留问题必须由用户评审会议输入，不得从 feasibility 条件项或风险自动推演（原因：AI 推演会引入虚构风险项）
• 禁止 Not Ready 时生成 IR/proposal/PPT：存在失败项时禁止生成 IR、proposal 或正式需求 PPT（原因：未通过门禁的需求进入下游会导致返工和评审阻塞）
• 禁止复制 01-03 详细论证：04-feature.md 只收敛结论，不复制详细论证（原因：避免文档冗余和信息不一致）

输出

• 路径：{docs_dir}/04-feature.md
• 方案摘要章节：改为一句话引用 03-arch-decision-record.md 选定方案，格式为 "选定方案: PATH-XX（参见 03-arch-decision-record.md）"，不重复决策细节
• 回传：路径、RR单号、Gate 结论、评审建议、拆分结论、影响性分析结论和阻塞项