这是一个面向 App-Store-Connect-CLI 的开发技能,用途是在该 CLI 中设计、实现并验证行为变更,例如新增或修改命令、标志、API 端点、输出格式、退出码等。它要求遵循 AGENTS.md 中的权威规范、CLI 契约、实现不变量、验证与评审门禁。
主要流程:先写设计说明,小修复记录复现的失败、预期行为和聚焦检查;新公开行为还需记录命令分类与注册表位置、当前 --help 行为与调用形态、涉及的 OpenAPI 端点/方法/请求模式/查询参数/响应结构、标志、输出格式、stdout/stderr 行为与退出码、兼容性/生命周期/迁移/弃用影响、RED-GREEN 测试与黑盒检查、边界与失败模式,以及重大权衡下的替代方案。
随后建立 RED:缺陷先复现并加最小回归测试;功能从 CLI 层可观察契约覆盖开始;行为重构先补缺失覆盖再动代码;运行聚焦测试并记录预期失败。参考 references/test-matrix.md 选取适用的 CLI、输出、产物与鉴权用例,避免重复已有解析器/渲染器测试。
验证 API 支持时,先查 docs/openapi/paths.txt,再核对 docs/openapi/latest.json 中具体操作,并应用 AGENTS.md 的端点模式检查;API 不支持时应显式实现客户端行为或记录限制,不发布误导性标志。实现要聚焦,用法错误返回退出码 2。达到 GREEN 后重跑失败测试、相邻包与命令测试,在工作树专属路径构建二进制并验证真实调用、输出流和退出码,不要与并发任务共用固定 /tmp/asc 路径。依赖 App Store Connect 特性时做最小在线冒烟测试,优先只读调用。验证门禁包括帮助变更时的命令文档生成;公开 CLI 行为、共享代码、发布面及重要缺陷或安全修复需完整门禁。交付前将分支头与当前 main 只读比较,按 AGENTS.md 分支更新规则处理。
限制:资料未提供具体价格、平台支持范围或完整命令示例;实际执行须以仓库内 AGENTS.md 和参考文件为准。