ponytail-help

Ponytail Help 是 Ponytail 的快速参考卡，用途是在被调用时集中展示 Ponytail 的全部模式、技能与命令，方便用户查阅入口和触发方式。根据资料，它属于“一次性显示”：调用后不改变模式、不写 flag 文件、不持久化任何内容。

模式与级别：

• Lite（/ponytail lite）：构建被要求的内容，并用一行指出更省事的替代方案。
• Full（/ponytail）：默认级别，强制执行阶梯：YAGNI → 标准库 → 原生 → 一行 → 最小化。
• Ultra（/ponytail ultra）：YAGNI 极端派，先删除再新增，在构建前质疑需求。 级别会保持到被更改或会话结束。

技能与命令：

• ponytail（/ponytail）：懒惰模式本身，采用能起作用的最简单方案。
• ponytail-review（/ponytail-review）：过度工程审查，以内联形式报告，示例格式为 L42: yagni: factory, one product。
• 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" }。设为 "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。