Appearance
Everything Claude Code GAN Planner Agent 是一款专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）设计的产品规划代理，能够把一句简短的需求扩展为包含产品愿景、设计规范、优先级功能清单、验收标准和评估细则的完整产品规格文档。它是 GAN Harness 多代理工作流的起点，确保后续自动化开发和测试有清晰、具体、可执行的目标，显著提升生成式开发的质量与一致性。
Everything Claude Code GAN Planner Agent：将一行需求扩展为含功能列表和验收标准的完整产品规格
在 AI 辅助编程和自动化产品开发场景中，如何将一句模糊的需求高效、系统地转化为可落地的产品规格，是影响最终交付质量的关键。Everything Claude Code GAN Planner Agent（简称 GAN Planner）正是为此而生——它能自动将一行需求扩展为包含功能列表、验收标准、设计规范和评估细则的完整产品规格文档，为后续的生成（Generator Agent）和评估（Evaluator Agent）提供坚实基础。
1. GAN Planner Agent 是什么？解决什么问题？
GAN Planner Agent 是 Everything Claude Code 插件体系中的专业产品规划代理，专注于把一句简短的产品需求（如“做一个团队任务看板”）扩展成结构化、细致、可执行的产品规格说明书。其输出不仅包含详细的功能分解，还覆盖 UI/UX 设计方向、技术选型、验收标准和评估细则，确保生成式开发流程有明确的目标和高质量标准。
核心价值：
- 避免“AI 糊弄”或“功能遗漏”，让生成式开发有据可依
- 明确验收标准，便于自动化测试和对抗式评估
- 结构化输出，适合多 Agent 协同与持续迭代
- 适配 GAN Harness 工作流，实现从需求→规划→生成→评测的闭环
与直接让 Claude 或 Codex“帮我写个 X 应用”不同，GAN Planner Agent 强制先产出高质量、细致的产品规格，极大提升后续自动生成代码和自动验收的可控性与专业度。
推荐阅读：Everything Claude Code 完全指南：38 Agent + 156 Skill 的生产级 AI 编程插件、Claude Code 快速上手指南：Skills、Hooks、Subagents、MCP 实战配置
2. GAN Planner Agent 能做什么？不能做什么？
能做什么
一行需求→完整产品规格
- 自动命名 App，明确愿景与设计风格
- 输出具体的色彩、字体、布局、视觉元素建议
- 按优先级拆分 Must-Have/Should-Have/Nice-to-Have 功能，并为每项功能写出详细说明与验收标准
- 明确技术栈选型（前后端、数据库、关键依赖库）
- 生成定制化评估细则（设计、创意、工艺、功能性等多维度评分标准）
- 拆解 Sprint 计划，定义每阶段目标与完成标准
- 自动写入
gan-harness/spec.md（产品规格）和gan-harness/eval-rubric.md（评估细则）
高质量标准化输出
- 强制覆盖边界场景（空态、错误态、加载态、响应式等）
- 明确交互细节（如拖拽、快捷键、动画等）
- 明确“反 AI 糊弄”要求（如避免滥用渐变、模板化卡片等）
不能做什么
- 不直接生成代码（由 GAN Generator Agent 完成）
- 不负责自动测试（由 GAN Evaluator Agent 执行）
- 不处理具体实现细节（如具体 API 设计、数据库 Schema 设计等由后续 Agent 细化）
- 不适合需求极为模糊、无明确目标的场景（建议先用 Product Lens Skill 明确“为什么”）
3. 典型适用场景：什么时候必须用 GAN Planner Agent？
- 自动化产品开发闭环：需要从一句需求到自动生成代码、自动评测，确保每一步都有明确标准
- 团队协作/多 Agent 工作流：需要结构化、可追溯的产品规格，便于 Generator/Evaluator 等 Agent 协同
- 高质量交付/验收驱动开发：对功能覆盖、设计细节、交互体验有较高要求
- 快速原型/竞品对标：希望短时间内产出具备差异化和专业度的产品方案
4. 触发方式：自动激活 vs 手动调用
- 自动激活：当检测到用户输入为“新功能/新产品”类一行需求时，系统会自动调用 GAN Planner Agent，生成完整规格文档
- 手动调用：开发者可在任何阶段手动触发 GAN Planner Agent，指定需求 brief，强制生成/更新产品规格（如：
/agent gan-planner "做一个 AI 记账本"）
与传统的 planner agent 不同，GAN Planner Agent 输出更注重产品体验、验收标准和设计细节，适用于 GAN Harness 自动化生成-评测闭环。
5. 与其他 Agent 的协作模式
GAN Planner Agent 通常作为 GAN Harness 工作流的第一步，后续与 Generator 和 Evaluator 形成闭环：
- GAN Generator Agent：根据
spec.md逐项实现功能，严格对照验收标准开发 - GAN Evaluator Agent：读取
eval-rubric.md，自动对生成应用进行端到端测试和评分 - Doc Updater Agent：自动同步产品规格到项目文档
- Code Reviewer Agent：对生成代码进行质量和安全审查
常见组合用法：
- 用户输入一句需求
- GAN Planner Agent 生成产品规格
- GAN Generator Agent 逐步实现并提交代码
- GAN Evaluator Agent 自动测试、打分、生成评审报告
- Code Reviewer/Doc Updater 等 Agent 跟进补充
6. 实际使用示例
示例对话：
用户输入：
做一个团队任务看板，支持拖拽排序和多成员协作系统自动激活 GAN Planner Agent，输出（摘要）：
markdown
# Product Specification: TaskFlow Pro
> Generated from brief: "做一个团队任务看板，支持拖拽排序和多成员协作"
## Vision
TaskFlow Pro 旨在为团队提供实时协作、高度可定制的任务管理体验，强调流畅的交互和极致的可用性。
## Design Direction
- **Color palette**: #0057b8 primary, #f4f7fa background, #ffb300 accent
- **Typography**: Inter Bold/Regular，层级分明
- **Layout philosophy**: 多列瀑布流，信息密度高
- **Visual identity**: 自定义图标、动态状态指示、避免模板化卡片
- **Inspiration**: Trello、Linear、Notion
## Features (prioritized)
### Must-Have (Sprint 1-2)
1. 看板多列视图（支持自定义列名、顺序）——用户可添加/编辑/删除列，验收：可拖拽调整顺序
2. 任务卡片拖拽排序——任务可在列间自由拖拽，验收：顺序实时保存
3. 多成员实时协作——支持多人同时操作，验收：操作自动同步
...
## Evaluation Criteria
### Design Quality (0.3)
- 视觉统一，交互流畅，避免 AI 生成常见模板化样式
### Originality (0.2)
- 独特的交互细节和视觉元素
### Craft (0.3)
- 动画流畅，状态切换自然，边界场景处理完善
### Functionality (0.2)
- 关键用户流程全覆盖（如添加任务、拖拽、协作）
## Sprint Plan
### Sprint 1: Core Board
- Goals: 实现基础看板、多列、拖拽
- Features: #1, #2
- Definition of done: 所有功能通过验收标准，E2E 测试覆盖
...（实际输出会更完整，包含 12~16 个功能、详细验收标准和设计规范）
7. 为什么要用专门的 GAN Planner Agent，而不是直接问 Claude？
直接让 Claude/Codex 生成产品规格，往往会出现：
- 功能覆盖不全，缺少验收标准
- 设计描述模糊，难以落地
- 缺乏结构化输出，后续自动生成和测试难以衔接
- 容易出现“AI 糊弄”风格（如模板化 UI、无差异化体验）
GAN Planner Agent 通过强制结构化模板、明确验收标准、反 AI 糊弄指令和多 Agent 协同接口，确保每个需求都能产出专业、细致、可执行的产品规格，极大提升自动化开发的可控性和交付质量。
延伸阅读：Everything Claude Code GAN Generator Agent：根据规格实现功能并持续迭代的生成代理、Everything Claude Code GAN Evaluator Agent：用 Playwright 测试应用并按评分标准打分的对抗式评估
FAQ
Q: GAN Planner Agent 与普通的 planner agent 有什么区别？
A: GAN Planner Agent 输出更注重产品体验、设计细节和验收标准，适用于 GAN Harness 自动化生成-评测闭环，而普通 planner 主要关注开发任务分解。
Q: 生成的产品规格可以自定义结构或内容吗？
A: 输出结构是强制标准化的（见上文），但你可以通过补充 brief 或多轮对话引导 GAN Planner 细化某些部分。
Q: 适合哪些项目或团队使用？
A: 适合需要自动化原型、AI 生成开发、验收驱动交付的团队，尤其适合多 Agent 协同和高质量标准场景。
Q: GAN Planner Agent 会自动更新规格文档吗？
A: 支持手动和自动触发更新，适配需求变更或多轮迭代，输出始终写入 gan-harness/spec.md 和 eval-rubric.md。