批放行证据包复核
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @baitongai/batch-release-evidence-package-review。
技能介绍
解决什么具体问题
在软件发布流程中,批放行(Batch Release)往往涉及大量证据包。人工核查不仅耗时,且容易遗漏云平台权限校验或密钥管理问题。本技能专门针对这一痛点,提供一套自动化、带鉴权门禁的证据包复核工作流,确保只有授权用户才能拉取并执行复核逻辑。
核心能力与关键步骤
本技能的工作流高度结构化,核心包含三个关键步骤:
- Python 环境静默检测:在执行任何脚本前,必须先静默探测可用的 Python 命令。若检测到命令且版本合规,直接执行后续脚本;若命令为空或版本过低,则按模板报告错误。该设计避免了在未知环境中直接执行导致的崩溃。
- 强制授权与绑定流程:作为受保护能力,技能内置了严格的授权门禁。它优先读取包内元数据获取平台技能编号(
skillCode),并交由scripts/auth.py处理凭证缓存、平台校验与错误信号输出。 - 受保护指令获取与执行:只有授权通过后,技能才会调用
scripts/protected.py拉取云端受保护指令,并严格按照返回内容执行复核。
适用边界与注意点
使用本技能时需注意以下工程约束:
- 互斥原则:鉴权门禁与业务输出是互斥关系。若授权失败,必须立即停止业务推理,严禁静默降级或自行重试,也严禁在鉴权失败时仍产出业务结果。
- 自动修复机制:首次使用导致的凭证缺失属于可自动修复的正常流程。Agent 必须自动发起绑定流程,绝不能因收到
AUTH_REQUIRED信号就中断并向用户报告。 - 错误分类处理:仅当绑定流程已执行但再次授权仍失败,或遇到
AUTH_INVALID、网络错误(如 HTTP 401/403)等真正失败信号时,才需要输出明确的错误报告。注意区分网络异常与权限不足,并按指引向用户提供操作清单。
使用场景
- CI 流水线首次调用批放行复核技能,需自动检测 Python 环境并完成 WorkBuddy 授权绑定。
- Python 版本过低或命令缺失时,Agent 需按模板输出明确错误报告,而不是静默重试。
- 用户提供 Python 全路径后,Agent 用该路径执行授权脚本,成功拉取云端受保护复核指令。
适合人员
- DevOps 工程师,需要一个带鉴权门禁的批放行审查节点来替换人工复核脚本。
- CI/CD 集成工程师,需要在发布流水线中接入受保护技能并处理凭证失效报错。
- Agent 平台管理员,负责审核技能接入流程中环境检测与云端编号映射是否可靠。