$npx -y skills add agentscope-ai/QwenPaw --skill alicloud_cli阿里云 CLI 中文文档镜像检索与命令辅助:先走章节索引,再下钻正文页面,给出命令前必须有本地文档证据。
| 1 | # Alicloud CLI 中文索引技能(alicloud_cli) |
| 2 | |
| 3 | ## 目标 |
| 4 | |
| 5 | 把当前离线文档 `md_mirror/zh/cli` 作为唯一主源,先按“章节索引”定位范围,再定位具体页面,避免在全量目录盲搜。 |
| 6 | |
| 7 | ## 强制工作流(速查优先,索引兜底) |
| 8 | |
| 9 | 1. 先使用本文件“CLI 常见用法速查”直接回答高频问题,减少读文件次数。 |
| 10 | 2. 若问题超出速查范围,再读 `references/docs_index.md` 确认章节。 |
| 11 | 3. 再进入章节目录(如 `use-cli/`、`installation-guide/`、`configure-cli/`)定位具体页面。 |
| 12 | 4. 输出命令、参数、选项时,必须来自“速查”或已命中的正文页面;找不到时明确“证据不足”。 |
| 13 | 5. 不新增需求外资源,不做“顺手增强”。 |
| 14 | |
| 15 | ## 文档索引主链 |
| 16 | |
| 17 | 1. `references/docs_index.md`:统一入口与章节映射(主链起点) |
| 18 | 2. `references/cli-official-links-index.md`:官方链接索引(通过链接 ID 引用) |
| 19 | 3. `references/links.md`:链接 ID -> 官方 URL |
| 20 | 4. `md_mirror/zh/cli/<section>/...`:章节正文与子页面 |
| 21 | |
| 22 | ## 章节路由(意图归类) |
| 23 | |
| 24 | - 产品定义与能力概览:优先 `md_mirror/zh/cli/what-is-cli/` |
| 25 | - 快速起步与支持产品:优先 `md_mirror/zh/cli/quick-start/` |
| 26 | - 安装、升级、卸载:优先 `md_mirror/zh/cli/installation-guide/` |
| 27 | - 凭证、代理、自动补全:优先 `md_mirror/zh/cli/configure-cli/` |
| 28 | - 命令结构、参数格式、输出过滤、分页聚合、轮询:优先 `md_mirror/zh/cli/use-cli/` |
| 29 | - 脚本实践、跨地域迁移、容器运行:优先 `md_mirror/zh/cli/best-practices/` |
| 30 | - 编辑器与终端工具:优先 `md_mirror/zh/cli/common-tools/` |
| 31 | - 故障诊断与版本变更:优先 `md_mirror/zh/cli/cli-troubleshooting/` 和 `md_mirror/zh/cli/version-updates/` |
| 32 | |
| 33 | ## CLI 常见用法速查(默认优先使用) |
| 34 | |
| 35 | ### 帮助与发现 |
| 36 | |
| 37 | - 查看 CLI 总帮助:`aliyun --help` |
| 38 | - 查看产品帮助:`aliyun ecs --help` |
| 39 | - 查看 API 帮助:`aliyun ecs DescribeInstances --help` |
| 40 | |
| 41 | ### 配置与凭证 |
| 42 | |
| 43 | - 初始化/交互配置:`aliyun configure` |
| 44 | - 指定 AK/SK 非交互配置: |
| 45 | `aliyun configure set --profile <name> --mode AK --access-key-id <ak> --access-key-secret <sk> --region <region-id>` |
| 46 | - 查看当前配置列表:`aliyun configure list` |
| 47 | - 切换配置:`aliyun configure switch --profile <name>` |
| 48 | |
| 49 | ### 高频查询与调用 |
| 50 | |
| 51 | - 查询 ECS 实例: |
| 52 | `aliyun ecs DescribeInstances --RegionId <region-id>` |
| 53 | - 按 JSON 传复杂参数: |
| 54 | `aliyun <product> <api> --SomeJsonParam '[{"key":"value"}]'` |
| 55 | - 仅模拟调用不落资源: |
| 56 | `aliyun <product> <api> --dryrun` |
| 57 | |
| 58 | ### 常用全局选项 |
| 59 | |
| 60 | - 输出过滤/表格化:`--output cols=<...>,rows=<...>` |
| 61 | - 聚合分页结果:`--pager` |
| 62 | - 结果轮询:`--waiter expr='<jmes>' to='<target>' timeout=<sec>` |
| 63 | - 强制调用未收录 API:`--force --version <date>` |
| 64 | - 调试日志:设置 `DEBUG=sdk`(按需配合命令执行) |
| 65 | |
| 66 | ## 检索建议 |
| 67 | |
| 68 | ```bash |
| 69 | # 1) 先在统一索引中收敛章节 |
| 70 | rg "安装|配置|命令结构|参数格式|输出|分页|轮询|故障排查" references/docs_index.md |
| 71 | |
| 72 | # 2) 在目标章节目录下检索关键词 |
| 73 | rg "configure|credentials|proxy|auto-completion" md_mirror/zh/cli/configure-cli |
| 74 | rg "--output|--pager|--waiter|--dryrun|--force" md_mirror/zh/cli/use-cli |
| 75 | rg "install|update|uninstall" md_mirror/zh/cli/installation-guide |
| 76 | |
| 77 | # 3) 若要回到官方入口,通过链接 ID 映射 |
| 78 | rg "CLI_" references/cli-official-links-index.md references/links.md |
| 79 | ``` |
| 80 | |
| 81 | ## 输出要求 |
| 82 | |
| 83 | - 给出 CLI 命令或参数建议时,仅使用本地镜像中已命中的写法。 |
| 84 | - 若用户要“导航/学习路径”,优先返回章节目录与推荐阅读顺序。 |
| 85 | - 若问题过宽,先返回“候选章节 + 选择理由”,再等待用户确认细化范围。 |
| 86 | - 对未覆盖细节,明确标注“当前离线镜像未覆盖到该信息”。 |