Issue_discuss#2:讨论gstack与superpower增强层接入

[alpha-86]

背景

基于 prompts/discuss/028_2026-04-14_gstack与superpower增强层接入方案.md 的讨论结论，当前需要明确 gstack / superpower 作为 AgentDevFlow 能力增强层的接入方式。

讨论目标

1. 明确增强层在 AgentDevFlow 中的定位
2. 确定是否引入显式开关控制增强层开启/关闭
3. 确定开启增强层时是否要求安装 gstack 与 superpower skill 包
4. 梳理各角色适合接入的可选增强 skill
5. 明确增强层输出与正式交付物、Gate 结论之间的边界

关联文档

• https://github.com/alpha-86/AgentDevFlow/blob/main/prompts/discuss/028_2026-04-14_gstack%E4%B8%8Esuperpower%E5%A2%9E%E5%BC%BA%E5%B1%82%E6%8E%A5%E5%85%A5%E6%96%B9%E6%A1%88.md

建议后续动作

• 统一 README / 平台接入文档中的增强层口径
• 明确增强层开关的语义与默认值
• 梳理各角色可选增强 skill 清单
• 决定是否继续进入实现阶段

[github-actions]

AgentDevFlow Issue 已接收，正在处理。

任务队列: .claude/task_queue/issue_3.task

此评论由 GitHub Actions 自动生成

[alpha-86]

PRD 讨论摘要 - Issue #3 接管

project_id: alpha-86/AgentDevFlow
Gate: PRD Discussion (in_prd)
owner: Product Manager
date: 2026-04-15

问题

当前 README.md 已明确 AgentDevFlow、gstack、superpower 三者的差异定位，但尚无正式决策：

1. gstack/superpower 是否作为 AgentDevFlow 的能力增强层接入
2. 如何设计增强层的开关机制（默认关闭）
3. 各角色在哪些阶段适合启用增强能力
4. 增强层输出与正式交付物之间的边界

目标

建立 AgentDevFlow 的"gstack/superpower 能力增强层"接入规范，包括定位、开关语义、角色映射、边界约束，并落地到文档。

范围

• AgentDevFlow 各角色的增强 skill 映射（PM/Architect/QA/Engineer/Team Lead）
• 增强层开关设计（默认关闭，启用需安装前置）
• 增强层与正式交付物的边界约束
• 文档落地（README/平台接入文档/角色文档）

非目标

• 不改造 AgentDevFlow 核心流程（Issue/Gate/PR/Human Review）
• 不将 gstack/superpower 作为 1.0 强依赖
• 不做增强层的配置化实现（第一步仅做文档口径收口）

验收标准

• README/平台接入文档中明确增强层定位和开关口径
• 各角色文档中补充"可选增强 skill"说明
• 增强层开关默认值和前置条件已明确
• 增强层输出不能替代正式 Gate 结论的约束已声明

关联文档

• 讨论结论：prompts/discuss/028_2026-04-14_gstack与superpower增强层接入方案.md
• gstack 能力分析：prompts/discuss/016_phase_5_3_2026-04-10_gstack可选依赖说明.md
• superpower 复用边界：prompts/discuss/016_phase_5_2_2026-04-10_superpowers复用边界.md

当前状态

Issue 已接管，PRD 讨论阶段启动。下一步：PM 起草正式 PRD，Architect 评估可行性。

阻塞项

• 无

[alpha-86]

PRD #3 起草完成

project_id: alpha-86/AgentDevFlow
Gate: PRD Review (Gate 1)
owner: Product Manager
date: 2026-04-15

PRD 链接

docs/prd/003_adf_enhancement_layer_2026-04-15.md

核心范围（5 个交付域）

4.x 子项	核心交付物
4.1 增强层定位声明	README/平台文档中明确三者定位关系
4.2 增强层开关设计	开关语义（默认关闭）+ 前置条件
4.3 角色增强映射	5 角色 × 增强 skill × 适用阶段
4.4 输出边界约束	增强输出不能替代正式交付物
4.5 安装前置说明	gstack + superpower 安装条件

非目标（边界明确）

• 不改造核心流程
• 不做配置化开关实现（第一步仅文档口径收口）
• 不让 skill 输出替代 Gate 结论

下一步

Team Lead 评审 PRD #3（Gate 1）。

[alpha-86]

我认为需要 增加自动检测能力，如果监测到安装了 gstack 或者 superpower，就是用 gstack或者superpower的能力增强。如果没有安装，就回落到当前项目内的实现，并建议用户安装 gstack和superpower。

[alpha-86]

Gate 1 PRD Review — 通过 ✅

阶段门: PRD Gate 1
Issue: #3
评审人: Team Lead
结论: Approved
日期: 2026-04-15

证据链接

• PRD: docs/prd/003_adf_enhancement_layer_2026-04-15.md

关键意见

1. PRD Issue_discuss#2:讨论gstack与superpower增强层接入 #3 结构完整，5 个交付域边界清晰
2. Section 4.4 输出边界约束合理（skill 输出不能替代正式交付物）
3. Section 4.2 增强层开关是语义定义，非技术实现

备注

本次为纯文档交付。Section 4.2 的"增强层开关"是语义口径，不是配置化实现。非目标明确不实现增强层的配置化开关。

行动项

行动项	负责人
Architect 起草 Tech Spec（纯文档，无代码变更）	Architect
5 个交付域文档落地	PM / Architect

下一阶段门准入条件

Tech Spec Review（Gate 2）入场条件：

• Architect 完成 Tech Spec 评审
• Tech Spec 明确各交付域的技术实现路径

