关于 simmer-generator
simmer-generator 是用于迭代改进文本或工作区产物的技能,按评审给出的 ASI 聚焦执行改动,并保留有效部分。它面向通过多轮评估完善产物的流程。
主要功能
- 01依据 ASI 进行定向改进
- 02支持单文件与工作区模式
- 03保留未涉及的有效内容
- 04按约束验证工作区修改
- 05输出完整产物与变更说明
适用场景
- 01依据评审方向修改单文件产物
- 02协同调整工作区中的多个文件
- 03在完整评估前执行轻量验证
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ 2389-research/ simmer --skill simmer-generator安装后在 Claude Code 中输入/simmer-generator确认已加载。
详细介绍
Simmer 生成器
生成改进后的作品。这是基于上一轮评审者 ASI 的定向改进,而非从头重写。
接收的上下文
- 当前候选:完整作品文本(单文件)或工作区路径(工作区)
- 评审标准:“更好”的定义(2–3 项标准及其描述)
- ASI:最值得优先推进的方向(来自上一轮评审)
- 迭代轮次:当前轮次
- 作品类型:单文件或工作区
- 背景(可选):约束、可用资源、领域知识
- 评审团讨论摘要(可选,启用评审团时提供):上一轮评审团的结论——应保留的有效要素、应避免的无效做法,以及本轮方向。将其作为执行参考——如果评审团说“查找表效果不错”,可据此安排修改格式。不要用它来决定“改什么”;这是 ASI 的职责。
你不会收到评分历史或之前的候选内容。这是有意为之;请依据 ASI,而非分数开展工作。相信 ASI——评审团已调查、讨论,并根据证据提出了这一方向。请高效地执行。
执行要求
无种子第 1 轮迭代
如果 ASI 写的是“第一轮迭代——生成初始候选”:
- 根据描述创建种子作品
- 仔细阅读评审标准——它们定义了优秀作品的要求
- 撰写扎实的初稿,满足所有标准
- 不必追求完美——后续迭代会继续改进
单文件模式
- **仔细阅读 ASI。**评审者指出了影响最大的一项改进。请针对这一点进行处理。
- **不要试图一次性修复所有问题。**有重点的改进能逐步累积成效。优先处理 ASI 指出的问题。如果发现其他不冲突的小改进,也可以顺手处理,但主要目标仍是 ASI。
- **保留有效之处。**不要退步于 ASI 未提及的方面。如果 ASI 指出“行动号召的门槛太高”,就不要重写开篇段落。
- **尊重作品的自然范围。**如果评审标准有要求,可以扩展内容(例如,种子中没有错误响应的 API 规范需要补充错误响应)。但对于范围严格受限的作品(推文、标语、邮件主题行),不要超出格式限制;应在约束内改进。
- **输出完整的改进后作品。**不要只给差异或说明——请提供完整文本,并将其写入编排器指定的文件路径。
工作区模式
- 仔细阅读 ASI。 在工作区模式下,ASI 描述的是战略方向,可能涉及跨多个文件的协同更改。
- 落实完整方向。 如果 ASI 要求“将推理步骤切换到更大的模型、提取步骤继续使用 mini、调整两个提示词”,就要在一次迭代中全部完成。这些是同一项调整的协同部分,而不是独立的修复。
- 利用背景信息。 背景信息会说明可用的模型、API 和基础设施限制。请在这些范围内操作。如果 ASI 提出的建议超出限制,请寻找最接近且可行的替代方案。
- 直接在工作区中进行更改。 原地编辑文件。编排器通过 git 提交跟踪状态。
- 不要进行无关更改。 ASI 确定了方向;除非 ASI 要求,否则不要顺带重构配置格式或重新整理目录结构。
- 如果拓扑或流水线更改需要,允许修改评估器脚本(例如,从单次调用切换为多次调用时,需要更新评估器调用流水线的方式)。评估器的修改应改变流水线的运行方式(拓扑、调用模式、预处理),而非结果的评分方式。如果修改改变了评分标准(使评估器变得更宽松或更严格),请明确说明,以便评审者据此判断。尽可能优先修改配置文件或提示词文件——评估器修改更难回滚。Git 跟踪会记录所有更改。
- 在提交昂贵的运行之前进行验证。 如果更改涉及基础设施(更换模型、更改拓扑、修改流水线结构),请先验证流水线仍能生成有效输出,再运行完整评估器。如果设置说明中提供了 VALIDATION_COMMAND,请运行该命令。否则,请运行最小化冒烟测试——一个测试用例、一个输入块,或评估器的快速/子集模式——以确认输出格式正确且符合 OUTPUT_CONTRACT(如有指定)。如果冒烟测试失败,请先修复问题或选择替代方案,避免浪费一次完整迭代。
工作区模式下的设置说明字段
设置说明包含以下字段时:
- OUTPUT_CONTRACT:完成更改后,请验证输出符合此契约。如果更改破坏了契约(例如,模型生成了 XML 而不是 JSON),请在评估器运行前修复或回退。
- VALIDATION_COMMAND:更改基础设施后(更换模型、调整拓扑),请运行此命令,以低成本验证流水线仍能正常工作。如果验证失败,请修复问题或尝试替代方案——不要在流水线已损坏时浪费完整评估器运行。
- SEARCH_SPACE:请勿超出这些范围。如果 ASI 建议探索搜索空间之外的方案,请在范围内寻找最接近的可行替代方案。如果你认为应扩大搜索空间,请在报告中说明。
输出
单文件模式:
- 将完整的改进版产物写入:
{OUTPUT_DIR}/iteration-[N]-candidate.md(或编排器指定的扩展名) - 用 2-3 句话说明具体改了什么以及原因。
工作区模式:
- 直接在工作区目录中进行更改
- 用 2-3 句话说明具体改了什么以及原因,并列出修改的文件。
示例报告(单文件):
Changed the call-to-action from requesting a 30-minute demo call to offering
a 2-minute video walkthrough link. This directly addresses the ASI about
reducing friction in the CTA for a cold outreach context.
示例报告(工作区):
Switched reasoning step from gpt-4o-mini to claude-sonnet in pipeline.py,
updated prompts/reasoning.md with model-specific formatting, and adjusted
config.yaml timeout to 5s for the larger model. Addresses ASI about reasoning
accuracy ceiling on the smaller model.
Files modified: pipeline.py, prompts/reasoning.md, config.yaml
常见错误
从头重写
- 问题:丢失当前候选方案中的优质内容,并引入回归问题
- 解决方法:根据 ASI 进行针对性修改,保留其他所有内容
在工作区模式下只做一处微小改动
- 问题:ASI 描述了一个协同的方向,但生成器只完成了其中一部分
- 解决方法:执行完整的方向——如果 ASI 说“更换模型 + 调整提示词 + 更新配置”,就把这三项都做完
在工作区模式下进行无关改动
- 问题:生成器“改进”了 ASI 未提及的内容,引入噪声
- 解决方法:专注于 ASI 指定的方向。不要重构、重新组织或优化与当前改动无关的内容。
忽略背景约束
- 问题:生成器提出的改动超出可用资源范围(模型不可用、超出预算)
- 解决方法:阅读背景信息,并在约束范围内操作
针对臆想的评分进行优化
- 问题:你没有评分,因此只能靠猜测
- 解决方法:依据 ASI 文本,而不是臆想的评分标准进行操作
生成差异或操作说明,而非完整产物(单文件模式)
- 问题:编排器需要完整文本才能交给评审器
- 解决方法:在单文件模式下,始终生成完整产物
评论
支持 Markdown