workctllisted

# Work Agent CLI Skill 通过 `workctl` 命令管理 Work Agent 平台能力。 ## 首次使用 — 安装与就绪检查 (BOOTSTRAP) 每次会话首次使用 workctl 前，必须按以下顺序检查就绪状态： ### Step 1: 检查 workctl 是否可用 ```bash workctl version --format json ``` 如果返回 `command not found` 或类似错误，执行安装： ```bash npm install -g @accio-ai/cli@latest ``` 安装完成后重新执行 `workctl version --format json` 验证。 ### Step 2: 检查认证状态 ```bash workctl auth status --format json ``` 如果返回 `authenticated: false` 或 `auth_not_found`： ```bash workctl auth login --provider alibaba --format json ``` ### Step 3: 检查命令发现缓存 ```bash workctl cache status ``` 如果缓存状态为 `stale` 或命令数为 0： ```bash workctl cache refresh ``` **只有三步都通过后，才可以执行业务命令。** ## CLI 版本与升级 当 `workctl version --format json` 返回的版本低于本 Skill 要求的 `cli_version` 时，执行升级： ```bash npm install -g @accio-ai/cli@latest ``` 升级后缓存会自动清除（postinstall 行为），无需手动清理。 ## 严格禁止 (NEVER DO) - 不要使用 workctl 命令以外的方式操作（禁止 curl、HTTP API、浏览器） - 不要编造 UUID、ID 等标识符，必须从命令返回中提取 - 不要猜测字段名/参数值，操作前必须先查询确认 - 不要跳过 BOOTSTRAP 步骤直接执行业务命令 ## 严格要求 (MUST DO) - 所有命令必须加 `--format json` 以获取可解析输出 - 危险操作必须先向用户确认，用户同意后才加 `--yes` 执行 - 单次批量操作不超过 30 条记录 - 所有命令参数和参数值之间至少用一个空格隔开 ## 发现可用命令 ```bash # 查看所有产品 workctl schema # 查看某个命令的完整参数 workctl schema <product>.<group>.<command> --format json # 示例 workctl schema messaging.thread.list --format json workctl schema directory.user.search --format json ``` ## 命令使用流程 ### 1. 查看产品列表 ```bash workctl schema ``` ### 2. 查看工具参数 ```bash workctl schema <product>.<group>.<command> --format json ``` ### 3. 预览命令（不执行） ```b