Ponytail 专为AI编程助手设计的技能/插件

Ponytail 部署教程。Ponytail 不是一个需要独立安装和运行的服务，而是一个专为AI编程助手设计的“技能/插件”，它通过注入一套“极简主义”规则，让AI代理在编码时遵循“最少代码”原则，从而减少代码量、降低成本并提高速度。

本教程将指导你在多种主流AI编程助手中安装和配置Ponytail。

📥 核心安装方式

Ponytail 主要通过插件市场或命令行安装，几乎所有安装命令都遵循相似的模式：

通用安装流程（以Claude Code为例）：

添加插件市场：在AI助手的会话中或通过CLI执行：
/plugin marketplace add DietrichGebert/ponytail
安装插件：接着执行：
/plugin install ponytail@ponytail
完成后，Ponytail 会在后台运行，无需额外配置。
验证安装：你可以输入 /ponytail 命令来查看当前激活的模式（lite/full/ultra/off）。

🖥️ 各平台详细安装命令

对于不同的AI编程助手，安装命令略有不同，具体如下表所示：

AI编程助手	安装命令 (CLI 或插件市场)	备注
Claude Code	`/plugin marketplace add DietrichGebert/ponytail` `/plugin install ponytail@ponytail`	需在Claude Code会话中输入两个命令。桌面应用同样适用。
Codex	`codex plugin marketplace add DietrichGebert/ponytail` `codex plugin add ponytail@ponytail`	安装后需重启Codex并信任其生命周期钩子。
GitHub Copilot CLI	`copilot plugin marketplace add DietrichGebert/ponytail` `copilot plugin install ponytail@ponytail`	在交互式会话中可用 `/plugin` 替代。
OpenCode	在 `opencode.json` 中添加： `{ "plugin": ["@dietrichgebert/ponytail"] }`	也可使用本地路径引用。
Gemini CLI / Antigravity CLI	`gemini extensions install https://github.com/DietrichGebert/ponytail` 或 `agy plugin install https://github.com/DietrichGebert/ponytail`	安装后，命令会以技能形式存在。
Devin CLI	`devin plugins install DietrichGebert/ponytail`	安装后技能以 `/ponytail:ponytail` 等形式可用。
Grok Build	`grok plugin install DietrichGebert/ponytail --trust`	安装后需在插件列表中启用。
Pi agent	`pi install git:github.com/DietrichGebert/ponytail`	—
Hermes Agent	`hermes plugins install DietrichGebert/ponytail --enable`	安装后需重启Hermes。
OpenClaw	`clawhub install ponytail`	从ClawHub安装。
Qoder	支持多种方式： 1. 自动读取 `AGENTS.md`。 2. 从插件市场安装。 3. 手动添加规则文件到 `.qoder/rules/`。	推荐使用插件方式以获得完整功能。

📁 无插件市场的IDE配置（手动规则注入）

对于 Cursor、Windsurf、Cline、Kiro 等无法安装插件的编辑器，你可以通过复制规则文件的方式启用Ponytail：

克隆Ponytail仓库（或直接下载）：

1	git clone https://github.com/DietrichGebert/ponytail.git

找到对应规则文件：在克隆的仓库中，查找特定于你IDE的规则文件：
- Cursor: .cursor/rules/ponytail.mdc
- Windsurf: .windsurf/rules/ponytail.md
- Cline: .clinerules/ponytail.md
- Kiro: .kiro/steering/ponytail.md
- 通用 (AGENTS.md): 很多IDE（如Amp, Jules）会读取根目录的 AGENTS.md 文件。
复制到项目：将找到的规则文件复制到你当前项目的对应配置目录（例如，将 .cursor/rules/ponytail.mdc 复制到你的项目根目录下的 .cursor/rules/ 文件夹中）。
完成：IDE的AI助手在读取项目配置时，会自动加载这些规则。

🛠️ 使用与配置

安装完成后，你可以通过以下方式进行交互和控制：

查看/切换模式：在聊天框中输入 /ponytail 可查看当前模式。输入 /ponytail lite、/ponytail full、/ponytail ultra 或 /ponytail off 可切换不同强度。
其他命令：
- /ponytail-review：审查当前代码变更，提出精简建议。
- /ponytail-audit：审计整个仓库的代码过度工程问题。
- /ponytail-debt：查看你推迟的“ponytail:”标记。
默认模式设置：通过环境变量 PONYTAIL_DEFAULT_MODE（值: lite/full/ultra/off）或配置文件 ~/.config/ponytail/config.json 中的 defaultMode 字段，可以设定每次新会话的默认模式（默认为 full）。

🗑️ 卸载

如果你需要卸载，可以使用对应平台命令，例如：

Claude Code: /plugin remove ponytail
Codex: codex plugin remove ponytail
Cursor等：删除你之前复制的规则文件即可。
对于额外清理，项目根目录下还提供了 node scripts/uninstall.js 脚本。

💡 关键要点

核心原则：Ponytail 遵循“7层决策阶梯”，在执行编码任务前，先思考“是否需要写代码” → “能否复用” → “标准库是否已有” → “原生平台是否支持” → “现有依赖是否可用” → “能否一行搞定” → “最后才写最少的必要代码”。它鼓励精简，但从不牺牲安全性、验证和错误处理。
效果数据：在真实代码库（FastAPI+React）的测试中，Ponytail 相比无规则状态，平均减少了 54% 的代码量，成本降低约 20%，速度提升约 27%，且保持了 100% 的安全性。
适用场景：适用于任何希望AI生成的代码更简洁、更高效、更节约成本的开发者。它并非适用于所有场景，对于代码已高度精炼或要求特定框架规范的项目，其效果可能不明显。