// 为任意 coding agent 编写高质量任务目标的指南。当用户提到「设定目标」「goal」「任务目标」「持久目标」「完成标准」、或需要为复杂多轮任务（性能优化、调试、迁移、研究复现等）定义可验证的完成条件和约束时触发。
| name | better-goal |
| description | 为任意 coding agent 编写高质量任务目标的指南。当用户提到「设定目标」「goal」「任务目标」「持久目标」「完成标准」、或需要为复杂多轮任务（性能优化、调试、迁移、研究复现等）定义可验证的完成条件和约束时触发。 |
| version | 1.1.0 |
| source | https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex |
| metadata | {"hermes":{"tags":["goal","prompt-engineering","agent","中文"],"related_skills":["writing-plans","code-review"]}} |
一个好的任务目标是可验证的完成合约，而非更大的 prompt。它让 agent 在多轮探索中持续朝着既定结果工作，并在证据达标时停止。
| 一次性任务 | 持久目标 | |
|---|---|---|
| 模式 | 请求 → 工作 → 结果 → 等待 | 工作 → 检查 → 继续或完成 |
| 适用 | 单次明确任务 | 路径不确定的多轮探索任务 |
| 完成 | 任务执行完毕 | 证据验证目标达成 |
应该用： 性能优化、flaky test 排查、依赖迁移、需要复现的 bug 调查、多步重构、基准驱动调优、需要产出最终产物的研究任务。
不要用： 单行修改、简短解释、代码审查、一次性问答。标语式目标（"让代码更好"、"重构一下"）也不适合。
适用条件：持久目标 + 可验证的完成线 + 需多轮探索的路径。
/goal <期望最终状态> verified by <具体证据> while preserving <约束条件>。
Use <允许的工具或边界>。
Between iterations，<如何选择下一步>。
If blocked or no valid paths remain，<报告内容和解锁条件>。
弱：/goal Improve performance
强：/goal Reduce p95 checkout latency below 120 ms, verified by the checkout benchmark, while keeping the correctness suite green. Use only the checkout service, benchmark fixtures, and related tests. Between iterations, record what changed, what the benchmark showed, and the next best experiment to try. If the benchmark cannot run or no valid paths remain, stop with the attempted paths, the evidence gathered, the blocker, and the next input needed.
关键差异：强目标命名了结果（<120ms）、验证方式（checkout benchmark）、约束（correctness suite green）。即使延迟从 180ms 降到 135ms，目标仍未完成；延迟达标但测试失败，目标也未完成；基准无法运行，必须报告阻塞而非宣告成功。
弱：/goal Reproduce Buehler et al., "Deep Hedging"
强：/goal Produce the strongest evidence-backed reproduction of Buehler et al., "Deep Hedging," using the available paper materials and local resources. Attempt every headline result, verify the outputs, and end with a report that separates reproduced mechanics, approximate trained results, blocked exact replay, and remaining uncertainty.
关键差异：强目标定义了证据标准（confirmed / approximate / blocked / uncertain 四层分级），防止"看似可行"的产物变成过度宣称的结论。
如果不确定如何写，先描述任务，让 agent 生成草案：
Help me turn this into a task goal: I want to keep working on this flaky
checkout test until we either fix it with evidence or can clearly explain
what is blocking progress.
然后审查草案，收紧成功条件、验证面、约束和阻塞终止条件，再开始执行。
生图 / 生成图片 / 画图 — 用 OpenAI gpt-image-2 生成图像。支持文生图、参考图生图 (img2img)、蒙版修补 (inpainting)。当用户要求用 GPT 画图、OpenAI 生图、gpt-image-2、文+图生图、参考图片生成、img2img、inpainting 时必加载此技能。Auth 自动继承 OPENAI_API_KEY / Codex OAuth (Pi/Codex) / .env / config.yaml。
Remove AI writing patterns from English prose. Covers blog posts, technical docs, social copy, release notes, scientific writing. Trigger: deslop, de-AI, make it sound human, remove AI patterns, fix slop, polish, rewrite, sound natural
去除中文写作中的 AI 腔调，让文本像人写的而非模型生成的。覆盖博客、技术文档、推文、发行说明、科学论文等场景。触发词：去 AI 味、改写、润色、审稿、翻译腔重、像人写的、自然一点。英文去 AI 味见 deslop-en
Use when reviewing code changes, PRs, diffs, or commits. 触发：审查、review、CR、看看这段代码、检查这个 PR、审一下。
Control herdr from inside it. Manage workspaces and tabs, split panes, run commands, read output, and wait for state changes — all via CLI commands that talk to the running herdr instance over a local unix socket. Use when running inside herdr (HERDR_ENV=1).
Jupyter Notebook 创建与格式转换技能。当用户提到以下任何请求时必须使用：新建/创建 notebook、Jupyter notebook、.ipynb、jupytext、py:percent、# %% cell 格式、notebook 版本控制、paired notebook、notebook 转 Python、Python 转 notebook、用纯文本写 notebook。即使用户只说「新建一个 notebook」也应触发此技能——先询问用户选用 .py percent format 还是传统 .ipynb，再按选定格式生成。不用于调试已有 notebook 或写普通 Python 脚本。