Ponytail 新手教程
它不帮你写代码,它拦住你写代码。给 AI 编程助手装上一位「最懒的资深工程师」:动手前先爬七级梯子,第一级能站住,就不往下走。
-54%
平均代码量(12 个真实任务)
100%
安全护栏保留率
7
梯子横档
20
支持宿主
6
配套技能
? 这是什么
Ponytail 是一个给 AI 编程助手用的行为规则包。它不是代码生成器,也不是脚手架。它往助手的上下文里塞进一个人物设定:公司里那个扎马尾、戴椭圆眼镜、工龄比版本控制系统还长的资深工程师。你给他看五十行,他不说话,看完换成一行。
他的信条只有一句:最好的代码是你从来没写过的代码。所以动手前他会先爬一架七级梯子,停在第一个站得住的横档上——先问这个需求要不要存在,再问仓库里是不是已经有了,然后是标准库、平台原生能力、已装依赖、能不能一行,实在都不行才写最小可用代码。
一句话记住它的定位:它管「写多少」,不管「怎么说话」。想让助手同时少啰嗦,得另配一个 terseness 类技能(官方点名
caveman)——两者不重叠。? 它不做什么
新手最容易误会的一点:把「懒」读成「敷衍」。恰恰相反——Ponytail 的作者专门写了一张「永不削减」清单,而且用一轮对抗性测试证明自己没掉护栏。先看清边界,后面所有章节都好理解。
| 你可能以为 | 实际上 |
|---|---|
| 会砍掉输入校验来换短代码 | 信任边界的输入校验、防数据丢失的错误处理、安全、可访问性永不削减。实测 20 次安全任务里 ponytail 保留 100% 护栏,而裸「写一行」提示词掉到 95%。 |
| 是个代码生成器或模板库 | 它一行代码都不产出。它是注入给助手的规则文本,改的是助手的决策顺序。 |
| 装上就会自动重构整个仓库 | 默认只影响之后的对话行为。要审已有代码得显式跑 /ponytail-review(当前 diff)或 /ponytail-audit(整个仓库),而这两个命令在 Cursor 里不可用(原因见第 6 章)。 |
| 必然省 token、省钱 | 官方自己写明了:在遵守梯子的模型上省钱省时是副产品;碰上爱在思考里反复权衡横档的推理模型(他们点名 GPT-5.5)反而可能更贵。 |
| 代替你理解问题 | 「懒」只缩短方案,绝不缩短阅读。梯子严格跑在理解问题之后,第 1 章会重点讲这条。 |
? 三个数字,先建立预期
网上流传的「少写 80%~94% 代码」是旧版单次生成的数字,作者自己撤回了——因为那个基线模型会先啰嗦一大段再给代码,差距有一部分是「对话基线」的水分(详见第 8 章)。现在站得住的说法是这三个:
有水分可挤的任务
日期选择器从 404 行降到 23 行(-94%),颜色选择器从 287 行降到 23 行。省下来的全是「手搓组件」换成浏览器原生 <input>。
本来就没水分的任务
后端 CRUD 端点、命令面板这类本来就紧凑的代码,各对照组结果几乎一样(搜索接口 44 / 44 / 44 / 43)。它不会为了好看硬造节省。
所以正确预期是:该省的地方省得惊人,不该省的地方一行不省,而且不拿安全换行数。
? 建议学习路径
1 搞懂「懒」的定义→
2 看七级梯子→
3 选一个宿主装上→
4 在 Cursor 里验证→
5 调强度、看实测
? 你要准备什么
- 一个 AI 编程宿主:Cursor、Claude Code、Codex、Copilot CLI、Gemini CLI……共 20 个,任选一个
- node 在 PATH 上——只有走 hooks / 插件的宿主才需要。而且必须是宿主看得见的那个 PATH(Nix / nvm 用户注意:非交互 shell 的 PATH 也要有)。没有它技能照样能用,只是「自动激活」会安静地失效,不会每次提示都报错
- Git(走 Cursor 路线需要先 clone 仓库)
- 不需要 API Key,不需要配置文件,不需要登录
仓库里确实有一个
ponytail-mcp/ 目录,但 README 里所有宿主的安装都没走 MCP(Grok 适配时明确移除了 MCP 接线,理由是 hooks + skills 已经覆盖了常驻注入的需求)。新手不用管它。? 三条集成路线速览
20 个宿主看着吓人,其实只有三档,先认清自己在哪一档,后面的安装命令就不需要背。
| 档次 | 典型宿主 | 你能得到什么 | 在哪一章 |
|---|---|---|---|
| 插件档 | Claude Code、Codex、Copilot CLI、pi、Devin、OpenClaw、Grok | 常驻注入 + /ponytail 全套 6 个命令 + 生命周期 hooks | 第 3 章 |
| hooks 档 | Cursor、Qoder、OpenCode、Gemini CLI、Hermes、Swival | 常驻注入 + 强度切换;命令数量视宿主而定 | 第 4、5 章 |
| 规则档 | Windsurf、Cline、Copilot Chat 扩展、Aider、Kiro、Zed、Junie、Amp、Jules | 只有常驻规则文本,没有强度切换、没有命令 | 第 3 章 |
Cursor 是「hooks 档」里做得最深的一个,而且和第 3 章里讲的规则档有一条容易踩的冲突规则,所以单独占两章(第 4、5 章)。