核心用法
Cursor Agent Skill 提供两种互补路径使用 Cursor AI 进行编程：
Path 1: CLI（本地终端）
- 安装
agent命令行工具，支持交互式（agent）和非交互式（agent -p）两种模式 - 三种运行模式：Agent（完整编码）、Plan（先规划后执行）、Ask（只读探索）
- 支持云代理接力（
-c或&前缀），任务可在云端持续运行 - 自动加载项目规则（
.cursor/rules、AGENTS.md、CLAUDE.md）和 MCP 服务器 - 通过 PTY 包装在 OpenClaw 中调用（
pty:true），支持后台任务与轮询监控
Path 2: VS Code Node（远程 IDE 控制）
- 需安装
openclaw-node-vscode扩展，通过 Node 协议远程操控 Cursor/VS Code - 提供完整的 IDE API：文件操作、语言服务（跳转定义/引用/重构）、诊断信息、测试运行、调试协议、Git 操作
- 核心优势：获取真实类型错误、精确导航、闭环验证（修复→验证→提交）
选择策略：默认 CLI 追求速度；需要 IDE 智能（诊断、引用、调试）时切换到 Node。
显著优点
1. 灵活性极高：同一 skill 覆盖快速脚本到深度工程工作流
2. 云原生设计：CLI 支持无缝云端接力，适合长时间任务
3. IDE 级精准度：Node 路径提供真实诊断而非推测，消除"幻觉修复"
4. 上下文自动管理：自动加载项目规则和对话历史，支持会话恢复
5. 安全沙箱：CLI 支持网络访问控制，Node 强制相对路径和网关审批
潜在缺点与局限性
- CLI 需要 PTY 支持，在自动化环境中配置复杂
- Node 路径依赖扩展安装和连接状态，增加设置门槛
- 长任务需手动管理超时参数（30s-300s 不等）
- 双路径设计带来认知负担，需明确场景判断
- Cloud Agent 功能依赖 Cursor 官方服务可用性
适合人群
- 全栈开发者：需要快速原型 + 精确工程验证的完整工作流
- AI 辅助编程重度用户：熟悉 Cursor 生态，追求效率最大化
- 自动化/CI 场景：非交互式
-p模式适合集成到构建流程 - 大型项目维护者：Node 的诊断-修复-验证闭环对复杂代码库价值显著
常规风险
- CLI 的
--force模式自动应用变更，缺乏人工确认环节 - Node 路径的
vscode.agent.run实际仍委托给 Cursor Agent，存在 AI 生成代码的质量风险 - 文件系统操作（尤其 Node 的
write/delete）需警惕路径遍历（虽有防护） - Cloud Agent 涉及代码上传至 Cursor 云端，敏感项目需评估数据主权
- 后台任务（
background:true）需主动轮询，否则可能资源泄漏或状态丢失