项目介绍
Ponytail 把一套“懒惰但不草率”的资深开发者决策阶梯放进编码 Agent：先判断需求是否真的存在，再查找代码库已有实现，随后依次考虑标准库、平台原生功能和已安装依赖，最后才写最小可工作的代码。仓库同时提供 Codex、Claude Code、OpenCode、Gemini CLI 等宿主适配器，以及审查、全库审计、技术债整理、基准查看和帮助等 6 个 Skill。它明确要求先理解真实调用链，并保留安全、数据保护、错误处理、校验和可访问性。
核心功能
最小正确实现阶梯
要求 Agent 在理解问题和真实调用链后，从“不做”、复用、标准库、原生能力和现有依赖中选择第一个足够方案，避免为未来假设创建抽象。
多强度模式
lite 只提示更简方案，full 默认执行完整阶梯，ultra 更严格挑战非必要需求，off 可关闭规则；默认值还可通过环境变量或本地配置设置。
审查与审计 Skills
ponytail-review 面向当前 diff，ponytail-audit 面向整个仓库；另有 debt、gain、help 等 Skill 处理延后项、基准展示和命令说明。
跨宿主适配
仓库为支持插件的宿主复用 skills 与 hooks，为只支持项目指令的宿主提供 AGENTS.md 或对应规则文件。
安装与使用
在 Codex 中先添加 Ponytail 官方 GitHub 仓库作为插件市场，再安装 ponytail@ponytail；随后审查并信任两个本地生命周期 hook，重启桌面端或新建 CLI 会话后，用 Ponytail 命令验证模式和审查功能。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我安装 Ponytail。GitHub 项目地址：https://github.com/DietrichGebert/ponytail。先阅读 README 的 Codex 安装段、.codex-plugin/plugin.json 和 hooks/claude-codex-hooks.json，确认本机 Codex 支持插件命令且 Node.js 位于非交互 shell 的 PATH。按仓库原文依次执行 codex plugin marketplace add DietrichGebert/ponytail 和 codex plugin add ponytail@ponytail。安装后打开 /hooks，逐项向我说明本地脚本、读写位置和影响，得到我确认后再信任 hooks；然后重启 Codex 桌面端或新建 CLI 会话，用 @ponytail-help 和一个只读的 @ponytail-review 做最小验证并报告结果。遇到凭据请求、额外权限、覆盖已有配置、修改 settings.json 或其他风险操作时，必须先询问我。- 已安装可使用插件命令的 Codex CLI 或 Codex 桌面端
- Node.js 已加入非交互 shell 的 PATH；否则 Skill 可用，但自动激活 hook 会保持静默
- 准备一个可检查的代码仓库和小型 diff，用于最小验证
- 安装前确认允许修改本机 Codex 插件配置并执行仓库内 Node.js hooks
codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail- 1核对插件与 hook 边界
打开 README、.codex-plugin/plugin.json 和 hooks/claude-codex-hooks.json，确认将安装 6 个 Skill，并会在会话启动、子 Agent 启动和用户提示提交时运行本地 Node.js 脚本。
- 2添加插件市场并安装
在终端依次运行 codex plugin marketplace add DietrichGebert/ponytail 和 codex plugin add ponytail@ponytail。不要合并或改写仓库给出的插件标识。
- 3审查并启用 hooks
启动 codex，打开 /hooks，查看每个命令指向的仓库内脚本；确认模式标记和可选配置的本地读写范围后再信任。桌面端用户安装后重启应用。
- 4验证模式与审查命令
新建任务，先用 @ponytail-help 检查 Skill 是否被发现，再对一个小型 diff 调用 @ponytail-review；输出应聚焦可删除的过度设计，而不是自动修改或跳过安全检查。
运行 codex 后打开 /hooks，确认 Ponytail 的本地 hooks 已审查并启用；新建任务调用 @ponytail-help 或 @ponytail-review，能够看到命令说明或针对当前 diff 的过度设计删减建议，即完成最小验证。
- Codex 桌面端安装后需要重启，CLI 需要开始新会话。
- 默认模式为 full；可用 /ponytail lite、/ponytail full、/ponytail ultra 或 /ponytail off 切换。
- 卸载插件前，如需清理模式标记、配置和由 Ponytail 设置的状态栏项，应先从插件目录运行 node scripts/uninstall.js，再执行 codex plugin remove ponytail。
- 复现 benchmark 才可能需要 .env.example 中的 Anthropic API Key；普通插件规则和本地 hooks 不以该凭据为安装前提。
使用场景
约束新功能实现范围
在添加小功能时让 Agent 先检查已有 helper、标准库或浏览器原生控件，减少为单一需求引入新依赖和包装层。
审查当前代码差异
使用 ponytail-review 检查本次 diff 是否出现不必要的接口、工厂、配置项、样板代码或重复实现。
仓库级过度设计审计
使用 ponytail-audit 从整个代码库寻找可以删除或合并的抽象，同时把安全、数据保护和可访问性保留为不可简化边界。
跨 Agent 统一开发规则
团队可根据宿主能力使用插件、Skill 或 AGENTS.md 适配器，让多个编码 Agent 采用同一套最小实现原则。
使用评价
从 README、核心 Skill、宿主清单、hooks 与公开测试看，Ponytail 的价值不在“少写字”，而在提供一套明确且可复用的实现决策顺序，并把安全与理解问题列为不可省略项。仓库提供多宿主适配、卸载说明和可复现基准，这是较完整的工程化交付。不过，效果数字来自作者自己的基准，当前也没有完成 Codex 实际安装；采用前仍应先审查 hooks，并用自己的任务和代码质量指标验证。
值得一试的地方
- 规则明确区分高效与草率，禁止省略安全、数据保护、校验和可访问性
- 同时提供插件、Skill、规则文件和多宿主适配文档
- 安装、模式切换、卸载和残留状态清理都有公开说明
- 新版 benchmark 公开任务、对照组、指标和局限说明
使用前要知道
- 作者基准不能保证在其他模型、仓库或复杂任务上复现相同比例
- 自动激活依赖本地 Node.js hooks 和用户信任
- 当前 Windows 测试中两项严格 1 秒 Python/pandas 超时检查未通过
- 过强的 ultra 模式可能不适合需求已经明确且必须完整交付的任务
README
Ponytail
Overview
Ponytail 为 Codex、Claude Code、OpenCode 等编码 Agent 提供一套最小实现规则、6 个配套 Skill 和生命周期 hooks，引导 Agent 先复用现有代码、标准库与平台原生能力，同时保留安全、校验、错误处理和可访问性边界。 Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Getting started
- 在 Codex 中先添加 Ponytail 官方 GitHub 仓库作为插件市场，再安装 ponytail@ponytail；随后审查并信任两个本地生命周期 hook，重启桌面端或新建 CLI 会话后，用 Ponytail 命令验证模式和审查功能。
- 核心阶梯从 YAGNI 开始，然后依次检查代码库现有实现、标准库、平台原生能力、已安装依赖和一行实现，最后才创建最小新代码。
- 默认模式是 full，也可切换 lite、ultra 或 off；配套命令支持 diff 审查、全库审计、技术债清单、基准结果和帮助。
- 运行 codex 后打开 /hooks，确认 Ponytail 的本地 hooks 已审查并启用；新建任务调用 @ponytail-help 或 @ponytail-review，能够看到命令说明或针对当前 diff 的过度设计删减建议，即完成最小验证。
Configuration
codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail