// 01 Ponytail 是什么
快速结论
Ponytail 是开发者 DietrichGebert 开源的 AI 编程 Agent "技能/规则包"，核心理念"最好的代码是你从没写过的代码"——让 AI 像"全场最懒的资深工程师"那样只写任务必需的最少代码（YAGNI、优先标准库与原生特性）。2026年6月走红 GitHub Trending，星标约5万(48.2k–50.7k，各源不一)，主要用 JavaScript 写成。GitHub 直连可下载、无需梯子；装进 Claude Code、Codex、Copilot CLI、Gemini/Antigravity、Cursor 等 Agent 即可用。
适合谁优先使用
- 受够 AI 过度工程的开发者：要个日期选择器却被装一堆依赖、写一堆包装组件的人。
- Claude Code / Codex / Copilot CLI 用户：想给现有 Agent 加一层"克制"约束、省 token 省成本。
- 代码审查者：用 /ponytail-review 让 AI 找出可删的冗余、过度抽象。
- 注重精简又不牺牲安全的团队：要求"少写代码但不砍校验/错误处理/安全/可访问性"。
- 嵌入式/硬件项目：实测跨9阶段重写中"从未删过任何失效保护、校验或鉴权检查"。
核心能力拆解
强制"最懒可行解"
每次响应都激活，逼 AI 先问"这任务到底需不需要存在"，优先标准库、原生平台特性、一行胜五十行。基准里日期选择器从404行降到23行、颜色选择器287→23行（改用原生 <input> 而非组件）。
三档强度
lite / full(默认) / ultra 三级，/ponytail ultra 用于"代码库得罪你本人"时；可用环境变量 PONYTAIL_DEFAULT_MODE 设默认级别，"stop ponytail"/"normal mode"恢复常态。无需任何配置文件。
安全红线不砍
规则明确"懒=高效不是马虎"：绝不削减校验、错误处理、安全、可访问性；硬件场景不按理想规格剪（留校准旋钮）。基准中它是唯一"砍掉每项指标又全程保持安全"的方案。
ponytail: 注释标记
故意简化处用 // ponytail: 注释标明"这是有意为之"及升级路径（如标注全局锁、O(n²)扫描的天花板与何时该升级），让"简单"读作意图而非无知。
广泛宿主适配
支持技能化宿主（Claude Code、Codex、OpenCode、Gemini、pi）带 /ponytail 命令；纯指令型适配器（Cursor、Windsurf、Cline、Copilot、Kiro、Antigravity）加载常驻规则集但无命令。
典型工作流
在 Claude Code 中安装使用
- git clone https://github.com/DietrichGebert/ponytail，按说明加入 Claude Code 的 skills 目录。
- 或用插件市场：/plugin marketplace add DietrichGebert/ponytail，再 /plugin install ponytail@ponytail。
- 开新会话，规则集常驻生效；需要时直接说"ponytail"或用 /ponytail 命令切档（lite/full/ultra）。
- 让 AI 写代码，它先给"懒版"并在同一回复里附最多三行"省了什么、何时该加"。
- 审查时用 /ponytail-review（Codex 里用 @ponytail-review）找冗余。
和同类工具怎么选
| 需求 | 优先考虑 | 判断标准 |
|---|---|---|
| 抑制 AI 过度工程/砍依赖 | Ponytail | 是否常被 AI 塞冗余代码和无谓抽象 |
| 让 AI 输出也变简洁（话术） | Caveman（搭配用） | Ponytail 只管"写什么代码"，不管"怎么说话" |
| 完整 Agent 框架/记忆/研究流 | 更重的 agent harness 类项目 | 要的是方法论全家桶还是一个轻规则包 |
| 国产直连编程助手 | CodeBuddy / 通义灵码 | 是否需中文生态、企业部署而非英文开源技能 |
限制与避坑
- 需技能/插件型宿主：命令功能仅在 Claude Code、Codex、OpenCode、Gemini、pi 等可用；Cursor/Copilot 等只能加载常驻规则、没有命令。
- 对某些推理模型可能反效果：会"逐级斟酌"的 terse reasoning 模型（如 GPT-5.5）反而可能更慢、token 更多，省成本不保证。
- 单轮"省80–94%代码"有水分：作者承认裸模型基线被冗长话术拉大了差距，agentic 实测数字才是修正后可信版。
- 星标数各源不一：48.2k 与 50.7k 等口径并存，仅供参考，以官方仓库实时为准。
- 本地校验依赖：基准的正确性检查会调 python3、CSV 检查需本地装 pandas，环境不全会失败。
- 英文项目无中文文档：全英文 README 与规则，国内新手有上手门槛(待核实是否有社区汉化)。
NavXD 使用建议
Ponytail 最值的场景是"你已经在用 Claude Code/Codex/Copilot 这类 Agent，却老被它过度工程化"——装上它当一层常驻约束，让 AI 默认走最小可行解、又不砍安全校验，配合 /ponytail-review 清理冗余尤其顺手。GitHub 直连免梯子、免配置文件、开源可审。但它不是万能：遇到会反复斟酌的推理模型可能不省反费，且命令功能依赖技能型宿主；若你想要中文生态或完整 Agent 框架，另选 CodeBuddy 或更重的 harness 类项目。
常见问题
用 Ponytail 会不会为了少写代码而牺牲安全或健壮性？
不会。规则把"懒=高效不是马虎"写死，明确绝不削减校验、错误处理、安全和可访问性；多次真实项目field test 中它"从未删过任何失效保护、校验或鉴权检查"。
它支持哪些 AI 编程工具？需要配置文件吗？
支持 Claude Code、Codex、OpenCode、Gemini/Antigravity、pi（带命令）以及 Cursor、Windsurf、Cline、Copilot、Kiro（仅常驻规则）。不需要配置文件，可选用 PONYTAIL_DEFAULT_MODE 环境变量或 config.json 设默认档位。
"省80%代码"是真的吗？
要分情况。单轮对话的80–94%含基线话术水分；作者修正后用真实 Agent 跑 FastAPI+React 仓库的 agentic 基准才是可信版——在有明显过度构建陷阱处削减最大，普通代码近乎零削减。
// 02 核心 功能
- 核心定位开发者 DietrichGebert 开源的 AI 编程 Agent "技能/规则包"
- 分类索引当前归档在 AI 编程、AI Agent / 智能体，方便和同频工具横向比较。
- 能力标签关联标签包括 开源、AI 编程 Agent。
- 使用入口已记录可访问入口，可通过本页主按钮跳转。
// 03 使用 场景
- 快速判断是否适合当前任务结合 AI 编程、AI Agent / 智能体 定位和 开源、AI 编程 Agent 标签，先判断它是否匹配你的工作流。
- 横向比较同类工具从相同分类和标签继续探索替代工具，减少只看单个产品带来的选择偏差。
- 沉淀工具选型资料把官网入口、平台、版本和 NavXD 标签合并成一页，适合做选型记录或团队分享。
