qcsd-ideation-swarm

QCSD Ideation Swarm v7.0

用于 PI Planning 和 Sprint Planning 的左移质量工程群组。

---

概述

Ideation Swarm 在开发开始前评估故事和 URL，采用 HTSM v6.3 质量标准、Risk Storming 和可测试性分析。它会给出 GO / CONDITIONAL / NO-GO 决策，是 QCSD 生命周期的第一个关卡。

QCSD 阶段定位

阶段	群组	决策	时间
构想	qcsd-ideation-swarm	GO / CONDITIONAL / NO-GO	PI/Sprint Planning
细化	qcsd-refinement-swarm	READY / CONDITIONAL / NOT-READY	Sprint Refinement
开发	qcsd-development-swarm	SHIP / CONDITIONAL / HOLD	Sprint 期间
验证	qcsd-cicd-swarm	RELEASE / REMEDIATE / BLOCK	发布前 / CI-CD
生产	qcsd-production-swarm	HEALTHY / DEGRADED / CRITICAL	发布后

参数

• URL：要分析的网站（URL 模式必填）
• OUTPUT_FOLDER：报告保存位置（默认：${PROJECT_ROOT}/Agentic QCSD/{domain}/）

独特功能

• URL 模式：通过自动化的 5 级浏览器级联分析线上网站
• HAS_VIDEO 标志：检测视频内容，并建议后续使用 /a11y-ally
• HTML 输出：当 html_output: true 时生成 HTML 报告
• 浏览器级联：Vibium -> agent-browser -> Playwright+Stealth -> WebFetch -> WebSearch-fallback

---

强制规则——请先阅读

规则	执行要求
E1	必须在步骤 2 中启动全部三个核心 Agent（qe-quality-criteria-recommender、qe-risk-assessor、qe-requirements-validator）。不得例外。
E2	必须在同一条消息中发起所有并行 Task 调用。
E3	每批次之后必须停止并等待。不得提前继续。
E4	标志为 TRUE 时，必须启动相应的条件 Agent。不得跳过。
E5	必须严格按照步骤 5 中的说明应用 GO/CONDITIONAL/NO-GO 逻辑。
E6	必须生成完整的报告结构。不得使用缩略版本。
E7	每个 Agent 在分析前都必须读取其参考文件。
E8	必须执行步骤 7 的学习持久化。不得跳过。

禁止行为：

• 以总结代替启动 Agent
• 为了“简洁”而跳过 Agent
• 后台任务完成前继续执行
• 不启动专员 Agent，而是自行分析
• 省略报告章节或使用占位文本

---

步骤执行协议

此技能采用微文件步骤架构。每个步骤都由一个独立文件构成， 每次只加载一个文件，以避免“中间遗忘”导致的上下文退化。

使用 Read 工具读取每个步骤文件，并按顺序执行。

步骤

1. 标志检测——steps/01-flag-detection.md——获取 URL 内容（浏览器级联），检测全部 7 个标志（HAS_UI、HAS_SECURITY、HAS_UX、HAS_VIDEO、HAS_MIDDLEWARE、HAS_SAP_INTEGRATION、HAS_AUTHORIZATION）
2. 核心 Agent——steps/02-core-agents.md——并行启动 qe-quality-criteria-recommender、qe-risk-assessor、qe-requirements-validator
3. 批次 1 结果——steps/03-batch1-results.md——等待核心 Agent，提取全部指标
4. 条件 Agent——steps/04-conditional-agents.md——并行启动标志所指示的条件 Agent
5. 决策综合——steps/05-decision-synthesis.md——应用 GO/CONDITIONAL/NO-GO 逻辑
6. 报告生成——steps/06-report-generation.md——生成执行摘要和完整报告
7. 学习持久化——steps/07-learning-persistence.md——将发现存入记忆，保存持久化记录，并包含视频后续处理建议
8. 最终输出——steps/08-final-output.md——显示完成摘要，包含所有评分和后续建议

执行说明

1. 使用 Read 工具加载当前步骤文件（例如，Read({ file_path: ".claude/skills/qcsd-ideation-swarm/steps/01-flag-detection.md" })）
2. 完整执行该步骤的说明
3. 确认满足所有成功标准后再继续
4. 将该步骤的输出作为上下文传递给下一步
5. 如果某个步骤失败，则停止并报告失败位置——不要跳过该步骤

---

恢复支持

若要从特定步骤恢复：指定 --from-step N，编排器将跳转至步骤 N。请确保已具备之前步骤所需的前置数据。

---

Agent 清单

Agent	类型	领域	批次
qe-quality-criteria-recommender	核心（始终运行）	需求验证	1
qe-risk-assessor	核心（始终运行）	覆盖分析	1
qe-requirements-validator	核心（始终运行）	需求验证	1
qe-accessibility-auditor	条件触发（HAS_UI）	视觉无障碍	2
qe-security-auditor	条件触发（HAS_SECURITY）	安全合规	2
qe-qx-partner	条件触发（HAS_UX）	跨领域	2
qe-middleware-validator	条件触发（HAS_MIDDLEWARE）	企业集成	2
qe-sap-rfc-tester	条件触发（HAS_SAP_INTEGRATION）	企业集成	2
qe-sod-analyzer	条件触发（HAS_AUTHORIZATION）	企业集成	2

总计：9 个 Agent（3 个核心 + 6 个条件触发）

注意：构思 swarm 有 8 个步骤（而非 9 个），因为它没有单独的最终分析 Agent 步骤。HAS_VIDEO 标志会触发针对 /a11y-ally 的后续建议，但不会额外启动 Agent。

---

质量门槛

指标	GO	CONDITIONAL	NO-GO
可测试性得分	>= 70%	40 - 69%	< 40%
风险得分	低/中	高（可缓解）	严重
需求完整度	>= 80%	50 - 79%	< 50%
质量标准覆盖度	>= 7/10 个类别	4-6/10 个类别	< 4/10 个类别

---

报告文件名映射

Agent	报告文件名	步骤
qe-quality-criteria-recommender	02-quality-criteria.md	2
qe-risk-assessor	03-risk-assessment.md	2
qe-requirements-validator	04-requirements-validation.md	2
qe-accessibility-auditor	05-accessibility-audit.md	4
qe-security-auditor	06-security-audit.md	4
qe-qx-partner	07-ux-assessment.md	4
qe-middleware-validator	08-middleware-assessment.md	4
qe-sap-rfc-tester	09-sap-assessment.md	4
qe-sod-analyzer	10-sod-compliance.md	4
学习持久化	11-learning-persistence.json	7
综合报告	01-executive-summary.md	6

---

执行模型选项

模型	使用场景	Agent 启动
Task 工具（主要）	Claude Code 会话	Task({ subagent_type, run_in_background: true })
MCP 工具	MCP 服务可用时	fleet_init({}) / task_submit({})
CLI	终端/脚本	swarm init / agent spawn

---

核心原则

质量从一开始就融入其中，而不是等到最后才进行测试。这个 swarm 确保在编写任何代码之前，用户故事具备可行性、可测试性并完成风险评估。