Cursor CLI 集成

1先选路：hooks 还是规则文件

Cursor 的集成比别家多一层选择，因为 Cursor 同时支持「规则文件」和「hooks」两种注入机制。它们不是叠加关系，而是互斥的替代方案，这一点必须先讲清楚，否则后面会莫名其妙地失效。

2路线 A：装 hooks

git clone https://github.com/DietrichGebert/ponytail
node ponytail/scripts/cursor-hooks.js install            # 写进 ~/.cursor/hooks.json，对所有项目生效
node ponytail/scripts/cursor-hooks.js install --project  # 写进 <当前目录>/.cursor/hooks.json，只对本项目生效

用户级还是项目级？判断标准很简单：你希望这个能力跟着机器走，还是跟着仓库走。跟着机器走就用不带参数的版本；只在某个仓库试水就加 --project。

安装脚本做的事比看上去多，有五条值得知道：

还有一条「部署纪律」：装完就别挪仓库目录。因为写进 hooks 的是绝对路径，移动后必须重新跑一次 install。

3它到底往 hooks.json 里写了什么

模板长这样（PONYTAIL_DIR 在安装时被替换成实际路径）：

{
  "version": 1,
  "hooks": {
    "sessionStart": [
      { "command": "node "PONYTAIL_DIR/hooks/ponytail-activate.js"", "timeout": 5 }
    ],
    "beforeSubmitPrompt": [
      { "command": "node "PONYTAIL_DIR/hooks/ponytail-mode-tracker.js"", "timeout": 5 }
    ]
  }
}

两个钩子各管一件事，理解这个分工，第 5 章的限制就都能自己推出来：

4验证：别猜，让模型背出来

官方给了一条很聪明的验收方法，核心思想是：钩子执行了不等于内容送达了。所以要反过来问模型——让它把收到的上下文念出来。

1. 确认工作区里没有 .cursor/rules/ponytail.mdc
2. 装好 hooks，开一个新的 Agent 对话
3. 问：Quote the first line of any ponytail context you were given.
4. 期望回答：PONYTAIL MODE ACTIVE — level: full（或你设的默认强度）
5. 发 /ponytail lite，再问同一句。期望：PONYTAIL MODE CHANGED — level: lite。ultra 同理
6. 发 /ponytail off，再问。期望：PONYTAIL MODE OFF

为什么这招有效？因为 PONYTAIL MODE CHANGED — level: lite 这串字符串只存在于 hook 的输出里。模型能念出来，就证明那条通路真的打通了。如果它念的是技能正文开头的 # Ponytail，说明你同时把技能装进了 ~/.cursor/skills，Cursor 把 /ponytail lite 当成了手动挂载技能并内联了完整正文——这不影响 hook 工作，但会让你误判验证结果。

5在 Cursor 里怎么切强度

因为 Cursor 没有对应斜杠命令，强度切换是当成普通消息发出去的纯文本。hook 会从你的提示里把字面量 /ponytail lite 抓出来。

关于 off 有个细节值得知道：标志文件删了，但启动时注入的那份规则集还留在对话的系统上下文里。真正让它停下来的，是 PONYTAIL MODE OFF 这条通知——跟 Claude Code 的做法一致，模型看到通知就不再套用规则。所以别指望「删掉文件 = 从上下文里抹掉」。

6路线 B：只放一条规则文件

不用 clone，不用 node。把仓库里的 .cursor/rules/ponytail.mdc 拷到你项目的 .cursor/rules/ 目录即可。文件头的 frontmatter 决定了它的生效方式：

---
description: Ponytail, lazy senior dev mode. Always pick the simplest solution that works.
globs:
alwaysApply: true
---

关键是最后一行 alwaysApply: true——它让这份规则贴在每一个提示前面，不需要你手动 @ 引用。规则正文就是第 1 章那套梯子，只是用更紧凑的措辞写的，并且没有 lite/full/ultra 的裁剪版本。

7一页速查：Cursor 两条路线对照