Ponytail：用五级阶梯把 AI 代理的过度设计按回去

它治的是代理的“多写病”

Ponytail 解决的是一个具体到令人头疼的问题：编码代理拿到需求后，倾向于建抽象、装依赖、写包装层。你让它做个日期选择器，它给你装 flatpickr，再包一层组件，加一个样式表，然后开始讨论时区。Ponytail 的做法是把一条规则塞进代理的上下文：浏览器里已经有 `<input type="date">`，你要做的只是这一行。它服务的对象很明确，就是每天让 Claude Code 或 Codex 改真实代码库的工程师，而不是那些只想看代理写玩具脚本的人。项目自称 YAGNI 审查指令，意思是它不教代理怎么写代码，教它怎么不写。

五级阶梯，从“别写”到“最少可运行”

机制本身简单得不像一个工具。代理在动手前必须先停在一级阶梯上，从“这东西需要存在吗”开始，逐级往下：代码库里已有就复用，标准库能做就用标准库，原生平台特性优先，已装依赖次之，一行能搞定就写一行，最后才轮到“写个能跑的最小实现”。关键约束是这阶梯在代理理解问题之后才运行，不是替代理解。它必须先读改动涉及的代码，追踪真实数据流，再选阶梯。文档用一句话概括：对解决方案懒惰，对阅读从不懒惰。这意味着 Ponytail 不是一套提示词模板，而是一套行为约束，它把“先看懂再决定写不写”变成了强制流程。

基准数字：54% 是怎么来的，以及它不吹什么

项目方给了一个可复现的测量方法：用无头 Claude Code 会话去改一个真实的 FastAPI 加 React 仓库，拿 git diff 当评分对象。12 个功能任务，同一代理分别带和不带技能跑，每任务 4 次，模型是 Haiku 4.5。结果是对比无技能基线，代码行数少 54%，令牌少 22%，成本低 20%，时间省 27%，安全项 100% 保留。对照实验里，一个只写简短提示的控制组只减了 20% 代码，而裸的“YAGNI 加一行代码”提示虽然减了 33% 代码，但安全项掉到了 95%。Ponytail 是唯一一个所有指标都变好且安全项没缩水的方案。项目方自己也承认早期 80% 到 94% 的单次生成数字是对话基线的假象，因为裸模型会在回答里灌水和列选项。这个修正值得肯定，它没有把最好看的数字留在最上面。

安装是两条命令，但有两个坑

Claude Code 的装法分两步，先 `/plugin marketplace add DietrichGebert/ponytail`，再 `/plugin install ponytail@ponytail`，文档特意提醒这两条要分开发送。Codex 用等价的命令行，装完还得手动打开 `/hooks` 审查并信任两个生命周期钩子，然后开新线程才生效。Copilot CLI 和 OpenCode 也有对应路径。真正的坑在环境：两个钩子是 Node.js 写的，所以 node 必须在非交互式 shell 的 PATH 里，Nix 和 nvm 用户尤其容易中招。如果 node 不在，技能本身还能用，只是常驻激活会静默失效，不会报错。这意味着你可能装了等于没装，而且毫无察觉。OpenCode 用户还有个选项是直接从仓库 checkout 跑，复用 hooks 和 skills 目录，这比走 npm 包装更透明。

它明确不做的三件事

文档把边界画得很清楚。第一，规则从来不是“越少令牌越好”，而是只写任务需要的，并且永远不砍校验、错误处理、安全和可访问性。代码小是因为必要，不是因为被压缩。第二，它不保证推理模型省钱，文档直说在 GPT-5.5 上，一个喜欢花思考令牌权衡阶梯的模型会走向反面，更慢更贵。第三，它不是万能的，对已经极简的代码，削减量趋近于零。这三条边界让 Ponytail 看起来像个诚实的工具，它知道自己只是行为约束，不是性能外挂。

和裸提示词的区别：安全项是硬约束

拿“YAGNI 加一行代码”这种裸提示做对照，结果很有意思：裸提示减了 33% 代码，比 Ponytail 的 54% 少，但这不是主要差距。主要差距在安全项，裸提示掉到了 95%，Ponytail 保持 100%。这意味着裸提示在追求简洁时会把某些校验或错误处理一起删掉，而 Ponytail 的阶梯把安全类检查放在不可协商的位置。另一个对照是 caveman，一个只追求简短措辞的控制组，它只减了 20% 代码，成本和时间反而微涨。这说明单纯把提示写短没用，必须有结构化的决策顺序。Ponytail 的价值不在措辞，在它把“什么不能砍”写成了硬规则。

维护成本和许可证

项目用 MIT 许可证，没有附加条款，这对想改规则集的公司是友好的。维护成本主要看两处：一是它依赖代理平台的插件机制，Claude Code、Codex、Copilot CLI 的插件 API 都在变，每次平台更新都可能要跟进；二是它的常驻激活靠生命周期钩子，任何 shell 环境变动都可能让激活静默失效。仓库本身更新频繁，v4.9.0 的发布说明写着“53 commits of doing less”，版本号跳到 4.x 说明规则集已经迭代过很多轮。如果你要长期依赖它，得接受它是个活项目，不是一次装完就完事的静态配置。

编辑结论

Ponytail 适合那些已经受够了代理自作主张引入组件库、包装类和时区讨论的团队，尤其是用 Claude Code 或 Codex 做日常小功能迭代的人。不适合的场景是：你的任务本身就需要跨模块重构，或者你的代理模型在思考令牌上特别吝啬，因为文档明确说 GPT-5.5 上它会因为花更多时间权衡阶梯而变慢变贵。安装前先验证两件事：一是 node 必须在非交互式 shell 的 PATH 上，否则常驻激活会静默失效；二是 Codex 用户必须手动审查并信任那两个生命周期钩子，跳过这一步等于没装。最后，别把 54% 当成承诺，那是 12 个任务在 Haiku 4.5 上的均值，你的代码库如果已经接近极简，收益会趋近于零。

官方来源

1. Official documentation
2. Official README
3. Project repository
4. Release notes