oneworks-cli-quickstartlisted
Install: claude install-skill oneworks-ai/app
在需要指导用户或代理如何使用 `oneworks` CLI 时使用这个 skill。
## 常用命令
- `oneworks "任务描述"`:直接执行一次任务。
- `oneworks --adapter codex --print "任务描述"`:以 print 模式输出事件与最终结果。
- `oneworks list`:查看最近的 CLI 会话。
- `oneworks list --view default`:显示 adapter、model 等常用列。
- `oneworks list --view full`:显示 context、PID 和辅助命令。
- `oneworks --resume <sessionId>`:恢复已有会话。
- `oneworks --resume <sessionId> --permission-mode bypassPermissions`:恢复已有会话,并覆盖下一次运行的权限模式。
- `oneworks --resume <sessionId> --yolo`:`--permission-mode bypassPermissions` 的短写。
- `oneworks stop <sessionId>`:优雅停止运行中的会话。
- `oneworks kill <sessionId>`:强制终止运行中的会话。
- `oneworks clear`:清理本地缓存和日志。
## 配置命令
- `oneworks config list`:查看 merged config 下哪些 section 当前有值。
- `oneworks config list models`:读取 `models` 视图。
- `oneworks config get general.defaultModel`:读取某个配置值。
- `oneworks config set general.defaultModel gpt-5.4 --type string`:写入配置值。
- `oneworks config unset general.defaultModel`:删除配置值。
- `oneworks config list` / `oneworks config get` 默认读 merged config;只有显式传 `--source project|user|all` 才切换来源。
- 文本模式默认输出 YAML;`--json` 输出原始结构化结果。
- `oneworks config get models` / `oneworks config list models` 在文本模式下会把 `modelServices` 里的模型列表与 `models` 里的 metadata 合并成人类可读视图;如果需要底层原始 metadata map,使用 `--json`。
## 技能与资产
- CLI 默认会注入 `@oneworks/plugin-cli-skills`。
- 这组插件当前包含 `oneworks-cli-quickstart`、`oneworks-cli-print-mode`、`oneworks-channel`、`oneworks-mem`、`create-entity`、`update-entity` 和 `create-plugin`。
- 通常直接描述需求即可;需要强制指定某个 skill 时,使用 `--include-skill <name>`。
- 需要排除某个 skil