Ponytail Help 是 Ponytail 工具集的快速参考卡，被调用时展示所有 ponytail 模式、技能和命令。它是一次性显示，不会改变模式、写入标志文件或持久化任何内容。
用途 Ponytail Help 用于快速查阅 Ponytail 的各级别、技能与命令，帮助用户了解当前可用的触发方式和行为。
级别 Ponytail 提供三个级别：
- Lite：触发命令 /ponytail lite，行为是构建所要求的内容，并用一行指出更省事的替代方案。
- Full：触发命令 /ponytail，强制执行阶梯原则：YAGNI → stdlib → native → one line → minimum。这是默认级别。
- Ultra：触发命令 /ponytail ultra，是 YAGNI 极端主义，删除优先于添加，在构建前先质疑需求。 级别会保持到被更改或会话结束。
技能 Ponytail 包含以下技能：
- ponytail：触发命令 /ponytail，即懒惰模式本身，采用能工作的最简单方案。
- ponytail-review：触发命令 /ponytail-review，进行过度工程审查，例如 L42: yagni: factory, one product. Inline。
- ponytail-audit：触发命令 /ponytail-audit，对整个仓库进行过度工程审计，给出按优先级排序的删除清单。
- ponytail-debt：触发命令 /ponytail-debt，将 ponytail 的捷径注释收集到可跟踪的账本中。
- ponytail-gain：触发命令 /ponytail-gain，提供可衡量影响的记分板：更少代码、更低成本、更快速度。
- ponytail-help：触发命令 /ponytail-help，即本参考卡。
不同宿主的使用方式：Codex 使用 @ponytail、@ponytail-review 和 @ponytail-help；Claude Code 和 OpenCode 使用上述斜杠命令形式（OpenCode 将全部六个作为斜杠命令提供）。
停用 说 "stop ponytail" 或 "normal mode" 即可停用。随时可用 /ponytail 恢复。/ponytail off 同样有效。
配置默认模式 默认模式为 full，每个会话自动激活。更改方式：
- 环境变量（最高优先级）：export PONYTAIL_DEFAULT_MODE=ultra
- 配置文件（~/.config/ponytail/config.json，Windows：%APPDATA%\ponytail\config.json）：{ "defaultMode": "lite" } 将 defaultMode 设为 "off" 可禁用会话启动时的自动激活，需要时用 /ponytail 手动激活。 解析优先级：环境变量 > 配置文件 > full。
更新 启用自动更新：打开 /plugin，进入 Marketplaces，选择 ponytail，启用自动更新。Claude Code 随后会在启动时拉取新版本（出现提示时运行 /reload-plugins）。手动刷新：/plugin marketplace update ponytail 然后 /reload-plugins。 如果 /plugin 无法识别，说明 Claude Code 版本过旧。更新它（npm install -g @anthropic-ai/claude-code@latest，或 brew upgrade claude-code）并重启。其他宿主使用各自的更新流程。
更多 完整文档与示例：https://github.com/DietrichGebert/ponytail