SKILL.md
Yunxiao
通过阿里云 CLI 插件 aliyun-cli-devops 调用云效 OpenAPI。不要用 aliyun configure / AK/SK;数据面只用个人访问令牌(PAT)。
Instructions
- 只做检测,不要预装:
``bash aliyun version aliyun devops version ``
- 通过:CLI ≥ 3.3.0 且插件返回版本 → 不要重装,继续步骤 2。 - 失败:aliyun 不存在、版本低于 3.3.0、或 devops 不可用 → 读并执行 [references/install.md](references/install.md)(装 CLI、装插件,再引导用户拿 PAT / orgId 并填写)。
- 不确定命令/参数:
aliyun devops --help或aliyun devops <command> --help,不要猜。
- 调用:
aliyun devops <command> [flags]。优先环境变量;用--cli-query收窄输出。不要先检查凭证。
- 调用失败后再检查凭证(只看是否存在,绝不打印令牌):
- PowerShell:[bool]$env:ALIBABACLOUDYUNXIAOACCESSTOKEN,以及 ORGANIZATIONID 或 APIBASEURL - bash:[ -n "$ALIBABACLOUDYUNXIAOACCESS_TOKEN" ]
- 未配置:读 [references/install.md](references/install.md) 的「获取并填写凭证」,引导用户去控制台拿 PAT 和 organization-id(或 Region 版 api-base-url),等用户填写后再写入环境变量。不要重装 CLI。不要把令牌回显到回复里。写入后再重试刚才失败的调用。
组织类型
| 中心版 | Region 版 | |
|---|---|---|
| 接入点 | 内置 openapi-rdc.aliyuncs.com,不要设 api-base-url |
控制台实例访问域名 → ALIBABACLOUDYUNXIAOAPIBASE_URL |
| 组织 ID | 必须 ALIBABACLOUDYUNXIAOORGANIZATIONID |
不要设 |
PAT:云效工作台 → 头像 → 个人设置 → 个人访问令牌。只在创建时显示一次。最小权限,设过期时间。
环境变量
中心版:ALIBABACLOUDYUNXIAOACCESSTOKEN + ALIBABACLOUDYUNXIAOORGANIZATIONID
Region 版:ALIBABACLOUDYUNXIAOACCESSTOKEN + ALIBABACLOUDYUNXIAOAPIBASE_URL
禁止把令牌写进命令行、回复、日志或 commit。检查时只报 已设置 / 未设置。
模块前缀
app-stack- AppStack · base- 组织成员 · codeup- Codeup · flow- Flow · insight- Insight · packages- Packages · projex- Projex · test-hub- TestHub
Examples
列出仓库:
aliyun devops codeup-list-repositories --page 1 --per-page 20
搜索项目:
aliyun devops projex-search-projects --page 1 --per-page 10
更多输入/输出见 [examples.md](examples.md)。
Additional resources
- 安装与首次填写凭证:[references/install.md](references/install.md)
- 命令与排错:[references/reference.md](references/reference.md)
- 用法示例:[examples.md](examples.md)