用途：在 shell 中无头调用 Cursor Agent，把任务委派给另一个 Cursor 智能体，适用于用户要求“call cursor”“ask cursor”“invoke cursor”等场景。若已在 Cursor IDE 聊天内，应使用 Task 工具而非本 CLI；需要长期运行的类型化服务则用 @cursor/sdk。
主要能力：默认只读（不改文件），加 --force 才允许改文件或执行变更命令；支持 --model、--mode plan|ask、--workspace、--resume 续接会话、--schema/--schema-json 结构化输出、--format toon|json、--full、--verbose、--max-runtime-ms、--idle-timeout-ms、--quiet、--prompt-file/--stdin、--sandbox。包装脚本始终传入 --trust --approve-mcps。
使用方式：全局脚本位于 ~/.agents/skills/cursor-cli/scripts/cursor-agent.mjs，可选启动器 cursor-agent。示例：cursor-agent "explain the backend routing"；cursor-agent --force "add a regression test for auth"；cursor-agent --resume <session-id> "follow up"。未安装启动器时直接运行 node ~/.agents/skills/cursor-cli/scripts/cursor-agent.mjs "your task"。安装：把技能目录放到 ~/.agents/skills/cursor-cli，需 Node 18+，无 npm 依赖；可选创建软链接并 chmod +x，确保 ~/.local/bin 在 PATH。
输出与错误：默认 TOON 格式输出到 stdout，调试用 --format json；错误也写 stdout。退出码 0 成功、1 错误、2 用法。信封字段含 status、sessionId、result、structuredOutput、error、help、usageSummary。结构化输出由包装器注入 schema 指令并校验基础子集（type、required、properties、items、enum），成功时优先读 structuredOutput。
认证：本机 agent login 后无需额外配置；CI/无头服务器需 CURSOR_API_KEY，可用 agent status 验证。
限制：Cursor CLI 本身无原生 JSON-schema 模式；默认只读，需显式 --force 才能修改；默认整体运行上限 30 分钟；--idle-timeout-ms 默认关闭。原始 CLI 逃生口：agent -p --trust --approve-mcps --workspace . "prompt"。文档见 https://cursor.com/docs/cli。