前言¶
用 AI 写代码时，模型很容易顺手加一层抽象、多引一个依赖，或者把三行能做完的事扩成一个小框架。你明明只想修一个 bug，diff 却越变越长。Ponytail 是一套面向编码任务的「最少可用方案」约束：YAGNI、优先标准库、最短 diff。但它往往绑定在特定智能体产品里；部分工具（SkillHub 简介里提到的 trea 等）并不能直接接入。
下面介绍社区包 ponytaill-skill：把 Ponytail v4.8.4 的核心提示词抽成一份通用 SKILL.md，通过 SkillHub 安装到 Cursor、Claude Code 等支持 Skills 的客户端，让 Agent 在会话里按同一套规则干活。
这是什么¶
ponytaill-skill 在 SkillHub 上的坐标是 @user_f3f6053c/ponytail5424，当前版本 1.0.4，分类 dev-programming，来源 community，发布者 user_f3f6053c，不需要 API Key（requires_api_key=false）。
包内说明写明：内容来自 Ponytail v4.8.4（MIT），由发布者整理为 Skill 形态，方便无法接入原版 Ponytail 的 Agent 使用。SkillHub 页面当前统计为评分 100000、下载 1673（以商店页为准，会随时间变化）。
一句话定位：强制采用最简单、最短、最精简的可用方案，并附带审查、审计、技术债与帮助等子能力说明，合并在一份技能文档里。
核心功能¶
安装后，Agent 读取的是一份「六合一」技能说明（主技能 + 五个专项技能）。各子技能职责如下，触发方式以文档中的口令为准。
ponytail（主技能）¶
默认 full 强度，贯穿每次编码相关回复，直到用户说 stop ponytail 或 normal mode。强度可用 /ponytail lite|full|ultra 切换。
核心行为是 梯子决策框架：先问是否需要做（YAGNI）→ 复用本仓库已有代码 → 标准库 → 原生平台能力 → 已安装依赖 → 一行解法 → 最后才写最少实现。输出习惯是 代码优先，再用最多三行说明「跳过了什么、何时再加」。
自然语言也可触发，例如：ponytail、be lazy、yagni、simplest solution 等。文档明确 不用于 纯非编码请求（百科、翻译、菜谱等）。
ponytail-review（过度工程审查）¶
针对 diff 做复杂度审查，只找可删、可换标准库/原生能力、可压缩的实现。每条一行，格式类似 L12: stdlib: ...，结尾给出 net: -<N> lines possible.。触发：/ponytail-review 或「review for over-engineering」等。
ponytail-audit（全仓库审计）¶
与 review 同类标签，但扫描 整个仓库，按「能删多少」排序，一次性报告，不自动改代码。触发：/ponytail-audit、audit this codebase 等。
ponytail-debt（技术债追踪）¶
扫描代码里 ponytail: 注释（主技能要求对刻意简化标注上限与升级路径），汇总成台账。可用类似下面的命令思路（文档示例）：
grep -rnE '(#|//) ?ponytail:' .
触发：/ponytail-debt、ponytail ledger 等。只读报告；若要落盘可请 Agent 写到例如 PONYTAIL-DEBT.md。
ponytail-gain（收益展示）¶
一次性展示 Ponytail 官方基准的中位数记分牌（5 个日常任务、3 个模型），说明代码量、成本、速度的区间对比；不是当前仓库的真实节省统计。触发：/ponytail-gain。
ponytail-help（帮助参考）¶
打印强度级别、子技能与触发词对照表，以及默认模式配置方式。触发：/ponytail-help。
文档中还提到原版 Ponytail 的默认模式配置（在完整 Ponytail 集成时生效；作为 Skill 使用时，以 Agent 是否遵循 SKILL.md 为准）：
export PONYTAIL_DEFAULT_MODE=ultra
{ "defaultMode": "lite" }
配置文件路径：~/.config/ponytail/config.json（Windows：%APPDATA%\ponytail\config.json）。优先级：环境变量 > 配置文件 > full。
安装与启用¶
先做 SkillHub CLI 检查；未安装则按官方安装文档执行（见 SkillHub 安装说明）。
command -v skillhub && skillhub --version
安装 ponytaill-skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则技能可能落在 ./skills/ 而不会被识别：
skillhub install @user_f3f6053c/ponytail5424 --dir <你的 skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
SkillHub 技能页也支持把下面这句交给 AI，让其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f3f6053c/ponytail5424`。
安装完成后，按你所用客户端的要求刷新或重启 Agent，使新技能被加载。
典型用法¶
经过上面的步骤启用技能后，可以在编码会话里直接用文档约定的触发词，无需再背一长段 system prompt。
- 日常写代码 / 重构：开启懒惰模式并开始任务。
/ponytail full
给这个 API 响应加缓存，尽量别引入新依赖。
期望 Agent 先走梯子（例如优先 functools.lru_cache），并简短说明跳过的方案。
- 只看 PR 是否过度设计：
/ponytail-review
审查当前 diff，只报 over-engineering。
- 老项目减负：
/ponytail-audit
全仓库审计，按能删的行数排序。
- 核对之前留下的简化标记：
/ponytail-debt
- 查命令与强度：
/ponytail-help
关闭懒惰模式：stop ponytail 或 normal mode。
适用场景与注意¶
适合谁：希望 Agent 在写码、修 bug、选型依赖时默认「少写、少引库、少抽象」的团队或个人；需要在 Cursor 等环境复用 Ponytail 规则、又无法接原版集成时，这个 Skill 包是对齐思路的捷径。
限制与注意：
- 技能效果是 提示词约束，取决于模型与客户端是否稳定加载
SKILL.md；与原生 Ponytail 插件的环境变量、持久模式未必一一对应。 ponytail-review/ponytail-audit只管复杂度，正确性、安全、性能问题应走常规 review。ponytail-gain展示的是 公开基准中位数，不要当成「本仓库已省下的行数」。- 主技能要求信任边界上的校验、安全、显式需求不能省；「懒」体现在解法长度，不是跳过读代码和理解问题。
结尾¶
ponytaill-skill 把 Ponytail 的懒惰开发模式与六个相关能力收成一份可安装的 Agent Skill，解决「工具接不上 Ponytail、又想统一 YAGNI 风格」的问题。安装与详情以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_f3f6053c/ponytail5424
- API 条目：https://api.skillhub.cn/user_f3f6053c/ponytail5424
更完整的原版文档与示例见：https://github.com/DietrichGebert/ponytail
