SuperAPI AI 工具集

ci-maintenance

部署与运维

查看项目

更新于 10-15 21:37

技能介绍

用途:在编写或审查 GitHub Actions 工作流与复合操作时,审计信任边界,确保事件、权限、操作引用、制品、setup 等环节安全可控。

主要能力:负责 Actions 事件语义、工作流安全、权限、操作固定(pinning)、setup 复用、不可信输入、超时、并发以及制品信任边界。

使用方式:先判断是审查还是实现。审查只产出有证据的发现,不做编辑;实现则沿最小边界保持改动推进。检查每个受影响的工作流、复合操作和调用方,列出所有受影响 job 与 action。对每个 job 记录触发条件、actor/fork 状态、工作流版本、检出修订、权限、凭据以及所有外部输入与消费方,包括制品、缓存、输出、PR 字段、refs、dispatch 输入、生成文件和被调用 action。对每个平台敏感决策查阅当前 GitHub 文档;仓库示例只代表本地约定,不代表平台语义。

适用规则:默认工作流权限置空,仅授予 job 最小权限;复用仓库共享 setup action,除非环境必须不同;为可执行 job 设置有意为之的矩阵和现实超时;将外部 action 与可复用工作流固定到完整 commit SHA 并附可读发布注释,验证 SHA 属于该上游发布;联合分析事件选择、检出修订与凭据持久化;不可信表达式经环境变量传递,使用前验证并引用;根据中断安全性推导并发;涉及 fork、特权凭据、发布或跨运行数据时,阅读 privileged-workflows.md。

验证:运行最窄的语法与仓库检查,检查完整 diff,识别只能在 GitHub 托管 runner 上测试的行为。本地模式参考当前共享 setup action 与同信任边界最近的工作流;常规先例用普通检查工作流,特权发布工作流仅用于等价信任边界。

完成标准:每个受影响 job 与调用方都有记录的信任边界,每条适用规则都有证据或补偿控制,本地检查通过,并识别出仅 GitHub 可验证项。审查报告每个失败并附证据;实现解决每个失败且只包含预期行为。

限制:资料未提供具体命令、安装方式、收费或平台支持范围。