当前 Issue #3 状态

状态: in_prd → in_tech
下一动作: Architect 起草 Tech Spec

[alpha-86]

PRD #3 迭代 v2 — 自动检测机制

基于: Issue #3 Comment #4（自动检测建议）
date: 2026-04-15
文件: docs/prd/003_adf_enhancement_layer_2026-04-15.md

Section 4.2 变更：从手动开关 → 自动检测+回落

变更前（手动开关）：

• 用户手动开启/关闭增强层
• 默认关闭
• 开启需满足安装前置条件

变更后（自动检测）：

• 角色初始化时自动检测 gstack / superpower 是否已安装
• 已安装 → 自动使用对应增强能力
• 均未安装 → 回落原生机制 + 提示建议安装
• 零配置，无需用户操作

变更范围

Section	变更内容
4.2	重写为自动检测+回落机制
5 非目标	从"不实现配置化开关"→"实现自动检测逻辑"
7.2 验收标准	更新为 5 项自动检测行为验证

设计理由

自动检测比手动开关更符合"零配置接入"原则，降低用户认知负担，实现真正的渐进式增强。

评审记录

日期	变更
2026-04-15	PRD v2 — Section 4.2/5/7.2 迭代

[alpha-86]

PRD #3 v2 — Gate 1 重新评审请求

阶段门: PRD Gate 1（重新评审）
Issue: #3
date: 2026-04-15

重新评审原因

v1 → v2 变更性质：纯文档 → 含代码实现

• v1 非目标："不实现配置化开关"（纯文档）
• v2 新增："实现自动检测逻辑"（代码实现）

按 Critical Rule，需重新 Gate 1。

v1 → v2 主要变更

Section	变更
4.2 机制	手动开关（默认关闭）→ 自动检测+回落
5 非目标	"不实现配置化开关" → "实现自动检测逻辑"
7.2 验收标准	开关语义验证 → 5 项自动检测行为验证

当前状态

• PRD 文件: docs/prd/003_adf_enhancement_layer_2026-04-15.md (v2)
• Gate 1: 待重新评审
• 需要三方签字: PM + QA + Team Lead

请评审人确认

1. PM: 范围一致性确认
2. QA: 可测试性确认
3. Team Lead: 方案确认

[alpha-86]

Gate 1 PRD Review v2 — 通过 ✅

阶段门: PRD Gate 1（重新评审）
Issue: #3
决策人: Team Lead + QA
结论: Approved
date: 2026-04-15

证据链接

• PRD v2: docs/prd/003_adf_enhancement_layer_2026-04-15.md

关键意见

1. v1 → v2 变更：手动开关 → 自动检测+回落机制（代码实现）
2. Section 4.2 自动检测语义合理，零配置原则明确
3. Skill 名称已修正（plan-devex-review → plan-design-review）

评审记录

日期	评审人	备注	决策
2026-04-15	Team Lead	Gate 1 v1 — 5 个交付域边界清晰	Approved ✅
2026-04-15	PM	PRD 迭代 v2 — Scope changed，含代码实现	v2
2026-04-15	PM	v2 范围一致性确认	Approved
2026-04-15	QA	v2 可测试性确认	Approved

[alpha-86]

Gate 2 Tech Review — 通过 ✅

阶段门: Tech Review (Gate 2)
Issue: #3
决策人: PM + QA + Team Lead
结论: Approved
date: 2026-04-15

证据链接

• Tech Spec: docs/tech/Tech-3_v1.md
• PRD: docs/prd/003_adf_enhancement_layer_2026-04-15.md

关键意见

1. Tech Spec v2 基于 PRD v2，覆盖 5 个文档交付域
2. 自动检测机制语义与 PRD v2 一致
3. Skill 名称全部验证通过（plan-devex-review → plan-design-review）
4. 外部依赖（skill 名称）已关闭
5. TC-1~TC-8 覆盖完整

评审记录

日期	评审人	备注	决策
2026-04-15	Architect	v2 — 自动检测机制，skill 外部依赖标注	Draft
2026-04-15	QA	v1 Conditional 已解决；TC-1~TC-8 完整	Approved
2026-04-15	PM	范围一致性确认，skill 名称已验证	Approved

当前 Issue #3 状态

状态: in_tech → in_impl（Tech Spec Approved）
下一动作: Human Review #1（文档 PR）

[alpha-86]

Gate 2 Tech Review — 通过 ✅（已更新）

阶段门: Tech Review (Gate 2)
Issue: #3
决策人: PM + Tech Lead（架构师）+ QA Engineer
结论: Approved
date: 2026-04-15

证据链接

• Tech Spec: docs/tech/Tech-3_v1.md
• PRD: docs/prd/003_adf_enhancement_layer_2026-04-15.md

三方签字确认

日期	评审人	备注	决策
2026-04-15	架构师（Tech Lead）	Gate 2 Tech Review — 技术可行性确认，v2 变更（自动检测+回落）可行，外部依赖处理合理	Approved ✅
2026-04-15	PM	范围一致性确认，skill 名称已验证	Approved ✅
2026-04-15	QA Engineer	v1 Conditional 已解决，TC-1~TC-8 完整，v2 新增验证项通过	Approved ✅

剩余阻塞

Tech Spec #3 Gate 2 已通过 ✅，但 Human Review #1 需等 Engineer 创建增强层文档（doc-3-enhancement-layer PR）。

当前 Issue #3 状态

状态: in_tech → in_impl（Gate 2 通过）
下一动作: Engineer 创建增强层文档 PR → Human Review #1