oneworks-cli-quickstart

name	oneworks-cli-quickstart
description	快速说明 One Works CLI 的常用命令、配置命令、会话查看和基础技能选择方式。

在需要指导用户或代理如何使用 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、oneworks-model-services、create-entity、update-entity 和 create-plugin。
• 通常直接描述需求即可；需要强制指定某个 skill 时，使用 --include-skill <name>。
• 需要排除某个 skill 时，使用 --exclude-skill <name>。
• 例子：oneworks --include-skill oneworks-cli-quickstart "教我怎么恢复一个失败的会话"
• 例子：oneworks "帮我创建一个前端评审实体"
• 例子：oneworks "给 frontend-reviewer 加上移动端布局记忆"
• 例子：oneworks --include-skill create-plugin "做一个插件，给 chat header 加一个截图按钮"

建议说明方式

• 先给出最短可执行命令。
• 再补 list / resume / stop 或 config get / config set 等排查命令。
• 如果用户提到模型列表、gpt-responses 或 models section，优先说明 modelServices 才是服务模型来源，models 是 metadata；必要时补一句 CLI 文本模式会对 models 做展开展示。
• 如果涉及 print 模式、权限确认或 stdin 控制，继续阅读 oneworks-cli-print-mode。
• 如果涉及 channel / user / session / global 记忆读写，继续阅读 oneworks-mem。
• 如果涉及模型服务商配置、官方 provider、API base、充值/API Key 后台入口或查询模型/余额/状态能力，继续阅读 oneworks-model-services。
• 如果涉及创建 entity，继续阅读 create-entity。
• 如果涉及更新已有 entity，继续阅读 update-entity。
• 如果涉及用 plugin 改界面、加入口、按钮、tab、launcher 搜索或 server API，继续阅读 create-plugin。