技能介绍

要解决的问题

编码代理接手任务时，常常不满足于"刚好能跑"的实现。需求只是"导出 CSV"，代理却可能引入新的 wrapper 层、抽象基类、配置文件格式，甚至顺手重构无关模块。这类过度构建在交付后持续产生成本：抽象层需要测试，概念需要新人理解，依赖关系扩大供应链风险。问题的根源不是代理能力不足，而是它缺少一道强制复查：动手写新代码之前，先确认现有代码、平台原生能力、标准库是否已经覆盖了需求。

技能如何工作

Ponytail 不替代编码代理，而是为它叠加一层可移植的规则约束，由三部分组成：

最小实现规则集：一组可移植的规则文件，确立"先复用、再扩展"的判断顺序，明确何种场景应优先使用现有代码、原生平台功能或标准库行为；
插件钩子：通过宿主的生命周期钩子注入检查逻辑，在代理开始构建前进行干预，其中 Claude Code 与 Codex 的钩子依赖 Node.js 环境；
审查命令：提供可调用的复查指令，在代理提出新抽象方案时触发一轮"是否过度构建"的评估。

整体流程大致是：代理接收任务 → 规则集约束其先检索现有实现 → 钩子在关键节点插入检查 → 方案提出时接受审查命令评估 → 确认现有手段无法满足后，才允许引入新抽象。

适用边界与注意点

技能依赖宿主的钩子机制，需确认所用编码代理支持加载其规则、插件或技能文件，官方列出的宿主包括 Claude Code、Codex、Gemini CLI、Cursor、Windsurf、Cline 等；
目前无法从上游自动提取源码级安装与使用说明，自动化流水线无法直接获取部署步骤，在敏感工作流启用前应人工审查上游项目；
它约束的是构建决策而非代码质量本身，不能替代代码审查、测试或安全扫描；
最小实现的判断依赖项目上下文，若代码库本身已过度抽象，规则可能延续既有的结构问题。