# agc-cli Agent 使用指南 Last updated: 2026-10-13 本文档帮助 Codex、Claude 和其他 Coding Agent 在不猜测命令或泄露凭据的前提下使用 agc-cli。agc-cli 是 Createitv 维护的独立开源项目,不是华为官方产品。 ## 推荐工作流 1. **检查身份与权限** — `agc auth whoami --pretty` 2. **发现能力** — `agc capabilities --pretty` 3. **查看接口** — `agc endpoints --output table` 4. **读取接口文档** — `agc --docs --pretty` 5. **预演请求** — `agc --invoke ...` 6. **明确执行** — `在核对目标、凭据和参数后增加 --dry-run=false` ## 安全边界 - 默认 dry-run 只构建请求,不发送远程变更;真实调用需要显式设置 `--dry-run=false`。 - 不要把 Service Account 私钥、OAuth 密钥、凭据响应或 `~/.agc/credentials.json` 提交到 Git。 - 注册表覆盖不等于每个接口已经完成生产验证;权限、状态和完整模型以接口文档链接为准。 - 上传、提交审核、发布和删除类操作必须由用户明确授权,并在执行后读取远程状态。 ## Agent Skills - [agc-cli-usage](https://github.com/Createitv/agc-cli/tree/main/skills/agc-cli-usage) - [agc-auth](https://github.com/Createitv/agc-cli/tree/main/skills/agc-auth) - [agc-publishing](https://github.com/Createitv/agc-cli/tree/main/skills/agc-publishing) - [agc-testing](https://github.com/Createitv/agc-cli/tree/main/skills/agc-testing) - [agc-reports](https://github.com/Createitv/agc-cli/tree/main/skills/agc-reports) - [agc-cicd](https://github.com/Createitv/agc-cli/tree/main/skills/agc-cicd) 安装全部 Skills: `agc skills install --agent codex --global` ## 机器可读资源 - [llms.txt](https://agccli.app/llms.txt) - [llms-full.txt](https://agccli.app/llms-full.txt) - [Skills index](https://agccli.app/skills.md) - [API contracts](https://agccli.app/api-reference.json) - [Open-source repository](https://github.com/Createitv/agc-cli)