ponytail

Ponytail 是一个面向 AI 编码代理的技能、插件和规则集，旨在推动它们编写更少、更简单的代码。它的口号是“懒惰的资深开发者”：与其为日期选择器之类的东西生成包装组件、样式表和依赖项，代理会被引导在任务仅需如此时使用现有的原生 HTML 输入（`<input type="date">`）。 ## 工作原理 在编写代码之前，代理会走一遍阶梯，并在第一个成立的台阶处停下： 1. 这需要存在吗？如果不需要，跳过它（YAGNI）。 2. 这个代码库中已经有了吗？复用它，不要重写。 3. 标准库能做吗？用它。 4. 原生平台功能？用它。 5. 已安装的依赖？用它。 6. 一行？就写一行。 7. 只有到这时：能起作用的最小实现。 该项目强调，阶梯是在代理理解问题之后运行，而不是取代理解：代理仍应阅读代码并追踪真实流程。它还强调，“懒惰”不是“疏忽”：验证、错误处理、安全性和可访问性绝不能被牺牲。 ## 基准测试声明 README 报告了一个代理式基准测试，使用无头 Claude Code 会话编辑一个真实的 FastAPI + React 模板，并根据十二个功能任务的 git diff 评分（Haiku 4.5，n=4）。它声称 ponytail 将 LOC 减少了约 54%（在过度构建的情况下最高可达 94%），同时还减少了 token、成本和时间，并在安全层级上保持 100%。它还包含较早的单次运行数据，显示代码减少了 80-94%，但附带说明：其中一部分差距来自对话式基线产物。该项目链接到完整说明和复现指南，而不是把这些数字当作唯一证据。 ## 安装与支持 Ponytail 可作为插件或规则集安装到多种 AI 编码宿主中，包括： - Claude Code 和 Codex，通过插件市场命令 - GitHub Copilot CLI，通过插件安装 - Gemini CLI 和 Antigravity CLI，通过扩展安装 - OpenCode，通过在 `opencode.json` 中添加插件条目 - Pi、Hermes Agent、Devin CLI、OpenClaw、Grok Build 和 Qoder，通过它们各自的包机制 - Cursor、Windsurf、Cline、Kiro、Zed、CodeWhale、Swival 等，通过复制规则文件（如 `AGENTS.md` 或相关规则目录） 它以一个单一仓库发布，包含共享的 `hooks/` 和 `skills/` 目录，以及针对特定代理的适配器。 ## 命令 支持技能的主机会暴露少量斜杠命令： - `/ponytail [lite | full | ultra | off]` - 设置强度或将其关闭 - `/ponytail-review` - 审查当前 diff 是否存在过度工程，并返回删除清单 - `/ponytail-audit` - 审计整个仓库是否存在过度工程 - `/ponytail-debt` - 将延迟的“ponytail:”捷径收集到账本中 - `/ponytail-gain` - 显示基准测试测得的实际影响 - `/ponytail-help` - 快速参考 级别可以按会话控制，通过 `PONYTAIL_SUBAGENT_MATCHER` 环境变量按子代理控制，或通过 `PONYTAIL_DEFAULT_MODE` 环境变量或一个小型配置文件设置默认值。 ## 开发 该仓库包含脚本，用于在所有代理副本之间保持紧凑规则文本同步（`node scripts/check-rule-copies.js`）、生成 OpenClaw 技能包、将技能发布到 ClawHub，以及运行正确性基准测试（Python 用于电子邮件和 CSV 检查）。 ## 许可证 MIT。