mcpField
C
cursor-agent

cursor-agent

github.com/veselyAgent 工作流2865 次安装7 周前更新
代码仓库

关于 cursor-agent

cursor-agent 是一项技能，可将任务交给 Cursor 的无头命令行 Agent，并附上简短的 Claude 摘要。它支持解析模型与模式提示，并为代码审查补充提示词。

主要功能

  1. 01通过无头模式委派任务给 cursor-agent
  2. 02解析模型和模式提示
  3. 03补充代码审查提示词
  4. 04返回原始回复及 Claude 摘要

适用场景

  1. 01获取代码审查的第二意见
  2. 02评议实现计划
  3. 03审阅文本或文案
  4. 04提出一般问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vesely/skills --skill cursor-agent

安装后在 Claude Code 中输入/cursor-agent确认已加载。

附带文件README.md

详细介绍

Cursor Agent

将任务委派给 Cursor 的无头 CLI Agent（cursor-agent）。可借此获取非 Claude 模型的第二意见，用于代码审查、计划评议、文本／文案审阅或一般问答。

输入

  • $task：要交给 cursor-agent 的任务。通常是审查或提问提示词。如果用户指定了模型（例如“用 Opus”“使用 GPT”“pomocí Sonnetu”），请提取模型提示并通过 --model 传入。

目标

运行无头模式的 cursor-agent，将其输出呈现给用户，并附上一段简短的 Claude 摘要，免得用户重新通读一大段内容。

步骤

1. 解析任务

从 $task 和上下文对话中提取：

  • 模型提示 — 查找类似以下的措辞：
    • “Opus”／“claude” → --model claude-opus-4-7-medium
    • “Sonnet” → --model claude-4.6-sonnet-medium
    • “GPT”／“GPT-5”／“Codex” → --model gpt-5.3-codex
    • “Gemini” → --model gemini-3.1-pro
    • “Auto” → --model auto
    • 未提及 → 不传入 --model（cursor 使用其默认模型：composer-2-fast）
  • 模式提示：
    • “plan”／“plan mode”／“navrhni” → --mode plan
    • “write”／“edit”／“implement”／“headless” → 不传入 --mode（cursor 可以写入）
    • 其他情况 → --mode ask（只读，默认）
  • 是否为审查？ 如果任务提及“review”“check”“verify”“second opinion”，或引用了分支／PR／差异，请补充提示词（见步骤 2）。

成功标准：确定标志，并准备好提示词。

2. 补充提示词（仅限审查）

如果任务是代码审查：

  • 确定差异的范围。按以下顺序尝试：任务中明确提到的引用（PR 编号、分支名称）、当前分支与 main 的差异（git diff origin/main...HEAD），或未提交的更改（git diff HEAD）。
  • 在提示词前加上一段简短指令，告知 cursor-agent 要检查的内容：

    “审查分支 <name> 与 main 的差异。使用 git diff origin/main...HEAD 查看实际更改。关注真正的问题（正确性、边界情况、安全性）；跳过吹毛求疵的意见。报告不超过约 400 词，并注明 file:line。”

对于非审查任务（提问／计划／文本／UI），按原样传入任务。

成功标准：为 CLI 准备好最终提示词字符串。

3. 运行 cursor-agent

通过 Bash 以无头模式调用：

cursor-agent -p --output-format text [--mode <mode>] [--model <model>] "<prompt>"
  • 始终使用 -p（打印／无头模式）。
  • 除非任务需要结构化输出，否则始终使用 --output-format text。
  • 工作区默认为 pwd — 除非用户明确要求使用其他目录，否则不要传入 --workspace。
  • 对于仅使用非写入模式（--mode ask 或 --mode plan）的运行，无需额外的权限标志。对于无头写入模式，不要擅自添加 --force 或 --yolo；应先询问用户。
  • 如果怀疑响应很长，且希望限制上下文用量，可通过管道传给 tail -n 200。默认情况下，获取完整输出。

成功标准：cursor-agent 成功返回（退出码为 0）并给出响应。如果运行出错（身份验证失败、模型不可用），应将错误告知用户，不要隐藏。

4. 返回输出

按以下顺序呈现给用户：

  1. Cursor 的原始响应 — 直接引用，让用户听到另一个模型的原声，包括文件:行号引用。
  2. 你的简短摘要 — 最多 3–6 个项目，用水平分隔线隔开。指出哪些是真正的问题、哪些是噪音，并建议具体的后续行动。不要悄悄过滤 cursor 的发现；如果你不同意其中某项，要明确说明。

摘要应简洁 — 目标是免去用户重新通读的麻烦，而不是取代 cursor 的输出。

成功标准：用户同时看到 cursor 的原始输出和经过 Claude 梳理的行动清单。

注意事项

  • cursor-agent --list-models 会显示所有可用的模型 ID。如果用户要求使用一些特殊模型（例如“思考档”或“最高档”），请先查看列表。
  • cursor-agent 会像任何命令行工具一样，在当前工作区内读取和写入文件；默认情况下，它不在沙箱中运行。对待它的输出，应像对待队友的 PR 评论一样：信任，但要核实。
  • 此技能用于单次委派。若需要更长时间的来回协作，用户可以自行交互式运行 cursor-agent（不带 -p）。

评论

支持 Markdown