Ponytail 新手教程

Ponytail 新手教程

它不帮你写代码,它拦住你写代码。给 AI 编程助手装上一位「最懒的资深工程师」:动手前先爬七级梯子,第一级能站住,就不往下走。

MIT 许可 v4.10.0 支持 20 个 AI 宿主 原生 Cursor hooks GitHub 仓库
-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 调强度、看实测
理解理念 懒 = 少写,不是少做 装上 20 个宿主任选 Cursor 集成 hooks 或规则文件 调强度 lite/full/ultra Cursor 用户可以直接从第 4 章开始 理解理念 懒 = 少写,不是少做 装上 20 个宿主任选 Cursor 集成 hooks 或规则文件 调强度 lite/full/ultra Cursor 用户可直接从第 4 章开始

? 你要准备什么

  • 一个 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 章)。