用途
ponytail-help 是 ponytail 代理技能的快速参考卡片。调用时它会展示所有 ponytail 模式、技能与命令的说明。它是一次性展示,不会改变模式、写入标记文件或持久化任何内容。
触发方式:/ponytail-help、"ponytail help" 等。
等级
- Lite(/ponytail lite):按需求构建,并用一行指出更省事的替代方案。
- Full(/ponytail):执行阶梯约束:YAGNI -> 标准库 -> 原生 -> 一行 -> 最小实现。这是默认等级。
- Ultra(/ponytail ultra):YAGNI 极端主义,先删除后新增,在构建前质疑需求。
等级会保持到更改或会话结束。
技能
- ponytail(/ponytail):懒人模式本身,选择能工作的最简方案。
- ponytail-review(/ponytail-review):过度工程审查,例如 L42: yagni: factory, one product. Inline。
- ponytail-help(/ponytail-help):即本参考卡片。
Codex 使用 @ponytail、@ponytail-review、@ponytail-help;Claude Code 与 OpenCode 使用上述斜杠命令形式(OpenCode 提供 /ponytail 与 /ponytail-review)。
停用
说 "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