Skip to content

Commit 7c2f247

Browse files
alpha-86claude
alpha-86
and
claude
committed
fix: GOV-011 收口实现边界与变更追溯规则
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 24565dd commit 7c2f247

10 files changed

Lines changed: 458 additions & 41 deletions

‎docs/memo/issue_20_pm_structured_comment_draft_2026-04-21.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Issue #20 PM 结构化评论草稿
2+
3+
- project_id: alpha-86-AgentDevFlow
4+
- 当前问题: GOV-011（HR#1 流程违规 + 变更追溯规则缺失）已完成主体治理修复，但主线状态与正式留痕仍需同步
5+
- 当前主线状态: 治理修复主体已完成，待同步正式留痕并验收
6+
- #20 / #3 关系: #20 是当前主任务；#3 是暂停中的关联业务 issue，待 #20 完成后恢复推进
7+
8+
## 已完成修复项
9+
10+
1. `prompts/002_develop_pipeline.md` 已增强变更追溯规则，明确：
11+
- Gate 流程必须串行执行，禁止并行迭代
12+
- 明确重大变更 / 小幅变更定义
13+
- 增加变更来源到 Gate 重审路径的规则表
14+
- 强化 Gate 准入条件中的上游 Approved 检查
15+
2. 已产出治理决议文档：`docs/pmo/resolutions/GOV-011_2026-04-20_change_propagation_gate_violation_resolution.md`
16+
3. 已将项目内部主线口径修正为：#20 当前主任务，#3 暂停等待恢复
17+
18+
## 剩余待同步项
19+
20+
1. 将 PM 结构化结论正式回写到 Issue #20 评论区
21+
2. 由 Team Lead / PMO 对治理修复结果进行验收确认
22+
3. 验收通过后，再决定 #20 是否进入关闭请求阶段
23+
24+
## 建议验收条件
25+
26+
必须同时满足以下条件：
27+
28+
1. GOV-011 规则修复已在 `prompts/002_develop_pipeline.md` 落地
29+
2. GOV-011 决议文档已完整留痕并可回链
30+
3. 项目主线口径在 registry / status board / issue comment 三处一致
31+
4. Team Lead / PMO 已确认治理修复完成且无新增阻塞项
32+
33+
## 当前结论
34+
35+
Issue #20 当前不宜直接判定为“已结案”。更准确的状态是：治理修复主体已完成，待同步正式留痕并验收。验收完成后，才可申请进入关闭流程。

