安装 Skill
skill 命令把随组件发布的 s-fc-sandbox skill 安装到主流 AI 编码工具的 skills 目录，让这些工具能直接理解云沙箱的 s.yaml 与命令用法。
这是纯本地操作，不调用任何云端 API，也不需要配置凭证——是组件里唯一不需要 access 的命令。
命令解析
当执行命令skill -h/skill --help时，可以获取帮助文档。
支持的工具与安装位置
工具（--tools 取值） |
安装目录 |
|---|---|
| claude | <root>/.claude/skills/s-fc-sandbox |
| codex | <root>/.codex/skills/s-fc-sandbox |
| cursor | <root>/.cursor/skills/s-fc-sandbox |
| qoder | <root>/.qoder/skills/s-fc-sandbox |
| agents | <root>/.agents/skills/s-fc-sandbox |
<root> 由安装范围决定：
--global：用户 home 目录（默认）--project：当前目录- 同时指定两者：两个位置都装一份
skill install 命令
skill install 命令，是安装 skill 的命令。已存在的安装会被跳过，除非指定 --force。
当执行命令skill install -h/skill install --help时，可以获取帮助文档。
参数解析
| 参数全称 | 参数缩写 | 必填 | 参数含义 |
|---|---|---|---|
| tools | - | 选填 | 目标工具，逗号分隔：claude,codex,cursor,qoder,agents，默认全部 |
| global | - | 选填 | 安装到用户 home 目录（默认范围） |
| project | - | 选填 | 安装到当前项目目录 |
| force | - | 选填 | 覆盖已存在的安装 |
操作案例
s cli fc-sandbox skill install # 全局安装到全部 5 个工具
s cli fc-sandbox skill install --tools claude,codex # 只装指定工具
s cli fc-sandbox skill install --project # 装到当前项目目录
s cli fc-sandbox skill install --global --project # 两个范围都装
s cli fc-sandbox skill install --force # 覆盖已存在的安装
上述命令的执行结果示例：
✔ claude (global): installed → /Users/xxx/.claude/skills/s-fc-sandbox
- codex (global): skipped, already installed at /Users/xxx/.codex/skills/s-fc-sandbox (use update or --force)
✔ cursor (global): installed → /Users/xxx/.cursor/skills/s-fc-sandbox
✔ qoder (global): installed → /Users/xxx/.qoder/skills/s-fc-sandbox
✔ agents (global): installed → /Users/xxx/.agents/skills/s-fc-sandbox
skill install done: 4 written, 1 skipped
--tools 传入未支持的工具名时报错：
Unknown tool(s): vim. Supported: claude, codex, cursor, qoder, agents
skill update 命令
skill update 命令，是更新 skill 的命令。与 install 的唯一区别是：总是覆盖已存在的安装，不需要 --force。
当执行命令skill update -h/skill update --help时，可以获取帮助文档。
参数解析
| 参数全称 | 参数缩写 | 必填 | 参数含义 |
|---|---|---|---|
| tools | - | 选填 | 目标工具，逗号分隔：claude,codex,cursor,qoder,agents，默认全部 |
| global | - | 选填 | 更新用户 home 目录下的安装（默认范围） |
| project | - | 选填 | 更新当前项目目录下的安装 |
操作案例
s cli fc-sandbox skill update
s cli fc-sandbox skill update --tools qoder
s cli fc-sandbox skill update --global --project
上述命令的执行结果示例：
✔ claude (global): updated → /Users/xxx/.claude/skills/s-fc-sandbox
✔ codex (global): updated → /Users/xxx/.codex/skills/s-fc-sandbox
skill update done: 2 written, 0 skipped
注意事项
- 写入前会先删除目标目录再整体拷贝，因此不会留下上一版的残留文件；目标目录下的自定义修改也会被覆盖。
- 组件升级后建议执行一次
skill update，让 skill 与组件版本保持一致。
权限与策略说明
不需要任何云端权限，也不需要 -a/--access 参数。