Ponytail Help 是 Ponytail 工具集中的帮助与参考技能,作用是在被调用时显示一张参考卡片。根据资料,它是一次性展示,不会改变模式、不写入 flag 文件、不持久化任何内容。
用途 当用户需要快速了解 Ponytail 的等级、技能和命令时使用。触发方式包括 /ponytail-help、"ponytail help",以及"how do I use ponytail"这类询问。
主要能力(参考卡片内容) 等级(Levels):
- Lite:触发命令 /ponytail lite,只构建被要求的内容,并用一行说明更小的选项。
- Full:触发命令 /ponytail,做最小的完整改动,在逻辑需要处加一个检查,并在回复中说明跳过了什么以及有何风险。这是默认等级。
- Ultra:触发命令 /ponytail ultra,在构建之前还会质疑请求并提出反对意见。 等级会一直保持,直到被更改或会话结束。
技能(Skills):
- ponytail(/ponytail):懒人模式本身,最少的新代码,清晰的回复并说明跳过的工作和风险。
- ponytail-review(/ponytail-review):对 diff 做质量审查,涵盖 bug、安全、负载、缺失测试、速度、可删减内容;每条发现都说明会出什么问题以及如何修复。
- ponytail-audit(/ponytail-audit):对整个仓库做同样的质量审查,并排序。
- ponytail-debt(/ponytail-debt):收集捷径注释到可追踪的账本中。
- ponytail-gain(/ponytail-gain):衡量影响的记分板,更少代码、更低成本、更快速度。
- ponytail-help(/ponytail-help):即本卡片。
使用方式 在 Codex CLI 和 IDE 扩展中,用 $ponytail:ponytail、$ponytail:ponytail-review 或 $ponytail:ponytail-help 调用技能。Claude Code 和 OpenCode 使用上述斜杠命令形式(OpenCode 将全部六个作为斜杠命令提供)。
停用方式 说 "stop ponytail" 或 "normal mode" 即可停用,随时用 /ponytail 恢复。/ponytail off 也可用。
Band(Claude Code) /ponytail band 隐藏提示上方的 band,同一命令可将其恢复。/ponytail band on 和 /ponytail band off 直接设置。等级保持不变。/ponytail band import 将你过去的 Claude Code 会话(成本、代理时间、token)加入看板。
配置默认模式 默认模式为 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
适用场景 适合需要快速查阅 Ponytail 等级、技能、命令、停用方式、Band 操作、默认模式配置和更新方法的用户。
限制 Ponytail Help 仅做一次性展示,不改变模式、不写入文件、不持久化。资料未提供收费、价格、平台支持范围等更多信息。