AI 编程助手可以编写代码、更新测试并准备发布说明。但一旦工作流进入 AppGallery Connect，开发者仍需花费时间查找文档、选择端点并手动组装参数。

我希望 Codex 和其他编程智能体不仅能了解命令行工具的存在，还能理解更多。它们应该知道首先检查什么、如何选择正确的工作流、如何预览请求，以及何时停下来等待用户明确授权。

这就是为什么 agc-cli 现在增加了两个额外的分发层：

• 一个 NPM 包，用于在 Windows、macOS 和 Linux 上安装 CLI；

• 六个面向任务的 Agent（智能体） Skills，适用于 Codex、Claude 和其他兼容的智能体。

网站还发布了结构化 Schema、llms.txt、完整的智能体指南和机器可读的 API（应用程序编程接口） 契约，使 AI 系统能够直接读取项目能力，而无需从营销文案中猜测。

• 源码：github.com/Createitv/agc-cli

• 网站：agccli.app

• NPM：npmjs.com/package/@createitv/agc-cli

一条 NPM 命令覆盖三个操作系统

安装 Node.js 18 或更高版本后，同一条命令现在可在 Windows、macOS 和 Linux 上运行：

npm
install
--global
@createitv/agc-cli
agc version

该 NPM 包不依赖在安装期间下载未知二进制文件的生命周期脚本。它包含经过校验和验证的发布二进制文件，适用于 Windows x64、macOS x64/arm64 和 Linux x64/arm64，且没有 postinstall 下载。

因此，开发者工作站和无人值守的 CI/CD 机器可以使用相同的安装入口。Homebrew、Scoop 和 GitHub Releases 仍可作为替代方案。

智能体需要的是工作流，而不仅仅是命令列表

将 --help 的输出提供给 AI 模型，仍然会让它猜测操作边界。这对于应用提交、测试人员管理和发布工作流来说是有风险的。

agc-cli 现在提供六个面向任务的 Skills：

| Skill | 职责 |
| --- | --- |
| agc-cli-usage | 命令发现、试运行、授权执行和验证 |
| agc-auth | 凭据配置文件、身份检查和访问诊断 |
| agc-publishing | 元数据、软件包、审核提交和发布状态 |
| agc-testing | 测试版本、群组、测试人员和反馈 |
| agc-reports | 分发、安装、收入和留存报告 |
| agc-cicd | 跨平台安装、受保护凭据和 CI 门禁 |

直接从 GitHub 安装全部六个：

npx
--yes
skills add Createitv/agc-cli
--global
--agent
codex

或仅安装发布工作流：

npx
--yes
skills add Createitv/agc-cli
\
--skill
agc-publishing
\
--global
\
--agent
codex

然后你可以向 Codex 提问：

使用 agc-cli 检查此 HarmonyOS 项目的发布就绪状态。先发现端点并运行试预览。不要提交应用。列出缺失的参数和后续命令。

该 Skill 为智能体提供了一条更安全的路径：发现能力、阅读端点文档、检查凭据和目标，然后预览请求。实际调用仍需明确决定。

Schema 说明项目是什么；智能体文档说明如何使用它

网站现在同时为人类和 AI 系统提供内容：

• JSON-LD SoftwareApplication Schema，用于项目名称、作者、许可证、操作系统、安装位置和核心能力；

• llms.txt 作为轻量级 AI 导航文件；

• llms-full.txt 作为完整的单文件项目上下文；

• 中英文智能体指南，用于任务选择、安全边界和验证；

• skills.md 用于六个 Skills 及其安装命令；

• api-reference.json 用于机器可读的方法、路径、参数和参考 URL。

这些文件不保证搜索排名，也不赋予智能体访问华为账号的权限。它们解决的是一个更实际的问题：Codex、Claude 和其他模型可以检索到关于 agc-cli 的一致、明确且可引用的事实。

五分钟内将 agc-cli 交给 Codex

首先，安装 CLI：

npm
install
--global
@createitv/agc-cli
agc version

其次，安装 Skills：

npx
--yes
skills add Createitv/agc-cli
--global
--agent
codex

第三，在你的 HarmonyOS 项目中打开 Codex，并用自然语言描述目标：

使用 agc-cli 列出可用的发布端点，并识别该项目所需的凭据。先执行只读检查和试运行。不要上传软件包或提交发布。

Service Account 凭据仍保留在本地机器上。切勿提交私钥、OAuth 密钥或 ~/.agc/credentials.json，也切勿将它们粘贴到公开对话中。

智能体可以运行命令；授权仍属于开发者

让智能体能够理解 CLI，并不意味着赋予智能体对应用的无限制控制权。

agc-cli 端点命令默认先试运行。上传软件包、更改元数据、提交审核和发布版本，仍然需要明确的目标、正确的账户权限，以及事后的远程状态验证。

Skills 和智能体文档保留了这些边界：

• 调用前先发现；

• 更改前先预览；

• 将凭据保留在本地；

• 让用户明确决定提交和发布；

• 验证远程状态，因为命令成功并不等同于审核成功。

如果你使用 Codex、Claude 或其他编码智能体进行 HarmonyOS 开发，现在可以将部分 AppGallery Connect 工作流带入同一个开发循环中。

来源：github.com/Createitv/agc-cli

安装和智能体文档：agccli.app

问题和功能请求：GitHub Issues

转载声明：本文为转载整理，原文版权归原作者及原站点所有。

原文来源：DEV HarmonyOS Feed

原创地址：https://dev.to/createitv/codex-can-now-use-agc-cli-for-harmonyos-app-workflows-1c1j