Agent skill · software engineering · affaan-m
gan-style-harness
受GAN启发的生成器-评估器代理框架,用于自主构建高质量应用。基于Anthropic 2026年3月的框架设计论文。
Why this skill is useful
Adds a complete executable framework for multi-agent orchestration that significantly enhances application development capabilities.
What it needs
Requires bash, playwright installed locally. About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
GAN 风格编排技能 灵感来源于 Anthropic 的长时间运行应用开发编排设计(2026年3月24日) 一种多智能体编排,将生成与评估分离,形成对抗性反馈循环,推动质量远超单个智能体所能达到的水平。 核心洞察 当要求评估自身工作时,智能体是病态的乐观主义者——它们会赞美平庸的输出,并说服自己忽略真正的问题。但设计一个独立的评估器并使其极度严格,远比教会生成器自我批评要容易得多。 这与 GAN(生成对抗网络)的机制相同:生成器负责产出,评估器负责批评,这种反馈驱动下一轮迭代。 适用场景 根据一行提示构建完整应用 需要高视觉质量的前端设计任务 需要工作功能而不仅仅是代码的全栈项目 任何"AI 垃圾"美学不可接受的任务 愿意投入 50-200 美元以获得生产级质量输出的项目 不适用场景 快速单文件修复(使用标准 claude -p) 预算紧张的任务(<10 美元) 简单重构(改用去垃圾化模式) 已有完善测试规范的任务(使用 TDD 工作流) 架构 三个智能体 1. 规划器智能体 角色: 产品经理——将简短的提示扩展为完整的产品规格。 关键行为: 接收一行提示,生成包含 16 个功能、多个冲刺的规格 定义用户故事、技术需求和视觉设计方向 故意雄心勃勃——保守规划会导致结果平庸 生成评估器后续使用的评估标准 模型: 默认 Sonnet;可通过 GANPLANNERMODEL=opus 提升以获得更深入的规格扩展 2. 生成器智能体 角色: 开发者——根据规格实现功能。 关键行为: 按结构化冲刺工作(或使用较新模型的连续模式) 在编写代码前与评估器协商"冲刺合约" 使用全栈工具:React、FastAPI/Express、数据库、CSS 管理 git 进行迭代间的版本控制 读取评估器反馈并在下一轮迭代中采纳 模型: 默认 Sonnet;可通过 GANGENERATORMODEL=opus 提升以获得最强编码能力 3. 评估器智能体 角色: QA 工程师——测试实时运行的应用,而不仅仅是代码。 关键行为: 使用 Playwright MCP 与实时应用交互 点击功能、填写表单、测试 API 端点 根据四个标准评分(可配置): 1. 设计质量——是否感觉像一个连贯的整体? 2. 原创性——自定义决策 vs. 模板/AI 模式? 3. 工艺——排版、间距、动画、微交互? 4. 功能性——所有功能是否真正工作? 返回结构化反馈,包含分数和具体问题 设计为极度严格——从不赞美平庸的工作 模型: 默认 Sonnet;可通过 GANEVALUATORMODEL=opus 提升以获得更强的判断力 + 工具使用能力 评估标准 默认四个标准,每个评分 1-10: 评分 加权分数 = 总和(标准\分数 \ 权重) 通过阈值 = 7.0(可配置) 最大迭代次数 = 15(可配置,通常 5-15 次足够) 使用方法 通过命令行 通过 Shell 脚本 通过 Claude Code(手动) 随模型能力的演进 编排应随模型改进而简化。遵循 Anthropic 的演进路径: 阶段 1 — 较弱模型(Sonnet 级别) 需要完整的冲刺分解 冲刺间重置上下文(避免上下文焦虑) 最少 2 个智能体:初始化器 + 编码智能体 大量脚手架弥补模型限制 阶段 2 — 能力型模型(Opus 4.5 级别) 完整的 3 智能体编排:规划器 + 生成器 + 评估器 每个实现阶段前有冲刺合约 复杂应用分解为 10 个冲刺 上下文重置仍有帮助但不再关键 阶段 3 — 前沿模型(Opus 4.6 级别) 简化编排:单次规划,连续生成 评估简化为单次最终评估(模型更智能) 无需冲刺结构 自动压缩处理上下文增长 关键原则: 编排的每个组件都编码了一个关于模型无法独立完成什么的假设。当模型改进时,重新测试这些假设。剥离不再需要的部分。 配置 环境变量 变量 默认值 描述 ---------- --------- ------------- GANMAXITERATIONS 15 最大生成器-评估器循环次数 GANPASSTHRESHOLD 7.0 通过所需的加权分数(1-10) GANPLANNERMODEL sonnet 规划智能体的模型 GANGENERATORMODEL sonnet 生成器智能体的模型 GANEVALUATORMODEL sonnet 评估器智能体的模型 GANEVALCRITERIA design,originality,craft,functionality 逗号分隔的标准 GANDEVSERVERPORT 3000 实时应用的端口 GANDEVSERVERCMD npm run dev 启动开发服务器的命令 GANPROJECTDIR . …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/gan-style-harness--e76245