用途:release-publish 用于指导智能体完成软件发布与包发布流程,包括准备发布、发布包、提升版本、配置公开仓库元数据,以及验证已发布的包。
主要能力与要求: 公开仓库元数据:必须设置 GitHub 的 Description、Topics、Homepage 字段。公开仓库必须包含 .github/workflows/ci.yml、issue 模板、PR 模板、SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md 和 CHANGELOG.md。CI 必须运行仓库标准的 lint、test、build 命令。
版本与发布流程:发布内容变化时必须更新版本元数据,并保持包版本与 Git 标签一致。被要求选择版本时须自行决定。提升版本时须在同一次更新中创建 GitHub Release 并发布包。对于 metyatech 拥有的 npm 包,须直接执行 npm publish(已配置自动化令牌);其他包须请用户运行 npm publish。发布前须运行必要准备命令(npm install、npm test、npm pack --dry-run 等),仅在就绪时继续。发布中认证失败须请用户完成发布步骤。发布前须运行依赖安全检查,处理严重问题并报告结果。
发布后验证:发布后须将本地已安装副本更新到新发布版本并验证解析版本,未完成验证不得报告完成(除非用户明确拒绝)。验证以明确验收标准与证据表达:AC1 注册表验证已发布版本存在(如 npm view <pkg> version);AC2 全新安装验证最新包可解析并运行(如 npx <pkg>@latest --version);AC3 全局更新(如适用)更新全局安装并验证(如 npm ls -g <pkg> --depth=0、npm i -g <pkg>@latest,然后 <cmd> --version),不适用时标记 N/A 并说明原因。
标准仓库主题:须从标准集合分配主题,每个仓库在适用时至少有一个标准主题;不匹配任何标准主题的仓库须使用与其领域相关的描述性主题。标准主题包括 agent-skill、agent-tool、agent-rule、unreal-engine、qti、education、docusaurus。可自由添加语言、框架、领域关键词等描述性主题。仓库格局发生重大变化时须审查更新标准主题集,并在新仓库合规检查中验证主题已设置。
发布产物要求:须填充包元数据(name、description、repository、issues、homepage、engines);须验证可执行入口点和必要 shebang,确保安装后的命令可用;若仓库代表单一工具或产品,须发布单一包(打包相关脚本)。
限制:资料未提供具体价格、平台支持范围或效果数据;部分命令与流程依赖 npm 生态,其他生态仅提及“等效方式”。