‎docs/memo/kickoff_2026-04-21.md‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
# 启动会纪要 — AgentDevFlow 团队重启 (2026-04-21)
2+
3+
## 基本信息
4+
5+
- **时间**: 2026-04-21
6+
- **项目**: alpha-86-AgentDevFlow
7+
- **当前主任务**: #20 (GOV-011 治理修复)
8+
- **关联业务 issue**: #3 (gstack/superpower 增强层接入，暂停中)
9+
- **Team Lead**: Human (alpha-86)
10+
- **当前阶段**: #20 治理修复主体已完成，待同步正式留痕并验收
11+
12+
## 团队角色加载
13+
14+
| 角色 | Agent ID | 状态 | 备注 |
15+
|------|----------|------|------|
16+
| Team Lead | team-lead@alpha-86-AgentDevFlow | ✅ 保留角色 | Human |
17+
| Product Manager | product-manager@alpha-86-AgentDevFlow | ✅ 已初始化 | 9 项启动文档已读 |
18+
| 架构师 | architect@alpha-86-AgentDevFlow | ✅ 已初始化 | 启动文档已读，额外强制清单已补齐 |
19+
| QA Engineer | qa-engineer@alpha-86-AgentDevFlow | ✅ 已初始化 | 9 项启动文档已读 |
20+
| Engineer | engineer@alpha-86-AgentDevFlow | ✅ 已初始化 | 11 项启动文档已读 |
21+
| Platform/SRE | platform-sre@alpha-86-AgentDevFlow | ✅ 已初始化 | 9 项启动文档已读 |
22+
| PMO | pmo@alpha-86-AgentDevFlow | ✅ 已初始化 | 9 项启动文档已读 |
23+
24+
## 任务队列状态
25+
26+
- **GitHub open issues**: 9 个
27+
- **已同步至 task_queue**: 9 个
28+
- **路由结果**: 全部 9 个路由至 Product Manager
29+
30+
## 当前活跃任务
31+
32+
1. **Issue #20** (GOV-011) — HR#1 流程违规 + 变更追溯规则缺失
33+
- 分配给: Product Manager + PMO (协同)
34+
- 状态: in_progress
35+
- 关联: Issue #3
36+
37+
## 待处理 Issues (Open)
38+
39+
| Issue | 标题 | 类型 | 优先级 | 路由 |
40+
|-------|------|------|--------|------|
41+
| #3 | gstack/superpower 增强层接入 | feature | high | PM |
42+
| #5 | AgentDevFlow bootstrap 完善 | feature | medium | PM |
43+
| #8 | GOV-004 HR#1 被跳过 | process | medium | PM |
44+
| #16 | GOV-009 职责归属矩阵缺失 | governance | medium | PM |
45+
| #17 | GOV-010 Skill 结构冲突 | governance | medium | PM |
46+
| #18 | Agent 获取 Issue Comment 不规范 | bug | medium | PM |
47+
| #19 | 安装脚本 bug 问题 | bug | medium | PM |
48+
| #20 | GOV-011 HR#1 流程违规 | governance | medium | PM |
49+
| #21 | prompts 原则：禁止单一 pattern 式描述 | process | medium | PM |
50+
51+
## 启动决议
52+
53+
1. **本轮优先**: 完成 Issue #20 治理修复，防止 Issue #3 复发同类违规
54+
2. **Issue #3**: 关联业务 issue，当前暂停；待 Issue #20 完成后再恢复 Gate 2 Tech Review
55+
3. **新规范**: 所有 prompt 描述必须采用 "pattern + 枚举" 组合方式 (Issue #21)
56+
4. **禁止行为重申**: Team Lead 不得越权替其他角色决策；Issue 关闭为 Human 专属
57+
58+
## 下一 Gate
59+
60+
- Issue #20 完成后 → 回到 Issue #3 Gate 2 继续推进
61+
- 或按优先级处理其他 open issues
62+
63+
## 纪要输出
64+
65+
- 本文件: `docs/memo/kickoff_2026-04-21.md`
66+
- 待办注册: `docs/todo/TODO_REGISTRY.md`
67+
- 项目状态板: `docs/memo/project_status_2026-04-21.md`（已创建）

‎docs/memo/project_status_2026-04-21.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# 项目状态板 — AgentDevFlow (2026-04-21)
2+
3+
## 项目概览
4+
5+
| 字段 | 值 |
6+
|------|-----|
7+
| project_id | alpha-86-AgentDevFlow |
8+
| 当前主任务 | Issue #20 (GOV-011 治理修复) |
9+
| 暂停任务 | Issue #3 (gstack/superpower) — 关联业务 issue，待 #20 完成后恢复 |
10+
| Team Lead | Human (alpha-86) |
11+
| 最后更新 | 2026-04-21 |
12+
13+
## 活跃任务
14+
15+
| Issue | 标题 | 阶段 | Owner | 状态 | 阻塞项 |
16+
|-------|------|------|-------|------|--------|
17+
| #20 | GOV-011 HR#1 流程违规 | 治理修复 | PM + PMO | 治理修复主体已完成，待同步正式留痕并验收 | 待 Team Lead / PMO 验收确认 |
18+
| #3 | gstack/superpower 增强层接入 | ⏸️ 暂停 | PM | ⏸️ 暂停 | 等 Issue #20 完成 |
19+
20+
## Open Issues 队列 (9 个)
21+
22+
| Issue | 标题 | 类型 | 优先级 | 状态 |
23+
|-------|------|------|--------|------|
24+
| #20 | GOV-011 HR#1 流程违规 | governance | medium | 🔄 in_progress |
25+
| #3 | gstack/superpower 增强层接入 | feature | high | ⏸️ 暂停 |
26+
| #5 | AgentDevFlow bootstrap 完善 | feature | medium | pending |
27+
| #8 | GOV-004 HR#1 被跳过 | process | medium | pending |
28+
| #16 | GOV-009 职责归属矩阵缺失 | governance | medium | pending |
29+
| #17 | GOV-010 Skill 结构冲突 | governance | medium | pending |
30+
| #18 | Agent 获取 Issue Comment 不规范 | bug | medium | pending |
31+
| #19 | 安装脚本 bug 问题 | bug | medium | pending |
32+
| #21 | prompts 原则：禁止单一 pattern 式描述 | process | medium | pending |
33+
34+
## 团队状态
35+
36+
| 角色 | 初始化 | 当前工作 |
37+
|------|--------|---------|
38+
| Product Manager | ✅ | 等待分派 #20 正式检查范围 |
39+
| PMO | ✅ | 等待分派 #20 正式审计范围 |
40+
| 架构师 | ✅ | 可执行 #20 架构合规审查 |
41+
| QA Engineer | ✅ | 可执行 #20 QA 验证清单核查 |
42+
| Engineer | ✅ | 可执行 #20 实现前置条件核查 |
43+
| Platform/SRE | ✅ | GOV-011 平台侧现状核查 |
44+
45+
## 风险与阻塞
46+
47+
| # | 风险 | 级别 | Owner | 缓解措施 |
48+
|---|------|------|-------|---------|
49+
| 1 | Issue #3 曾发生 PRD 变更未重新走 Gate 1 | P1 | PM + PMO | Issue #20 产出修复方案 |
50+
| 2 | Issue #3 各 Agent 状态判断不一致 | P2 | PMO | Issue #20 完成后统一审计 |
51+
| 3 | 9 个 open issues 堆积 | P2 | Team Lead | 按优先级逐个处理 |
52+
53+
## 产物关联
54+
55+
- 启动会纪要: `docs/memo/kickoff_2026-04-21.md`
56+
- 待办注册: `docs/todo/TODO_REGISTRY.md`
57+
- 项目状态板: `docs/memo/project_status_2026-04-21.md` (本文件)
58+
- PM 结构化评论草稿: `docs/memo/issue_20_pm_structured_comment_draft_2026-04-21.md`
59+
- GOV-011 治理决议: `docs/pmo/resolutions/GOV-011_2026-04-20_change_propagation_gate_violation_resolution.md`
60+
- PMO Issue 011: `docs/pmo/issues/011_2026-04-20_governance_hr1_rejected_and_gate_violation.md`

‎docs/pmo/resolutions/GOV-011_2026-04-20_change_propagation_gate_violation_resolution.md‎

Lines changed: 189 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,189 @@
1+
# GOV-011 变更追溯规则缺失 + Gate 流程并行化违规
2+
3+
## 基本信息
4+
5+
| 字段 | 内容 |
6+
|------|------|
7+
| PMO Issue | `../issues/011_2026-04-20_governance_hr1_rejected_and_gate_violation.md` |
8+
| GitHub Issue | https://github.com/alpha-86/AgentDevFlow/issues/20 |
9+
| 关联 Issue | #3 (gstack/superpower 增强层接入) |
10+
| 讨论日期 | 2026-04-20 |
11+
| 验收日期 | 2026-04-21 |
12+
| 状态 | ✅ 已执行，待验收 |
13+
14+
---
15+
16+
## 一、问题回顾
17+
18+
Issue #3 在 PRD v3 → v4.1 迭代过程中，**PRD 变更后未重新走 Gate 1 → Gate 2 流程就并行更新了 Tech Spec 和 QA Case**，导致 Tech Spec v5 的"可选"语义与 PRD v4.1 的"强制依赖"语义不一致，Architect 在 HR#1 阶段发现并 Reject。
19+
20+
### 违规事实
21+
22+
1. **PRD v3 → v4.1 发生重大语义变更**（可选增强 → 强制依赖），未重新触发 Gate 1 评审
23+
2. **Gate 流程被并行化**：Tech Spec v4 和 QA Case v2 在 Gate 1（v3）还未最终确认时就开始并行迭代
24+
3. **Gate 2 未完成就起草 QA Case**：违反 `prompts/002_develop_pipeline.md` 的 Gate 顺序约束
25+
26+
### 时间线
27+
28+
| 日期 | 事件 | 合规性 |
29+
|------|------|--------|
30+
| 2026-04-17 | PRD v3 Gate 1 三方签字完成 | ✅ |
31+
| 2026-04-17 | **Tech Spec v4 + QA Case v2 在 Gate 1（v3）未最终确认时并行迭代** | ❌ 违规 |
32+
| 2026-04-17 | QA Case Design 在 Gate 2 未完成前开始起草 | ❌ 违规 |
33+
| 2026-04-20 | PRD v3 → v4.1（可选→强制，重大语义变更） | — |
34+
| 2026-04-20 | Tech Spec v5 完成，但 Section 4.3 仍写"可选" | ❌ 与 PRD v4.1 语义冲突 |
35+
| 2026-04-20 | HR#1：Architect Rejected（语义冲突）| — 发现问题 |
36+
| 2026-04-20 | Tech Spec v5.1 修复（可选→强制对齐）| ✅ 纠正 |
37+
| 2026-04-20 | HR#1 重新评审：QA + Architect Approved | ✅ 流程恢复 |
38+
39+
---
40+
41+
## 二、根因分析
42+
43+
### 直接原因
44+
45+
PRD v3 → v4.1 发生"可选→强制依赖"重大语义变更后，Gate 1 重新评审未完成，Tech Spec 和 QA Case 就开始并行更新。
46+
47+
### 根因
48+
49+
1. **变更追溯规则虽有但不够显式**：`prompts/002_develop_pipeline.md` 虽有"变更级联效应"章节，但未明确声明 **"Gate 流程必须串行，禁止并行迭代"**
50+
2. **重大变更 vs 小幅变更缺乏定义标准**：Agent 无法判断一次 PRD 变更是否触发完整 Gate 重审
51+
3. **Gate 阶段边界模糊**：Tech Spec 在 PRD Gate 1 评审期间就开始更新，QA Case 在 Gate 2 完成前就开始起草
52+
53+
### 深层原因
54+
55+
Agent 在迭代过程中倾向于"并行推进多个文档"以加速交付，但忽略了 Gate 流程的串行约束。流程文档中的"变更级联效应"被当作"建议"而非"强制规则"执行。
56+
57+
---
58+
59+
## 三、讨论对齐结论
60+
61+
### 结论 1：Gate 流程串行约束（强制）
62+
63+
**决定**：Gate 流程 **必须串行执行，禁止并行迭代**。
64+
65+
**理由**：下游文档依赖上游文档的评审结论，并行迭代会导致文档间语义不一致，最终只能在 HR#1 阶段发现（代价高）。
66+
67+
**正确流程**：
68+
```
69+
PRD 变更
70+
│
71+
▼
72+
Gate 1（PRD Review）重新评审 → 三方签字 Approved
73+
│
74+
▼
75+
Tech Spec 更新 → Gate 2（Tech Review）→ 三方签字 Approved
76+
│
77+
▼
78+
QA Case Design 更新 → 三方签字 Approved
79+
│
80+
▼
81+
文档 PR → Human Review #1
82+
```
83+
84+
**禁止行为**：
85+
- PRD 在 Gate 1 评审期间，Tech Spec 不得更新
86+
- Tech Spec 在 Gate 2 评审期间，QA Case 不得起草
87+
- 任何 Gate 未 Approved 前，不得进入下游 Gate 的文档编写
88+
89+
### 结论 2：变更等级定义标准
90+
91+
**决定**：明确"重大变更"和"小幅变更"的定义，作为是否触发完整 Gate 重审的判断依据。
92+
93+
**重大变更**（必须触发完整 Gate 重审）：
94+
| 类型 | 示例 |
95+
|------|------|
96+
| 语义变化 | 可选→强制、单一→多个、范围扩大/缩小 |
97+
| 新增/删除交付域 | 新增文档类型、删除验收标准章节 |
98+
| 角色数量变化 | 5 角色→6 角色 |
99+
| 关键验收标准变更 | 验收标准新增/删除/修改判定条件 |
100+
| 架构决策变更 | 技术选型改变、检测方式改变 |
101+
102+
**小幅变更**（仅需原 Gate 签字人确认，无需完整 Gate 重审）：
103+
| 类型 | 示例 |
104+
|------|------|
105+
| 文档格式调整 | 表格对齐、标题层级调整 |
106+
| 错别字修正 | 不影响语义的文字修正 |
107+
| 描述文字澄清 | 不改变语义的范围澄清 |
108+
| 补充遗漏内容 | 不改变范围的补充说明 |
109+
| 链接修正 | 文档链接更新 |
110+
111+
### 结论 3：变更追溯规则增强
112+
113+
**决定**：将变更追溯规则增强后写入 `prompts/002_develop_pipeline.md`，作为强制规则而非建议。
114+
115+
**增强规则**：
116+
117+
| 变更来源 | 变更等级 | 需重新通过的 Gate | 下游文档处理 |
118+
|---------|---------|------------------|-------------|
119+
| PRD | 重大 | Gate 1 → Gate 2 → QA Case Design → 重新评审全部 | Tech Spec 版本+1 → Case Design 版本+1 |
120+
| PRD | 小幅 | 原 Gate 1 签字人确认即可 | Tech Spec 版本+0.1 → 确认无影响后无需 Case Design 变更 |
121+
| Tech Spec | Major/Breaking | Gate 2 → QA Case Design → 重新评审 | Case Design 版本+1 |
122+
| Tech Spec | 小幅 | 原 Gate 2 签字人确认即可 | Case Design 确认无影响 |
123+
| QA Case | 任意 | QA Case Design 重新评审 | 测试报告版本+1（如有）|
124+
| 多环节同时变更 | — | 从头重新走 Gate 1 → Gate 2 → QA Case | 全部文档版本+1 |
125+
126+
### 结论 4：Gate 阶段准入检查清单
127+
128+
**决定**：每个 Gate 的"进入条件"增加"上游 Gate 已 Approved"的显式检查。
129+
130+
| Gate | 进入条件（新增/强化） |
131+
|------|---------------------|
132+
| Gate 1 | PRD 已起草，无未完成的下游文档更新 |
133+
| Gate 2 | **PRD Gate 1 已 Approved**（新增显式检查），Tech Spec 已起草 |
134+
| QA Case Design | **Gate 2 已 Approved**（新增显式检查），QA Case 已起草 |
135+
| 文档 PR | 所有 Gate 签字已落地，无未完成的文档变更 |
136+
137+
---
138+
139+
## 四、修复方案
140+
141+
### 本次已完成修复
142+
143+
| 动作 | 涉及文件 | 验收标准 | 负责人 | 状态 |
144+
|------|---------|---------|--------|------|
145+
| 增强"变更级联效应"章节：新增串行约束、变更等级定义、增强追溯规则 | `prompts/002_develop_pipeline.md` | 文档已更新，规则明确为强制 | PM | ✅ 已完成 |
146+
| 补充 Gate 准入强化说明：显式要求上游 Gate 已 Approved | `prompts/002_develop_pipeline.md` | 文档中存在 Gate 进入条件强化表 | PM | ✅ 已完成 |
147+
| 产出 GOV-011 治理决议文档 | `docs/pmo/resolutions/GOV-011_2026-04-20_change_propagation_gate_violation_resolution.md` | 根因、决议、修复建议完整留痕 | PM | ✅ 已完成 |
148+
149+
### 后续建议修复
150+
151+
| 动作 | 涉及位置 | 验收标准 | 负责人 | 状态 |
152+
|------|---------|---------|--------|------|
153+
| 同步更新 `prompts/004_delivery_gates.md` 的 CI 检查参考口径 | `prompts/004_delivery_gates.md` | 与 `002_develop_pipeline.md` 保持一致 | PM / Team Lead | ⏳ 建议跟进 |
154+
| PMO 检查清单增加"Gate 并行化"检查项 | `docs/pmo/issues/` 模板 | PMO Issue 模板包含 Gate 顺序检查 | PMO | ⏳ 建议跟进 |
155+
| 各角色 SKILL.md 补充"禁止在下游 Gate 并行迭代文档" | `skills/*/SKILL.md` | 角色规范与流程规则一致 | Team Lead | ⏳ 建议跟进 |
156+
157+
### Issue #3 已修复项
158+
'}
159+
| 修复项 | Commit | 状态 |
160+
|--------|--------|------|
161+
| Tech Spec v5.1 修复可选→强制语义 | 73028fe | ✅ 已修复 |
162+
| HR#1 重新评审 Approved | — | ✅ 已通过 |
163+
164+
---
165+
166+
## 五、GitHub Issue 追踪
167+
168+
| 字段 | 内容 |
169+
|------|------|
170+
| GitHub Issue URL | https://github.com/alpha-86/AgentDevFlow/issues/20 |
171+
| 责任人 | PM |
172+
| 关联 PMO Issue | `../issues/011_2026-04-20_governance_hr1_rejected_and_gate_violation.md` |
173+
| 关联 GOV | GOV-004（Issue #3 HR#1 被跳过） |
174+
175+
---
176+
177+
## 六、验收结论
178+
179+
| 字段 | 内容 |
180+
|------|------|
181+
| 最终验收人 | Team Lead |
182+
| 验收日期 | 2026-04-21 |
183+
| GitHub Issue 状态 | ⏳ Open |
184+
| PMO Issue 状态 | ⏳ Open |
185+
| 文档更新状态 | ✅ 已完成（002_develop_pipeline.md 变更级联效应增强） |
186+
187+
---
188+
189+
*由 Product Manager 基于 PMO 检查记录生成 | 2026-04-21*

‎docs/pmo/resolutions/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,3 +98,4 @@ PMO 发现问题 → 记录到 docs/pmo/issues/
9898
| RB-001 | Team Lead 深度介入具体 Issue 跟踪 | — | `RB-001_..._resolution.md` | Open |
9999
| RB-002 | Architect 被分配代码实现任务 | — | `RB-002_..._resolution.md` | Closed |
100100
| GOV-004 | Issue #3 Human Review #1 被跳过 | https://github.com/alpha-86/AgentDevFlow/issues/8 | `GOV-004_2026-04-16_issue3_hr1_skipped_resolution.md` | Open |
101+
| GOV-011 | 变更追溯规则缺失 + Gate 流程并行化违规 | https://github.com/alpha-86/AgentDevFlow/issues/20 | `GOV-011_2026-04-20_change_propagation_gate_violation_resolution.md` | Open |

0 commit comments

Comments
 (0)