Ponytail 新人使用指南
他什么也不说。他写一行代码。它就能用。
一、项目介绍
1.1 这是什么?
Ponytail 是一个开源的 AI 编程 agent 技能(skill)/ 插件。它把一个"懒惰资深开发者"的思维模式注入到你的 AI agent 里。
想象你公司里那个扎马尾、戴椭圆眼镜的老工程师。他在公司待得比版本控制还久。你给他看五十行代码,他看了两眼,一言不发,换成了一行。Ponytail 就是把他放进你的 AI agent。
仓库地址:github.com/DietrichGeb…
协议:MIT | npm 包名:@dietrichgebert/ponytail| 支持 14 个 agent 平台
1.2 背景:AI agent 写代码的最大毛病
AI 编程 agent(Claude Code、Codex、Cursor 等)有一个通病:过度工程化(over-engineering)。
你跟它说"给我加个日期选择器",它:
npm install flatpickr- 写一个 wrapper 组件
- 写一份样式表
- 开始跟你讨论时区处理
- 问你台湾时区和北京时区要不要统一
这 404 行代码,需求说"选个日期就行"。浏览器 2022 年就有了 <input type="date">,一行就完事。
1.3 目标
给 AI agent 装上一个决策流程:每写一行代码前,先爬梯子。梯子从"这东西真的需要存在吗?"开始,逐级往上问——如果某一级已经有现成的解法,就不再往下走,不再写新代码。
1.4 Benchmark 数据
真实测量:用 Claude Code + Haiku 4.5 在一个真实的 FastAPI + React 开源项目上跑 12 个功能任务,同一个 agent 有 Ponytail 和没有 Ponytail 各跑 4 遍(n=4),比较 git diff 留下的改动:
| 指标 | 无 Ponytail (baseline) | 有 Ponytail | 变化 |
|---|---|---|---|
| 代码行数 | 100% | 46% | -54% |
| Token 消耗 | 100% | 78% | -22% |
| API 费用 | 100% | 80% | -20% |
| 执行时间 | 100% | 73% | -27% |
| 安全性 | 100% | 100% | 不变 |
上不封顶:日期选择器从 404 行降到 23 行(-94%),颜色选择器从 287 行降到 23 行(-92%)。本来就很精简的任务则几乎不变——Ponytail 不会把好代码变差。
二、核心思路与实现解析
2.1 核心机制:"七级梯子"
Ponytail 的核心是一组注入到 agent system prompt 中的指令。每次 agent 要写代码时,它必须先回答七个问题,在第一级能满足的地方就停下来:
第 1 级:这东西真的需要存在吗?(YAGNI)
第 2 级:这个项目里已经有现成的了吗?有就复用,不要重写。
第 3 级:标准库能做吗?用它。
第 4 级:平台原生特性覆盖了吗?<input type="date"> 就不要装 picker 库。
第 5 级:已经装了的依赖能解决吗?用它,别装新的。
第 6 级:能一行搞定吗?一行。
第 7 级:才轮到写代码 —— 写出刚好能工作的最少量。
关键约束:梯子是"看懂了问题之后"才爬的,不是代替理解问题的。先读完所有相关代码、追踪完整调用链,再去决定怎么最懒地解决。懒的是方案,不是阅读理解。
2.2 三个强度级别
| 级别 | 行为 | 适用场景 |
|---|---|---|
| lite | 正常实现,但每个实现后面附一句话 "FYI:其实 X 更简单" | 团队成员不熟项目,需要看两种方案对比 |
| full(默认) | 梯子强制执行。标准库和原生优先。最短 diff。 | 日常开发,最推荐 |
| ultra | 极端 YAGNI。先删后加。一行的方案直接怼脸上,顺带质疑需求本身。 | 老代码债清理日 |
同一个需求"加个缓存"在不同级别下的回答:
- lite: "缓存类写好了。顺便一提:
functools.lru_cache一行就能搞定,不想要自维护的缓存类的话可以换这个。" - full: "
@lru_cache(maxsize=1000)加到 fetch 函数上。跳过了自定义缓存类,等 lru_cache 真的扛不住再加。" - ultra: "不加。等 profiler 说真的需要缓存再说。需要的时候:
@lru_cache。手写的 TTL 缓存类就是一个带着命中率的 bug 农场。"
2.3 补充规则:不光是"梯子"
除了梯子,Ponytail 的指令中还编码了多条工程纪律:
Bug 修复 = 修根因,不修症状
- 一个 bug report 说的是现象。你触碰的函数,grep 所有调用方,在共享函数里一次修到位。
- 只修 ticket 提到的那条路径 → 其他调用方还坏着。一次 guard 放在共享函数里 < 每个调用方各加一个 guard。
输出格式:代码优先
- 先给代码。后面最多三行短说明:跳过了什么、什么时候补回来。
- 如果解释比代码还长,删掉解释。
**ponytail: 注释机制**
- 所有故意的简化都标
ponytail:注释,例如:# ponytail: 全局锁,等吞吐量真的成瓶颈了再改成 per-account 锁<!-- ponytail: 浏览器原生就有 --> <input type="date"> - 如果简化方案有已知天花板(O(n²) 扫描、全局锁、简单启发式),注释里写明天花板 + 升级路径。
2.4 绝对不偷懒的地方
不是所有东西都能"懒"。以下绝不省略:
- 理解问题本身:先读完、追踪完,再爬梯子。没读懂就写最短 diff 是危险的偷懒。
- 信任边界上的输入验证
- 防止数据丢失的错误处理
- 安全措施
- 可访问性基础
- 硬件校准:真实物理世界不是理想模型——时钟会漂、传感器会偏、PCA9685 会快几个百分点。物理世界的代码要留校准 knob。
- 用户明确要求保留的东西
- 非平凡的代码必须有检查:有分支/循环/解析/钱/安全路径的逻辑,留一个可运行的验证方式(一个 assert 的
demo()或一个小test_*.py,不要框架、不要 fixture)。一行代码的 trivial 逻辑不需要测试。
2.5 架构实现:源码级讲解
Ponytail 作为一个 agent 技能,核心问题只有一个:如何把规则注入到 AI agent 的每一次对话里。整个架构围绕"单源真理 + 多平台适配"展开。
2.5.1 数据流全景
┌──────────────────────────────┐
│ skills/ponytail/SKILL.md │ ← 唯一的规则源文件
│ (完整版指令,含三级描述) │
└──────────────┬───────────────┘
│
读取 & 按级别过滤
│
┌──────────────▼───────────────┐
│ hooks/ponytail-instructions.js │ ← 共享指令构建器 (CommonJS)
│ getPonytailInstructions(mode) │
│ filterSkillBodyForMode() │
└──────┬───────────┬────────────┘
│ │
┌───────────▼──┐ ┌────▼────────────────┐
│ Claude Code │ │ OpenCode │
│ SessionStart │ │ system.transform hook │
│ hook injected│ │ (ponytail.mjs) │
└──────────────┘ └───────────────────────┘
│ │
▼ ▼
Agent 的每次对话都被注入相同的 Ponytail 指令
核心设计原则:skills/ponytail/SKILL.md 是唯一的全文描述;AGENTS.md 是其精简版(给不支持 skill 的平台用)。所有平台的适配器都通过 hooks/ponytail-instructions.js 读取 SKILL.md 并 按当前激活级别过滤,确保 lite/full/ultra 不在规则文本中打架。
2.5.2 关键源文件 1:规则源 skills/ponytail/SKILL.md
这是 Ponytail 的唯一规则原文。它被放在标准的 skill 目录下,支持 OpenCode、Claude Code、Codex 等平台的 skill 加载机制。
文件结构:
- YAML frontmatter(第 1-15 行):声明 skill 名称、描述、触发词。
description字段告诉平台何时自动激活这个 skill——当用户说 "ponytail"、"lazy mode"、"YAGNI"、"simplest solution" 等关键词时。 - 正文(第 17-117 行):完整的开发纪律指令,含梯子、规则、输出格式、三级强度表、边界约束。
这个文件的巧妙之处在于它 同时是 agent 指令和人类文档——agent 读它就是行为指令,人读它就是功能说明。
2.5.3 关键源文件 2:共享指令构建器 hooks/ponytail-instructions.js
// 核心函数签名
function getPonytailInstructions(mode) {
// 1. 标准化模式名
const configuredMode = normalizePersistedMode(mode) || DEFAULT_MODE;
// 2. review 是独立模式,走单独路径
if (INDEPENDENT_MODES.has(configuredMode)) {
return 'PONYTAIL MODE ACTIVE — level: ' + configuredMode + '...';
}
// 3. 读取 SKILL.md,按 effectiveMode 过滤
try {
return 'PONYTAIL MODE ACTIVE — level: ' + effectiveMode + '\n\n' +
filterSkillBodyForMode(fs.readFileSync(SKILL_PATH, 'utf8'), effectiveMode);
} catch (e) {
// 文件读取失败 → 降级到硬编码的精简版
return getFallbackInstructions(effectiveMode);
}
}
**filterSkillBodyForMode() 的设计精髓**:
function filterSkillBodyForMode(body, mode) {
const withoutFrontmatter = String(body || '').replace(/^---[\s\S]*?---\s*/, '');
return withoutFrontmatter
.split(/\r?\n/)
.filter((line) => {
// 匹配强度表的行,如 "| **lite** | Build what's asked... |"
const tableLabel = line.match(/^\|\s*\*\*(.+?)\*\*\s*\|/);
if (tableLabel) {
const labelMode = normalizeMode(tableLabel[1].trim());
if (labelMode) return labelMode === effectiveMode;
}
// 匹配示例行,如 "- lite: Done, cache added. FYI:..."
const exampleLabel = line.match(/^-\s*([^:]+):\s*/);
if (exampleLabel) {
const labelMode = normalizeMode(exampleLabel[1].trim());
if (labelMode) return labelMode === effectiveMode;
}
return true; // 不是模式相关的行 → 保留
})
.join('\n');
}
这个函数的精妙之处:它不靠硬编码的"哪些行属于哪个模式",而是靠语法结构自动识别。模式表行(markdown 表格)和示例行(- lite: 格式)被自动按标签过滤,只有当前激活模式的行留下。普通规则行(如"不可省略:输入验证")全部保留。这意味着在 SKILL.md 中增加新模式时不需要修改任何过滤代码——语法结构就够了。
降级策略:如果 SKILL.md 文件读取失败(比如 npm 包安装路径异常),getFallbackInstructions() 提供了一份硬编码的精简版指令,保证 Ponytail 永远不会因为文件 I/O 问题而完全静默。
2.5.4 关键源文件 3:配置解析 hooks/ponytail-config.js
这个文件处理所有与"Ponytail 应该用什么模式运行"相关的逻辑。
默认模式优先级:
PONYTAIL_DEFAULT_MODE 环境变量 ← 最高优先级
↓ 未设置
~/.config/ponytail/config.json ← 配置文件
↓ 不存在或无效
"full" ← 硬编码默认值
模式标准化:两种 normalize 函数处理"模式值可能来自不同入口"的问题:
normalizeMode(mode)— 只接受运行时模式:off,lite,full,ultranormalizeConfigMode(mode)— 接受所有合法模式:运行时模式 +review(独立命令触发)normalizePersistedMode(mode)— 两者都试,兜底兼容
**isDeactivationCommand() 的设计**:
function isDeactivationCommand(text) {
const t = String(text || '').trim().toLowerCase().replace(/[.!?\s]+$/, '');
return t === 'stop ponytail' || t === 'normal mode';
}
这个函数只匹配 整个消息 恰好是 "stop ponytail" 或 "normal mode" 的情况。为什么是整条消息匹配,而不是包含匹配?因为如果用户说 "add a normal mode toggle",不应该触发关闭!这是对真实使用场景的防御性设计。
2.5.5 OpenCode 插件适配器 .opencode/plugins/ponytail.mjs
这是 Ponytail 在 OpenCode 环境中的适配桥接层。完整代码只有 100 行,它做了三件事:
1. 注册 slash 命令(config 钩子):
config: async (config) => {
const commandDir = path.join(__dirname, '..', 'command');
for (const file of fs.readdirSync(commandDir).filter((f) => f.endsWith('.md'))) {
const name = path.basename(file, '.md');
const parsed = parseCommandFile(path.join(commandDir, file));
if (parsed) config.command[name] = parsed; // 注册 /ponytail, /ponytail-review 等
}
// 同时把 skills/ 目录注册为 skill 搜索路径
config.skills.paths.push(ponytailSkillsDir);
}
动态扫描 .opencode/command/ 目录下的所有 .md 文件,解析其 YAML frontmatter + 正文,注册为可用命令。新增命令只需加一个 .md 文件——零代码修改。
2. 每次对话注入规则(experimental.chat.system.transform 钩子):
'experimental.chat.system.transform': async (_input, output) => {
const mode = readMode();
if (mode === 'off') return;
output.system.push(getPonytailInstructions(mode));
}
这是整个 Ponytail 在 OpenCode 中生效的关键:每次 agent 收到用户消息、准备回复之前,这个钩子把当前模式的完整指令 append 到 system prompt 里。如果 mode === 'off',则什么都不追加——Ponytail 完全静默。
3. 持久化模式切换(command.execute.before 钩子):
'command.execute.before': async (input) => {
if (!input || input.command !== 'ponytail') return;
const mode = normalizePersistedMode((input.arguments || '').trim()) || getDefaultMode();
writeMode(mode);
}
当用户输入 /ponytail ultra 时,新级别写入文件系统。下一次对话时 system.transform 读取这个文件,注入的就是 ultra 级别的指令。模式从下一次对话开始生效(不是当前对话),这是一个刻意简化——如果需要同一条消息内切换,需要同步存储而非文件。
状态存储位置:模式标记写在 ~/.config/opencode/.ponytail-active,由 fs 读写实现跨会话持久化。
2.5.6 跨平台适配层总览
Ponytail 支持 14 个 agent 平台,所有平台共用一个核心原则:适配器要薄。
| 平台 | 适配方式 | 适配代码量 |
|---|---|---|
| Claude Code | SessionStart hook (hooks/ponytail-activate.js) + UserPromptSubmit hook (hooks/ponytail-mode-tracker.js) + SubagentStart hook (hooks/ponytail-subagent.js) | 3 个 hook 文件 |
| Codex | 复用 Claude/Codex 的 hooks.json 和共享 JS | 0 额外代码 |
| OpenCode | ES module plugin (ponytail.mjs, 100 行) | 100 行 |
| pi | pi-extension 注册 + 复用共享 instruction builder | <50 行 |
| Gemini / Antigravity | extension.json 指向 AGENTS.md + skills/ | 1 个 JSON 文件 |
| Cursor / Windsurf / Cline / Copilot / Kiro | 复制对应的规则文件(.cursor/rules/, .windsurf/rules/ 等)到项目中 | 0 代码,纯文件复制 |
| 其他 (CodeWhale, Swival, OpenClaw, Zed) | 读 AGENTS.md 或安装 skill | 0 代码 |
适配器从不重复实现规则文本。所有平台的"指令构建"都通过 hooks/ponytail-instructions.js 完成,保证修改一处(SKILL.md)所有平台同步生效。
2.5.7 子 agent 传播机制
一个容易被忽略但至关重要的设计点:子 agent 也需要 Ponytail。
在 Claude Code 中,当你用 task() 生成子 agent 时,SessionStart 的上下文不会传播给它们。没有 hooks/ponytail-subagent.js,每个子 agent 都是 Ponytail 无感知的,写出来的代码又回到无节制的过工程状态。
// hooks/ponytail-subagent.js —— 完整逻辑
const context = getPonytailInstructions(mode);
// 通过 SubagentStart hook 注入 → 每个子 agent 也有 Ponytail 纪律
这个 22 行的文件解决了 issue #252,确保不管你的任务被拆成多少个并行子 agent,每个都遵守同一套"懒人纪律"。
三、安装方式
3.1 前提条件
Claude Code 和 Codex 的插件依赖两个 Node.js 生命周期 hook,所以需要 **node 在 PATH 上**(Nix/nvm 用户注意:需要在非交互 shell 的 PATH 上)。如果没有 node,skill 功能仍然可用,只是 always-on 激活不会每轮都触发。
3.2 Claude Code(推荐)
在 Claude Code 对话中依次发送这两条命令(必须分开发):
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail
桌面版没有 /plugin 命令,从 UI 安装:Customize → personal plugins 旁边的 + → Create plugin and add marketplace → Add from repository → 输入 repo URL。
3.3 OpenCode
在项目根目录的 opencode.json 中添加:
{
"plugin": ["@dietrichgebert/ponytail"]
}
或者从本地 checkout 运行:
{
"plugin": ["./.opencode/plugins/ponytail.mjs"]
}
OpenCode 会自动加载本项目的 AGENTS.md,所以即使不装 plugin,Ponytail 的规则也已经生效了。Plugin 额外提供了 /ponytail lite|full|ultra|off 的级别切换能力。
3.4 其他平台速查
| 平台 | 安装命令 |
|---|---|
| Codex | codex plugin marketplace add DietrichGebert/ponytail → 在 /plugins 中安装 |
| GitHub Copilot CLI | copilot plugin marketplace add DietrichGebert/ponytail → copilot plugin install ponytail@ponytail |
| Gemini CLI | gemini extensions install https://github.com/DietrichGebert/ponytail |
| Cursor / Windsurf / Cline | 复制对应规则文件到项目目录(.cursor/rules/, .windsurf/rules/, .clinerules/) |
| 纯 AGENTS.md | 把项目仓库的 AGENTS.md 复制到你的项目根目录,零配置 |
3.5 设置默认级别
# 方式 1:环境变量
export PONYTAIL_DEFAULT_MODE=full
# 方式 2:配置文件 ~/.config/ponytail/config.json
{"defaultMode": "full"}
3.6 卸载
| 平台 | 命令 |
|---|---|
| Claude Code | /plugin remove ponytail |
| Codex | codex plugin remove ponytail |
| Cursor / Windsurf / Cline | 删除复制的规则文件 |
卸载插件后可能残留少量状态文件(模式标记、config.json、statusLine 配置),运行 node scripts/uninstall.js 清理。
四、使用前后对比 Case
以下案例全部来自 Ponytail 的 benchmark 实际运行输出,同一模型(Claude Haiku 4.5)、同一任务,左边无 Ponytail,右边有 Ponytail。
Case 1:Email 验证函数(Python)
任务:写一个 Python 函数校验 email 地址。
无 Ponytail(75 行):手写正则 + 高级版的长度检查/点号检查 + 推荐第三方库 email-validator + 对比表格 → 75 行。
有 Ponytail(3 行):
import re
def is_valid_email(email: str) -> bool:
return bool(re.match(r'^[^@]+@[^@]+\.[^@]+$', email))
为什么这是对的:这个三行版本能拦住 99% 的"我手滑打错了"场景——没有 @、@后面没域名、域名没点号。RFC 5322 的完整解析器?99.9% 的项目不需要。等真有人用 user+tag@sub.domain.co.uk 这个 edge case 报 bug 了再优化。
Case 2:防抖搜索(JavaScript)
任务:给搜索框加防抖,避免每次按键都发 API 请求。
无 Ponytail(116 行):手写 debounce 工具函数 + 带 loading 状态的高级版 + 带 cancel/immediate 选项的企业版 + CSS 样式表 + 特性对比表格 → 116 行。
有 Ponytail(10 行):
const searchInput = document.querySelector('input[type="search"]');
let debounceTimer;
searchInput.addEventListener('input', (e) => {
clearTimeout(debounceTimer);
debounceTimer = setTimeout(() => {
fetch(`/api/search?q=${encodeURIComponent(e.target.value)}`)
.then(r => r.json())
.then(data => console.log(data)); // 替换成你的渲染逻辑
}, 300);
});
为什么这是对的:setTimeout + clearTimeout 本身就是 debounce。不需要一个带 cancel/immediate/config 的通用防抖类,一个搜索框用不上。等你有 3 个以上输入框需要防抖的时候再抽工具函数。
Case 3:深拷贝对象(JavaScript)
任务:深拷贝一个对象。
无 Ponytail:npm install lodash → import { cloneDeep } from "lodash" → 一个依赖。或者 JSON.parse(JSON.stringify(obj)),这个方案静默丢失 Date、Map、Set、undefined、循环引用。
有 Ponytail(1 行):
// ponytail: structuredClone 原生就做这个
const copy = structuredClone(original);
为什么这是对的:structuredClone 是 2022 年起所有浏览器和 Node.js v17+ 的原生 API,正确处理了 Date、Map、Set、ArrayBuffer、RegExp、循环引用。JSON.parse/stringify 做不到的那些它都能做到。lodash 等真正需要它的其他函数时再装。
Case 4:CSV 金额汇总(Python)
任务:读 sales.csv,把 amount 列加起来。
无 Ponytail(20 行):import pandas as pd → pd.read_csv() → .sum() → 还附带了备选方案的 csv 模块版。
有 Ponytail(3 行):
import csv
with open('sales.csv') as f:
print(sum(float(row['amount']) for row in csv.DictReader(f)))
为什么这是对的:csv 是标准库。pandas 对这个任务而言就是"用坦克碾蚂蚁"。三行标准库搞定的事,不需要装一个 30MB 的依赖。
Case 5:日期选择器(HTML)
任务:给表单加个日期选择组件。
无 Ponytail:npm install flatpickr → wrapper 组件 → 样式表 → 404 行。
有 Ponytail(1 行):
<!-- ponytail: 浏览器原生就有 -->
<input type="date">
为什么这是对的:2022 年起,主流浏览器全部原生支持 <input type="date">。一个日期选择器不应引入一个 npm 依赖和 400 行代码。
五、讲述优化建议
在理解了 Ponytail 的设计思想之后,以下是几个补充点,能帮助新人更好地理解和应用它:
5.1 "梯子不是逃避理解的借口"
新人最容易犯的错:看到"最短 diff 赢",就在没读懂代码的情况下强行写一个最小的改动。这是危险的——最小的改动放在错误的位置,等于第二个 bug。懒的是解决方案,不是阅读理解。 每一步改动前都要追踪完整的调用链,grep 所有调用方。
5.2 "懒 ≠ 没责任心"
Ponytail 的"懒"是一个精确的工程判断,不是偷工减料:
- 信任边界上的输入验证 → 永远不省
- 数据安全的错误处理 → 永远不省
- 用户无障碍 → 永远不省
- 但一个"helper wrapper class that wraps another wrapper" → 必须删
5.3 ponytail: 注释是你的工程笔记
每当你做了一次故意的简化(比如用全局锁代替 per-account 锁),留下 ponytail: 注释。它告诉未来的你(和同事):"我知道这里可以更好,我选择这样是因为当前不需要更好的。天花板是 X,升级路径是 Y。"
这个习惯让简化从"看起来像代码质量差"变成"有记录的工程决策"。
5.4 日常命令速查
| 命令 | 作用 |
|---|---|
/ponytail lite | 我写正常的,但每个方案后面提醒你还有更简单的 |
/ponytail full | 默认。梯子全开。最短方案。 |
/ponytail ultra | 今天和这个代码库有仇。先删再写,一行怼脸。 |
/ponytail off | 暂时关闭(stop ponytail 也可以) |
/ponytail-review | 审查当前 diff 里有没有过度工程化的东西,给删除清单 |
/ponytail-audit | 扫一遍整个仓库的过工程代码,产出删除优先级列表 |
/ponytail-debt | 把所有 ponytail: 注释汇总成一份债务台账 |
/ponytail-gain | 显示 benchmark 的量化收益看板 |
/ponytail-help | 以上命令的快速参考 |
5.5 什么时候不该用 Ponytail
- 你在写基础设施代码(如认证框架、数据库迁移)——这些需要的不是最短路径,而是最正确的路径。
- 你在做原型验证——可以关掉 Ponytail 让它敞开了写,验证完再用
/ponytail-review清理。 - 你在写需要完整但不需要复杂的代码——这时 Ponytail 正是最佳拍档。
六、与 OpenCode 及 Superpowers 的协同
6.1 Ponytail + OpenCode
Ponytail 和 OpenCode 的集成是原生的。当前运行环境就是一个活例子——你可以看到 Ponytail 的 AGENTS.md 指令已经加载在 OpenCode 的 system prompt 中。
如何确认 Ponytail 在生效:如果你的 OpenCode 回复开头或 system prompt 中出现 PONYTAIL MODE ACTIVE — level: full,说明 Ponytail 已激活。装 plugin 后可以用 /ponytail 查当前级别。
没有 plugin 也能用:OpenCode 自动加载项目根目录的 AGENTS.md,Ponytail 仓库本身就带了这个文件。把 Ponytail 的 AGENTS.md 放到你的项目根目录,OpenCode 开箱即用。
6.2 Ponytail + Superpowers 工作流
Superpowers 是 OpenCode 的一套软件开发流程方法论:brainstorming(头脑风暴)→ writing-plans(写计划)→ executing-plans(执行计划)→ verification(验证)。Ponytail 和 Superpowers 完全不冲突,是互补的:
| Superpowers 管什么 | Ponytail 管什么 |
|---|---|
| 需求分析(这个功能到底要做成什么样) | 代码实现(具体怎么写,用几行) |
| 技术方案选型(用 A 架构还是 B 架构) | 实现最小化(能不能用标准库代替新依赖) |
| 任务拆分与排期(先做哪个后做哪个) | 输出格式(代码优先,解释最多三行) |
| 验证是否按设计完成 | 验证是否过度工程化 |
两者叠加的典型工作流:
**superpowers-brainstorming**:跟用户讨论需求,产出设计方案**superpowers-writing-plans**:把设计拆成可执行的实施计划**superpowers-executing-plans**:执行计划,此时 Ponytail 全程生效——每写一行代码都爬梯子**superpowers-verification-before-completion**:验证功能符合设计 → 完成后可以再跑一次/ponytail-review清理任何过度工程化的实现
一句话总结:Superpowers 让你的开发流程不掉链子,Ponytail 让你的代码不臃肿。两者一起用,从"想清楚要做什么"到"用最少代码做出来"全链路覆盖。
6.3 注意:Ponytail 管实现,不管对话风格
Ponytail 的文档里有一句关键边界声明:
Ponytail governs what you build, not how you talk.
它改变的是 agent 怎么写代码,不改 agent 怎么说话。如果你还想改变 agent 的对话风格(比如让它回复更简洁),那是另一个工具 Caveman 的领域。两者可以叠加使用——Caveman 管嘴巴、Ponytail 管键盘。
附录:项目速览
| 项目 | 信息 |
|---|---|
| 仓库 | github.com/DietrichGeb… |
| npm | @dietrichgebert/ponytail |
| 版本 | 4.8.3 |
| 协议 | MIT |
| 支持平台 | Claude Code, Codex, OpenCode, Gemini CLI, Cursor, Windsurf, Cline, GitHub Copilot, pi, Kiro, CodeWhale, Swival, OpenClaw, Zed, Aider |
| 核心技能 | ponytail、ponytail-review、ponytail-audit、ponytail-debt、ponytail-gain、ponytail-help |
| Benchmark | 真实 Claude Code 会话,12 个功能任务,Haiku 4.5,n=4。代码 -54%,费用 -20%,时间 -27%,安全不变。 |