cursor-agent

Cursor Agent

选项和边界

默认：cursor-agent --print --trust --yolo --workspace <abs-dir> "<prompt>"， 不指定模式/模型，文本输出，父进程等待 15m。调用此技能即授权运行该命令：无需询问，传入 --trust 和 --yolo。仅使用 Print 也可能写入内容。 “Plan” / “read-only plan”会添加 --plan 并省略 --yolo。“Ask” / “Q&A”会添加 --mode ask 并省略 --yolo。两者都保持只读，仍传入 --trust，并等待进程退出。“Use ”会添加 --model。“Interactive” / “TUI”会省略 print、--trust 和 --yolo；用户自行操作该对话。 “Resume ”会添加 --resume；“continue”会添加 --continue；两者都等待进程退出，并保留所选模式对应的 trust/yolo 选项。 “Worktree [name]”会添加 --worktree [name]；记录输出的路径。 “JSON” / “stream-json”会选择相应的输出格式。存在歧义时，状态为 BLOCKED。

只有用户明确指定时，才添加禁用沙盒、approve-mcps 或工作器桌面/凭据标志。 自动审查必须明确选择启用。不要停下来确认 trust 或 yolo；失败后不要添加这些额外标志。

1. 解析

确定工作区、提示词、模式、会话/工作树、输出和等待时长。 检查二进制文件和 cursor-agent status --format json，但不要泄露机密。 缺少二进制文件 → 按照 references/install.md 操作；缺少身份验证 → 除非用户要求登录，否则状态为 BLOCKED。 记录 cmd | workspace | mode | session | worktree | wait | evidence | terminal。 目标、二进制文件、身份验证以及 trust/yolo 选项均已确定后，即可完成。

2. 运行

构建 argv，并按原样引用提示词。文本/JSON 输出在退出前可能保持安静；没有输出不代表卡住。等待进程退出或达到记录的截止时间； 仅在达到截止时间时，终止本次运行的 PID。退出码非零：收集 stderr， 检查目录树，并报告 BLOCKED。如果 Print 运行出现 Workspace Trust Required，且缺少 --trust，则使用该 argv 并添加 --trust 重新运行。让 TUI 保持在用户自行操作的对话中。不要询问用户，也不要添加沙盒、MCP 或工作器标志。

对于 JSON/流式输出，遵循 references/streaming.md。 对于恢复、继续或持久化操作，遵循 references/sessions.md。 对于工作树/并行运行，遵循 references/worktrees.md。 对于 TUI 或其他命令语法，遵循 references/management.md。 对于登录、MCP、插件、工作器或 Bedrock，遵循 references/integrations.md 中相应的分支。遇到语法被拒绝时，使用适用范围内的 --help。 进程已退出、已记录预期中的活动会话，或已报告故障后，即可完成。

3. 验证并报告

检查状态和差异；CLI 文本未经验证。对已编辑的可执行代码，运行覆盖范围最小的测试。Plan/ask 必须保持目录树不变。 检查每个工作树以及任何已集成的目录树。除非保留，否则只清理本次运行创建的会话和干净的工作树；保留 shell 集成、MCP、 插件和工作器。报告命令、模式、会话/工作树、等待时长和结果证据。观察到每项结果或提供证据标记为受阻后，即可完成。

终端状态：SUCCESS、NO_CHANGES、BLOCKED。