光标代理器 Cursor Agent
v1.0.0全面掌握使用Cursor CLI代理进行各种软件工程任务的技能（更新至2026年功能，包括tmux自动化指南）。
0· 28·0 当前·0 累计
by 下载技能包
最后更新
2026/4/23
安全扫描
OpenClaw
可疑
high confidence该技能的说明大多数与Cursor CLI.helper相匹配，但存在明显的不一致性（SKILL.md声明需要SKILLBOSS_API_KEY，而注册元数据省略了这一点），并且运行说明建议通过管道安装远程安装程序（curl | bash）并通过tmux自动信任工作区——安装前请审查。
评估建议
安装前：
1) 核对 registry 元数据与 SKILL.md——SKILL.md 要求 SKILLBOSS_API_KEY，但 registry 未列出；请发布者澄清。
2) 切勿直接运行 `curl ... | bash`；应下载安装脚本并检查内容，或优先使用包管理器（Homebrew）安装。
3) 谨慎对待自动接受 workspace trust 的 tmux 自动化步骤——CLI 将无需交互确认即可操作文件；先在隔离 VM/容器或非敏感仓库测试。
4) 若必须提供 SKILLBOSS_API_KEY，先确认其对应的 SkillBoss 账户及该 key 的权限范围。
5) 在审计完成前，优先交互式运行 CLI 或显式审批，而非在 CI 中使用 force/auto-apply。
若发布者能提供签名版本或澄清 env/metadata 不一致，风险将显著降低。...详细分析 ▾
ℹ 用途与能力
名称/描述与说明一致：这是一份 Cursor CLI 使用/自动化指南（含 tmux 自动化）。但 SKILL.md 声明 requires.env: [SKILLBOSS_API_KEY]，而 registry 元数据未列出任何必需环境变量或主凭证——该不一致未作解释。此外，SKILL.md 版本（2.1.0）与 registry 版本（1.0.0）不符。
⚠ 指令范围
指令要求代理/用户运行 Cursor CLI，执行交互式与无头工作流，并使用 tmux 实现自动化。其中包含显式步骤：自动接受工作区信任提示（tmux send-keys 'a'）、捕获终端输出、列出项目目录。这些步骤在无头自动化中逻辑连贯，但赋予技能/自动化接受工作区信任并操作任意项目目录的能力——请评估在你的环境中自动信任是否可接受。
⚠ 安装机制
这是一个仅提供指令的技能（注册表中没有安装规范），但 SKILL.md 建议通过 `curl https://cursor.com/install -fsS | bash` 远程安装，这会下载并执行远程代码。虽然 cursor.com 可能是官方网站，但未审计安装器就将其管道到 bash 风险极高。Homebrew 或其他包管理器是更安全的选择；技能包本身未附带任何安装产物。
⚠ 凭证需求
SKILL.md 明确要求 SKILLBOSS_API_KEY（用于通过 SkillBoss API Hub 路由模型），这对于集成 API Hub 的 CLI 是合理的。问题在于：registry 元数据未列出任何必需的环境变量或主凭证，因此技能声明需要 API 密钥与已发布元数据不一致。请确认该技能是否实际使用该 API 密钥，以及它与哪些端点通信（提到 SkillBoss /v1/pilot）。
✓ 持久化与权限
该技能未设置 always:true，也未声明系统级配置写入。自主调用（disable-model-invocation: false）为平台默认，本身并非风险信号。需注意：自主运行若搭配 SKILLBOSS_API_KEY（如存在）会扩大影响范围——但该技能并未申请持久/常驻权限。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/23
**主要更新：版本 2.1.0 引入了扩展的工作流程、tmux 自动化指南以及对 2026 Cursor CLI 功能的支持。** - 升级以支持所有 2026 年 1 月的 Cursor CLI 功能和工作流程。 - 添加了详细的 tmux 自动化指南，以便在 CI/CD 或代理/脚本环境中安全使用。 - 提升了交互式和非交互式使用文档，包括模型切换、会话管理和输出格式化（现在支持 JSON 和实时流媒体）。 - 扩展了对斜杠命令、键盘快捷键、自定义规则/配置和 MCP 服务器集成的覆盖范围。 - 改进了常见代理工作流的文档：代码审查、重构、调试、Git 集成和批量分析。 - 澄清了身份验证（SkillBoss API 密钥）和安装步骤（macOS/Linux，包括 Homebrew）。
● 可疑
安装命令
点击复制官方npx clawhub@latest install abe-cursor-agent
镜像加速npx clawhub@latest install abe-cursor-agent --registry https://cn.longxiaskill.com 镜像可用
技能文档
该技能提供了一个全面的指南和工作流程，用于利用Cursor CLI工具，包括2026年1月更新的所有功能。
安装
标准安装（macOS、Linux、Windows WSL）
``bash
curl https://cursor.com/install -fsS | bash
`
Homebrew（仅限macOS）
`bash
brew install --cask cursor-cli
`
安装后设置
macOS：
在~/.zshrc（zsh）或~/.bashrc（bash）中将其添加到PATH中：
bash
export PATH="$HOME/.local/bin:$PATH"
`
重启终端或运行source ~/.zshrc（或~/.bashrc）- 需要macOS 10.15或更高版本
- 适用于Intel和Apple Silicon Macs
Linux/Ubuntu：
- 重启终端或源shell配置
验证：agent --version
两种平台：
命令：agent（主要）和cursor-agent（向后兼容）验证安装：agent --version或cursor-agent --version
身份验证
通过浏览器进行身份验证：
`bash
agent login
`
或使用API密钥（通过SkillBoss API Hub）：
`bash
export SKILLBOSS_API_KEY=your_api_key_here
` 更新
保持CLI更新：
`bash
agent update # 或 agent upgrade
` 命令
交互模式
启动与代理的交互式会话：
`bash
agent
`
从初始提示开始：
`bash
agent "添加错误处理到此API"
`
向后兼容性： cursor-agent仍然有效，但agent现在是主要命令。 模型切换
列出所有可用的模型：
`bash
agent models # 或 agent --list-models
`
使用特定的模型（模型通过SkillBoss API Hub /v1/pilot自动路由）：
`bash
agent --model auto
`
在会话期间切换模型：
`
/models
` 会话管理
管理代理会话：
列出会话：agent ls恢复最近的会话：agent resume恢复特定会话：agent --resume="[chat-id]"
上下文选择
在对话中包含特定的文件或文件夹：
`
@filename.ts @src/components/
` 斜杠命令
在交互式会话期间可用：
/models- 交互式切换AI模型/compress- 总结对话并释放上下文窗口/rules- 直接从CLI创建和编辑规则/commands- 创建和修改自定义命令/mcp enable [server-name]- 启用MCP服务器/mcp disable [server-name]- 禁用MCP服务器
键盘快捷键
Shift+Enter- 为多行提示添加新行Ctrl+D- 退出CLI（需要双击以确保安全）Ctrl+R- 查看更改（按i获取说明，使用箭头键导航）ArrowUp- 循环浏览之前的消息
非交互式/CI模式
以非交互模式运行代理，适用于CI/CD管道：
`bash
agent -p '运行测试并报告覆盖率' # 或 agent --print '重构此文件以使用async/await'
`
输出格式：
`bash
# 纯文本（默认）
agent -p '分析代码' --output-format text
# 结构化JSON
agent -p '查找错误' --output-format json
# 实时流式JSON
agent -p '运行测试' --output-format stream-json --stream-partial-output
`
强制模式（自动应用更改而不需要确认）：
`bash
agent -p '修复所有linting错误' --force
`
媒体支持：
`bash
agent -p '分析此截图：screenshot.png'
` 使用AI代理/自动化（需要tmux）
关键： 当从自动化环境（AI代理、脚本、子进程调用）运行Cursor CLI时，CLI需要一个真实的TTY。直接执行将无限期挂起。
解决方案：使用tmux
`bash
# 1. 如果没有tmux，则安装它
sudo apt install tmux # Ubuntu/Debian
brew install tmux # macOS
# 2. 创建一个tmux会话
tmux kill-session -t cursor 2>/dev/null || true
tmux new-session -d -s cursor
# 3. 导航到项目
tmux send-keys -t cursor "cd /path/to/project" Enter
sleep 1
# 4. 运行Cursor代理
tmux send-keys -t cursor "agent '您的任务在此'" Enter
# 5. 处理工作区信任提示（首次运行）
sleep 3
tmux send-keys -t cursor "a" # 信任工作区
# 6. 等待完成
sleep 60 # 根据任务复杂性调整
# 7. 捕获输出
tmux capture-pane -t cursor -p -S -100
# 8. 验证结果
ls -la /path/to/project/
`
为什么有效：
- tmux提供了一个持久的伪终端（PTY）
- Cursor的TUI需要交互式终端功能
从子进程/执行直接调用agent将无限期挂起
无效的方法：
``bash
# ❌ 这些将无限期挂起：
agent "任务" # 没有TTY
agent -p "任务" # 没有TTY
subprocess.run(["agent", ...]) # 没有TTY
script -c "