技能简介
Cursor代理(cursor-agent)提供使用 Cursor CLI 工具的综合指南和工作流,包含2026年1月更新的所有功能,支持各种软件工程任务。
能做什么
- 启动交互式会话或带初始提示的会话
- 切换AI模型(gpt-5等)
- 管理会话(列表、恢复)
- 选择上下文文件/文件夹
- 使用斜杠命令(/models、/compress、/rules等)
- 非交互式/CI模式运行
- 通过tmux在自动化环境中运行
- 支持媒体文件分析
使用说明
安装 Skill:
通过 ClawHub 安装:
clawhub install cursor-agent
安装 Cursor CLI:标准安装:curl https://cursor.com/install -fsS | bash;Homebrew:brew install --cask cursor-cli
配置 PATH:macOS 添加到 ~/.zshrc 或 ~/.bashrc:export PATH="$HOME/.local/bin:$PATH"
认证:浏览器认证:agent login;API密钥:export CURSOR_API_KEY=your_api_key
交互模式:agent 或带初始提示:agent "Add error handling to this API"
模型切换:列出:agent models,使用:agent --model gpt-5,会话中:/models
会话管理:列表:agent ls,恢复最近:agent resume,恢复特定:agent --resume="[chat-id]"
上下文选择:@filename.ts 或 @src/components/
CI模式:agent -p 'Run tests',JSON输出:--output-format json,强制模式:--force
自动化环境(tmux必需):Cursor CLI需要真实TTY,直接执行会挂起。使用tmux:创建会话、发送命令、等待、捕获输出。详见SKILL.md中的tmux示例。
输入与输出
| 项目 | 内容 |
|---|---|
| 输入 | 自然语言、文件路径、模型名、命令选项 |
| 输出 | 代码修改、会话历史、分析结果、JSON |
| 适用人群 | Cursor用户、AI编程团队、CI/CD自动化 |
| 不包含 | 图形界面、无需认证、离线运行 |
见下方输入与输出表格。
风险提示
- 自动化环境必须使用tmux,直接调用会挂起
- 需要macOS 10.15+或Linux
- 首次运行需要信任工作区(发送’a’)
- –force模式自动应用更改无确认
- 需要稳定的网络连接
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/swiftlysingh/cursor-agent/SKILL.md
来源类型:GitHub
