SuperAPI AI 工具集

ln-62-repository-publisher

部署与运维

查看项目

更新于 10-16 09:21

技能介绍

用途

Repository Publisher 的目标是:只发布用户已授权的变更,然后从远程来源验证结果。它专注于提交、推送和远程验证仓库改动,明确不用于发布版本、发布软件包或发布公告。

主要能力

该技能以有序检查清单作为完成标准(Definition of Done),要求逐项跟踪状态:PENDING、PROVEN(有具体证据)、CLEARED(有证据表明条件不存在)或 UNPROVEN(存在缺口)。阅读、委托或工具失败都不算证明。

工具路由方面:范围、暂存、历史和同步优先使用原生 Git CLI;仓库验证使用项目原生命令和已安装的验证器;远程分支和 CI 状态使用已认证的托管 CLI 或连接器;干净来源验证使用临时克隆和隔离的主机配置;静态站点验证使用部署工作流加直接 HTTP 请求;当前市场行为参考官方托管文档。

使用方式

检查清单分为几个阶段:

  1. 建立范围与证据:确认用户明确请求提交和推送并确定目标分支;阅读仓库说明、发布规则和分支策略;检查 git status -sb、暂存与未暂存差异、未跟踪文件、远程和近期提交风格;识别无关的用户改动;检查删除和生成文件;确认是否需要同步更新文档;普通发布中不改变版本、标签或发布元数据;市场编辑中确认稳定标识符不变;多主机目录需保持一致性;重复元数据需与规范来源一致。

  2. 验证路由:先发现并运行仓库原生验证命令;对变更的技能、插件或包运行仓库要求或主机原生的验证器;运行所有适用的主机原生严格验证器;只运行仓库和受影响表面所需的目录一致性、清单解析、过期引用、本地链接和空白检查;只运行相关产品测试;在确认必需检查失败时停止提交,除非用户明确接受失败;记录跳过的检查及缺失的依赖或环境。

  3. 同步与提交:提交前获取目标远程并比较本地 HEAD 与远程分支;若落后或分叉,在授权分支工作流内协调;混合工作区时暂存明确路径;暂存后审查缓存差异和 diffstat;排除密钥、本地缓存、临时产物和意外凭据;匹配仓库提交信息约定;保留提交签名和归属策略;创建提交并捕获完整 SHA;推送到授权分支,不改变分支保护或使用强制推送。

  4. 远程验证:通过 Git 或托管 API 在授权远程上验证已发布的提交;跟踪所需 CI 并附直接运行 URL;若静态站点变更,等待部署并用缓存破坏请求验证实时内容;若安装或市场内容变更,克隆到干净临时目录并验证受影响的发布表面;在隔离主机配置中测试至少一个受影响的包或插件;验证已安装产物在预期标识符和版本下可解析;保持临时主机配置与用户活动设置隔离并安全移除;重新检查本地工作树和 HEAD 与已发布提交的一致性。

适用场景

适用于需要将已授权的仓库变更提交并推送到远程,并希望从远程来源验证结果的场景,包括涉及静态站点、安装内容或市场内容的发布验证。

限制

不用于发布版本、标签、软件包发布、讨论或拉取请求,除非明确请求。绝不暴露认证令牌或凭据值。绝不删除远程分支或改变默认分支。遇到分支保护、认证或必需检查时返回 BLOCKED 而非绕过。判定分为 PUBLISHED(提交、推送、所需 CI 和适用的远程验证均成功)、PARTIAL(推送成功但非破坏性远程检查待定或失败)、BLOCKED(因授权、同步、验证或远程访问失败而未完成发布)。输出报告需包含 Result、Scope、Evidence、Verification、Completion 五个字段。