ohos-req-arch-decision

# OHOS 方案选型决策分析 **Announce at start:** "我正在使用 ohos-req-arch-decision skill 生成 03-arch-decision-record.md。" ## 定位 `03-arch-decision-record.md` 记录候选方案对比和用户决策结论，为 SIG 初审提供选型依据。OHOS SIG 采用集体评审制度，方案选型权归属 SIG 评审会议（由 SIG Maintainer + 领域 Owner 组成），AI 仅提供候选方案对比和推荐倾向参考，不代行决策权——决策结论必须由用户（代表 SIG 评审结论）提供。 ## 核心原则 ⭐ **决策结论必须由用户提供，AI 不替代用户做决策。** 两阶段执行： - **阶段 A（候选方案分析）**：生成候选方案对比表和 AI 推荐倾向，输出草稿供用户决策参考。 - **阶段 B（决策定稿）**：用户提供决策结论后，填入 §5-§6，输出定稿。 **⚠️ 阶段 A 完成后必须暂停，主 Session 向用户展示候选方案并等待用户决策。不允许跳过用户决策直接推进到阶段 B 或后续 Step。** ## 输入 - `{docs_dir}/01-requirement.md` - `{docs_dir}/02-feasibility.md` - 阶段 B 额外输入：用户决策结论（选定方案、理由、决策者）+ 用户评审会议认定的遗留问题清单 ## 自省提示（Mindset Prompts） 在执行关键步骤前，自问以下问题。这些问题把 SIG 评审会议的真实约束传递给 AI——方案选型权归属评审会议，AI 只负责候选对比与推荐倾向参考，任何一步替用户决策都会让未评审的方案进入下游。 - **Before writing §1 (背景与问题), ask yourself:** am I reading constraints from 01-requirement.md，还是在自行推断硬约束？硬约束应一行简述，不展开为表格。 - **Before constructing §3 (候选方案对比表), ask yourself:** 候选方案是 feasibility 给出的客观路径，还是我在自行扩充/裁剪？每个方案是否都有一句话描述 + 工作量 + 优势 + 劣势 + 风险 + AI 推荐倾向？对比表是否中立呈现，未夹带选型结论？ - **Before writing §5 (决策结论), ask yourself:** 这份结论来自用户（代表 SIG 评审），还是我在替用户拍板？§5 是否仍为占位？ - **Before writing §6 (遗留问题), ask yourself:** 这份清单是评审会议提供的，还是我在从 feasibility 条件项/风险自动推演？AI 推演会引入虚构风险项。 - **Before pausing after 阶段 A, ask yourself:** 我是否真的暂停等待用户决策了，还是直接推进到了阶段 B？status 是否保持 `PendingDecision`？ - **Before triggering 单方案快速路径, ask yourself:** feasibility §6 是否明确标注其他路径 ❌不可行 且有证据支撑？还是只有一个方案被标 ✅ 而其余未排除？触发条件不满足时必须回到标准两阶段流程。 - **Before writing §6 占位 in 阶段 B（用户未提供遗留问题）, ask yourself:** 我是否保留了 `[待用户评审会议后填写]` 并保持 status=`PendingDecision`，而不是自行补全 §6 凑闭环？ ## 阶段 A：候选方案分析（subagent 执行） 1. 读取 `reference/arch-decision-record.md` 和输入文件。模板文件不带 `03-` 阶段编号前缀；`03-arch-decision-record.md` 仅作为 `{docs_dir}` 下的产物文件名。模板只定义产物结构（6个章节），流程规则（两阶段写入、AI不代行决策等）全部由本 skill 控制，不在模板中呈现。 2. 定义决策问题和硬约束 → 写入 §1 背景与问题（约束条件写为一行简述，不展开为表格）。 3. 从 feasibility 候选路径中提取方案，生成候选方案对比表（一句话描述 + 工作量 + 主要优势 + 主要劣势 + 主要风险 + AI 推荐倾向）→ 写入 §3 候选方案对比。 4. §5 决策结论、§6 遗留问题 **留空占位**（标注 `[待用户评审会议决策后填写]`）。注意：§5和§6均由用户提供，AI不代行。§5来自用户方案选型决策，§6来自用户评审会议认定的遗留问题清单。模板中 §5/§6 无阶段提示注释，这些流程规则由本 skill 控制。 5. 输出到 `{docs_dir}/03-arch-decision-record.md`，frontmatter 添加 `status: PendingDecision`（模板 frontmatter 不含 status 字段，由 skill 注入）。 ### 阶段 A 回传 ≤15 行：路径 + 候选方案 A/B/C 一句话 + AI 推荐倾向 + 关键风险 + 阻塞条件。 ## 阶段 B：决策定稿（subagent 执行） **前置条件：** 用户已在 Step 0.3.2 明确提供决策结论。 1. 读取 `{docs_dir}/03-arch-decision-record.md`（阶段 A 草稿）。 2. 读取用户决策结论（由主 Session 注入 task 描述）： - **选定方案**：方案 A / B / C（或自定义） - **决策理由**：用户给出的选择理由 - **决策者**：拍板人姓名/角色 3. 将用户结论写入 §5 决策结论（选定方案 + 理由 + 决策者）。 4. 读取用户评审会议认定的遗留问题清单（由主 Session 注入 task 描述），写入 §6 决策后遗留问题。表格列结构：`| 遗留项 | 描述 | 负责人 | 解决动作 | 计划关闭时间 | 状态 |`（与模板 arch-decision-record.md §6 一致）。每条遗留项必须包含：描述、负责人、解决动作、计划关闭时间。 - **⚠️ §6遗留问题必须由用户提供，AI 不代行生成。** AI不得从feasibility条件项或风险自动推演遗留问题。如用户未提供遗留问题清单，§6保留占位标注 `[待用户评审会议后填写]`，status 保持 `PendingDecision`，不允许推进到后续 Step。 5. 更新 frontmatter `status: Accepted`（由 skill 注入，模板不含 status 字段）。 6. 输出到 `{docs_dir}/03-arch-decision-record.md`。 ### 阶段 B 回传 ≤15 行：路径 + 选定方案 + 决策理由一句话 + 遗留问题数 + status(Accepted)。 ## 阶段判定规则 | 阶段 | 触发条件 | status 值 | 产出 | |------|----------|-----------|------| | A | Step 0.3.1（requirement+feasibility 就绪） | `PendingDecision` | §1-§3 填充，§5-§6 占位 | | B | Step 0.3.3（用户提供决策结论 + 遗留问题清单） | `Accepted` | §5 填充（用户决策），§6 填充（用户遗留问题），全文定稿 | **不允许在阶段 A 直接输出 `status: Accepted` 或自行填写 §5 决策结论。** **不允许在阶段 B 用户未提供遗留问题清单时输出 `status: Accepted` 或自行填充 §6。** ## 强制规则 - **遗留问题闭环门禁**：§6 每条遗留项必须有负责人、解决动作、计划关闭时间。任一遗留项缺少这三字段 → 阻断 Phase 0→1-9 交接。 - **AI 推荐倾向仅为参考**：§3候选方案对比表的"AI 推荐倾向"列仅供用户决策参考，不是最终结论。 ## 单方案例外 只有一个客观可行方案时允许不构造虚假备选，但必须写明其他路径不可行的证据。 **单方案快速路径（简化两阶段为一阶段）**： 当 feasibility 阶段已明确排除其他方案（客观上只有一条可行路径）时，可跳过候选方案对比表，采用简化流程： 1. **阶段 A 简化**：直接呈现唯一方案分析（方案描述 + 工作量 + 优势 + 不可行证据），**不生成候选方案对比表**（§3 标注"单方案场景，无可行备选"） 2. **单次确认**：向用户一次性呈现唯一方案 + 其他路径不可行证据，用户一次确认采纳即可，**无需两阶段暂停** 3. 用户确认采纳后直接定稿 §5（选定方案 + 理由："唯一可行方案，无备选" + 决策者），status 直接设为 `Accepted` **触发条件**：feasibility.md §6 结论中仅有一个方案标记为 ✅可行 或 ⚠️有条件可行，其余方案均标记为 ❌不可行，且不可行有证据支撑。 **不满足触发条件时**（≥2 个可行方案），仍执行标准两阶段流程。 ## 职责边界 本 skill 只产出方案选型决策，不产出 Feature 评审基线（目标/非目标/AC/交付影响），这些由 `ohos-req-feature-baseline` skill 负责。 ## NEVER - **禁止 AI 代行决策**：§5 选定方案、决策理由和决策者由用户提供，AI 不代行（原因：方案选型权归属 SIG 评审会议，AI 推荐倾向仅为参考） - **禁止 AI 生成遗留问题**：§6 遗留问题由用户评审会议输入，不得从 feasibility 条件项或风险自动推演（原因：遗留问题反映用户认定的开放风险，AI 推演会引入虚构风险项） - **禁止阶段 A 直接定稿**：不允许在阶段 A 输出 `status: Accepted` 或自行填写 §5（原因：跳过用户决策会导致未评审的方案进入下游） - **禁止用户未提供遗留问题时填充 §6**：阶段 B 时如用户未提供，§6 保留占位，status 保持 `PendingDecision`（原因：遗留问题未经评审会议认定则不构成闭环） ## 自检 - [ ] status 字段由 skill 注入（PendingDecision→Accepted），非模板填写 - [ ] §5 方案比较来自用户提供，非 AI 推断 - [ ] §6 遗留问题来自评审会议，非 AI 推演 - [ ] 阶段A完成后已暂停等待用户决策 - [ ] 单方案例外仍执行了两阶段流程 - [ ] 每条遗留问题含负责人/解决动作/计划关闭时间 ## 错误处理 | 场景 | 行为 | |------|------| | 01-02 未就绪 | 提示用户先完成上游 Step 0.1-0.2，列出缺失文档 | | 用户未提供候选方案 | 追问用户："请提供至少 2 个候选方案用于比较" | | 用户未做决策（阶段A后） | 保持 status: PendingDecision，追问："请提供评审会议决策结论" | | 遗留问题未提供 | §6 保留占位符 [待用户评审会议后填写]，不自行填充 | ## 输出 - 路径：`{docs_dir}/03-arch-decision-record.md` - 阶段 A 回传：路径、候选方案概要、AI 推荐倾向、关键风险、阻塞条件 - 阶段 B 回传：路径、选定方案、决策理由、遗留问题数、status