SuperAPI AI 工具集

preprod-review

部署与运维

查看项目

更新于 10-29 18:03

技能介绍

用途

preprod-review 用于在扩大变更影响面之前进行发布前审查。典型触发场景包括:切发布或打版本标签、把库/模板/工作流提升为团队或公司默认、将变更推广到 N 个下游仓库、难以回滚的部署或基础设施变更、交付给无法查看内部实现的采用者。普通 PR 或在研分支的常规审查不在其范围内,那是 /code-review 的职责。

主要能力

该技能把审查拆成五个相互独立、只读的视角并行执行:安全(security-auditor,判断型/opus)、正确性(code-reviewer,判断型/opus)、文档(preprod-review-lens,一致性检查/sonnet)、可移植性(preprod-review-lens,部署与环境扫查/sonnet)、治理(preprod-review-lens,跨文档完整性/sonnet)。分发时需显式传入模型层级,否则三个 sonnet 行会因 agent 的 model: inherit 而失效。三个 agent 均通过 frontmatter 限定为只读(tools: Read, Grep, Glob);若当前环境中缺少所列 agent 类型,可回退到 Agent 工具并显式指定对应模型层级,但需在综合阶段说明只读约束是“视为遵守”而非强制,且不得用 documentation-specialist 或 cloud-devops-expert 等写作型 persona 替代专用审查视角。

每个视角读取随技能提供的 references/lens-briefs.md 中固定简报,不另行撰写简报;分发提示仅三行:声明视角编号与名称、读取简报绝对路径、给出制品、目标与文件清单。分发前必须展开 <ABSOLUTE-PATH-TO-THIS-SKILL> 实际路径(本仓库中为 .agents/skills/preprod-review/),否则子代理无法读到简报而会自行发挥,引入变异。仅当制品确有特殊需要时才偏离已提供简报,并在综合阶段说明。

领域检查清单目前仅随仓库提供一份:references/github-actions-review.md 对应 GitHub Actions 工作流;其他制品类型暂无清单,视角按通用清单审查并在报告中注明不存在领域清单。不得在运行中途临时编造清单并冒充已提供内容。

使用方式

  1. 先内联确定审查范围:列出所有需覆盖的文件,并亲自阅读其中 2–3 个权限最高或最关键的文件,以便后续抽查发现。范围因制品类型而异,通常包括入口点、其信任的对象以及采用者会阅读的表面(如 CI/工作流中的 .github/workflows/*.yml、安装或分发模板、被调用脚本、采用者文档;库/服务的公开 API、配置与默认值、迁移步骤、发布或部署脚本;基础设施的变更资源、IAM/权限边界、状态与回滚路径;以及治理表面如 CHANGELOG/ROADMAP/决策日志/交接文档)。
  2. 一次性并行分发五个视角,每个获得限定范围的任务并返回排序报告;同一轮完成可避免相互继承框架。
  3. 内联综合与验证:跨五份报告去重(按文件+符号而非措辞),对每个 BLOCKER 和 HIGH 打开引用的 file:line 确认真实存在;无法复现的发现应删除或标为 PLAUSIBLE 并说明确认条件;按可利用性/影响排序。
  4. 输出一份排序结论:BLOCKER(不可发布)、SHIP-WITH-FIXES(可修复并逐项列出)或 READY。先给结论,再给排序发现,最后列出不应回退的强正面项。
  5. 推广存留发现:由编排者负责,对照 submit-feedback 的晋升门槛(先搜索、正文契约、安全发布)提交符合条件的 BLOCKER 和 HIGH,并在结论中回链 issue 编号。

适用场景

适用于发版/打标签、提升为默认、推广到多个下游仓库、难以回滚的部署或基础设施变更、交付不可见内部实现的制品等发布决策。若审查发现将转为修复计划,应交给计划编写工作流(如有 verified-planning),保持审查与计划为两个独立制品。

限制

审查视角只读,最终结论依赖对引用行的复核;子代理可能虚构问题或误述真实代码,必需人工核实。领域检查清单目前仅覆盖 GitHub Actions,其他制品无随附清单。回退分发方式会失去 frontmatter 的只读保证。该技能面向发布决策,不替代普通 PR 审查。