Agent skill · software engineering · affaan-m

gan-style-harness

受GAN启发的生成器-评估器代理框架,用于自主构建高质量应用。基于Anthropic 2026年3月的框架设计论文。

Why this skill is useful

Adds a comprehensive multi-agent framework with executable scripts for project management and quality evaluation that aren't available in public documentation.

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--190f29

View the source on GitHub

Browse the @skills marketplace