From ca0ec6dbded000b04ae7a967f36417a386fb6710 Mon Sep 17 00:00:00 2001 From: Alpha86 Date: Wed, 22 Apr 2026 02:44:47 +0000 Subject: [PATCH] doc: skill structure consistency rules (Refs #17) --- ..._skill_structure_consistency_2026-04-22.md | 119 ++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 docs/prd/017_skill_structure_consistency_2026-04-22.md diff --git a/docs/prd/017_skill_structure_consistency_2026-04-22.md b/docs/prd/017_skill_structure_consistency_2026-04-22.md new file mode 100644 index 0000000..7ebcba4 --- /dev/null +++ b/docs/prd/017_skill_structure_consistency_2026-04-22.md @@ -0,0 +1,119 @@ +--- +name: SKILL 结构冲突与不一致治理 +description: 治理 AgentDevFlow 7 个核心角色 SKILL.md 的结构冲突与不一致，统一命名、章节、强制规则与章节顺序，作为 Issue #17 的当前有效 Gate 1 输入 +status: Draft +owner: Product Manager +date: 2026-04-22 +update_date: 2026-04-22 +issue: "#17" +--- + +# PRD #017 — SKILL 结构冲突与不一致治理 + +## 1. 背景 + +Issue #17 指向的核心问题是：AgentDevFlow 的 7 个核心角色 SKILL.md 存在结构冲突与不一致，包括命名混乱、章节缺失、强制规则未声明、章节顺序异常。这些不一致会导致角色行为预期模糊、流程合规性降低，并可能继续扩散为新的治理问题。 + +## 2. 问题 + +当前存在以下三个优先级的问题： + +### P0（必须立即修复） +- **Architect 强制规则未声明"不签自己的交付物"**：`skills/architect/SKILL.md` 缺少 self-review 禁止规则 +- **QA "三方签字"定义错误**：`skills/qa-engineer/SKILL.md` L23 使用 "CTO" 而非 "架构评审人" + +### P1（结构不一致） +- **HR#1 命名混乱**：7 个 SKILL 中存在三种不同写法，需统一为 "Human Review #1" +- **Architect 缺少"职责边界"章节**：唯一缺失该章节的核心角色 +- **Platform/SRE 缺少"职责边界"和"输出格式"章节** + +### P2（原则缺失） +- **"产出者不评审自己"原则未显式声明**：需在禁止行为章节补充 +- **PMO 章节顺序异常**："何时启用"在"必读文档"之后 + +## 3. 目标 + +形成当前有效的产品层需求定义，明确： + +1. 7 个核心角色 SKILL.md 的结构必须统一 +2. P0 冲突必须按当前有效需求修复 +3. P1/P2 不一致必须按统一口径治理 +4. 修复后的 SKILL 结构必须可追溯、可验证 + +## 4. 范围 + +### 4.1 强制规则补齐（P0） + +- `skills/architect/SKILL.md`：在禁止行为章节显式声明"不签自己的交付物" +- `skills/qa-engineer/SKILL.md`：将 L23 "CTO" 更正为 "架构评审人" + +### 4.2 命名统一（P1） + +- 7 个 SKILL 中的 "HR#1" 相关表述统一为 "Human Review #1" +- 确保同一 issue 中不出现三种以上不同写法 + +### 4.3 章节补齐（P1） + +- `skills/architect/SKILL.md`：补充"职责边界"章节 +- `skills/platform-sre/SKILL.md`：补充"职责边界"和"输出格式"章节 + +### 4.4 原则显式声明（P2） + +- 在 7 个 SKILL 的禁止行为章节统一补充："产出者不评审自己" +- `skills/pmo/SKILL.md`：调整章节顺序，使"何时启用"在"必读文档"之前 + +### 4.5 涉及文件 + +- `skills/architect/SKILL.md` +- `skills/qa-engineer/SKILL.md` +- `skills/product-manager/SKILL.md` +- `skills/engineer/SKILL.md` +- `skills/team-lead/SKILL.md` +- `skills/pmo/SKILL.md` +- `skills/platform-sre/SKILL.md` + +## 5. 非目标 + +- 不在本 PRD 中直接修改 skill 源文件 +- 不新增与 SKILL 结构无关的流程机制 +- 不把 GOV-010 历史治理留档直接当作当前有效交付物 + +## 6. 用户故事 + +### US-1：角色使用者 +> 作为使用 AgentDevFlow 角色的用户，我希望同一角色的 SKILL 结构与其他角色一致，这样可以减少理解成本和操作歧义。 + +### US-2：流程审核者 +> 作为流程审核者，我希望所有核心角色的强制规则都已显式声明，避免 self-review 等违规行为。 + +## 7. 验收标准 + +- [ ] Architect SKILL 已显式声明"不签自己的交付物" +- [ ] QA Engineer SKILL 的"三方签字"已统一为"架构评审人" +- [ ] 7 个 SKILL 中 HR#1 相关表述已统一为"Human Review #1" +- [ ] Architect SKILL 已补充"职责边界"章节 +- [ ] Platform/SRE SKILL 已补充"职责边界"和"输出格式"章节 +- [ ] 7 个 SKILL 的禁止行为章节已统一补充"产出者不评审自己" +- [ ] PMO SKILL 章节顺序已调整为"何时启用"在"必读文档"之前 +- [ ] 本 issue 已按严格研发交付流程重新进入 Gate 1，而非直接复用历史治理结论 + +## 8. 风险 + +| 风险 | 影响 | 缓解 | +|------|------|------| +| 修复只改文本、不改结构，后续继续漂移 | 高 | 在 PRD 中明确章节模板与命名规则 | +| 命名统一后与其他引用文档冲突 | 中 | 统一回链当前有效流程文档，触发后续文档修订 | +| 强制规则声明后实际行为未变 | 中 | 在 QA Case 中验证文本存在性，并在后续 issue 中验证执行 | + +## 9. 依赖 + +- `docs/pmo/issues/010_2026-04-17_governance_skill_structure_consistency.md` +- `docs/pmo/resolutions/010_2026-04-17_governance_skill_structure_consistency_resolution.md` +- 当前有效 skill 源文件状态 +- Issue #17 当前讨论上下文 + +## 10. 评审记录 + +| 日期 | 评审人 | 备注 | 决策 | +|---|---|---|---| +| 2026-04-22 | PM | 按严格研发交付流程重新启动 #17，起草当前有效 PRD | Draft |