核心用法
Cursor Agent Skill 提供双路径架构，让开发者根据场景灵活选择：
路径1：CLI（本地终端）
- 安装 Cursor CLI 后通过
agent命令直接调用 - 三种模式：Agent（默认，读写执行）、Plan（设计优先）、Ask（只读探索）
- 支持交互式会话（
agent）和非交互式自动化（agent -p "task"） - 关键特性：Cloud Agent 云端接力、会话管理、
@filename上下文引用、MCP 服务器集成 - 重要限制：必须通过 PTY 运行（
pty:true），否则 TUI 会挂起
路径2：VS Code/Cursor Node（远程IDE）
- 依赖 OpenClaw Node 协议和
openclaw-node-vscode扩展 - 通过
nodes invoke调用 VS Code API，实现文件操作、语言服务、诊断、Git、测试、调试等完整IDE功能 - 核心价值：
diagnostics.get获取真实类型错误、test.run执行测试、debug.*断点调试 - 典型闭环：诊断→修复→验证→测试→提交
显著优点
1. 双路径灵活：CLI 极速启动 vs Node 精准IDE智能，场景适配性强
2. Cloud Agent：任务云端持续运行，无需保持本地连接
3. 完整工具链：内置规则系统、MCP 集成、沙箱网络控制、会话压缩
4. Node 路径闭环：首次实现"AI编码-IDE验证-自动提交"的无缝工作流
潜在缺点与局限
1. CLI PTY 依赖：OpenClaw 集成时必须配置 pty:true，增加复杂度
2. Node 前置依赖：需安装扩展、保持连接、配置 Gateway 白名单，启动成本高
3. 超时管理：Node 路径需手动设置 invokeTimeoutMs，AI 任务易超时
4. 路径选择门槛：新手难以判断何时用 CLI 何时用 Node
适合人群
- 追求效率的资深开发者（CLI 快速模式）
- 需要类型安全的严谨项目（Node 诊断闭环）
- 远程/云端开发场景（Cloud Agent + Node 组合）
- 已在使用 Cursor/VS Code 作为主力IDE的用户
常规风险
- CLI：
--force模式自动应用变更无确认，需配合版本控制；沙箱模式网络权限需显式配置 - Node：扩展连接中断导致命令失败；相对路径限制可能引发路径错误；Gateway 白名单配置不当会阻断合法命令