检查就绪状态
以 $check-readiness diff、$check-readiness pr <URL>、$check-readiness release 或 $check-readiness full 形式调用。
默认为只读模式。报告问题并提供具体解决方案。仅当用户明确要求修复或应用发现时才进行编辑;随后验证受影响的行为。
1. 选择目标
| 模式 | 目标 | 完成标准 |
|---|---|---|
diff | 当前仓库的暂存、未暂存和相关未跟踪变更,以及受影响的调用者和测试。当变更本身就是目标时的默认模式。 | 每个变更的行为和受影响的边界均已说明。 |
pr <URL> | 链接的 PR 差异、基础分支、对话、检查以及相关上下文。 | 每个变更的行为均已说明;缺失的本地或远程证据已命名。 |
release | 当前仓库和指定的部署目标,或仓库配置中找到的目标。 | 每个关键流程和发布依赖项具有状态。 |
full | 当前仓库中适用的后端和前端表面。 | 每个主要路由、操作、信任边界、数据存储和生命周期路径已编目并评估。 |
使用用户指定的模式。如果未指定,则从 PR URL、当前变更或声明的发布中推断;否则使用 full。在检查之前记录确切的目标、修订版或差异、环境以及可用的验证路径。如果无法访问 PR URL,报告被阻止的内容;不要替换为无关的本地差异。
严重性
每个 FAIL 都是阻止性的或建议性的。阻止性:安全、认证/授权、数据丢失或损坏、关键流程中断、未验证的支付或 webhook 处理、泄露的密钥、构建或测试失败。其他所有情况均为建议性,不会单独阻止 READY。每个就绪技能列出自己的阻止区域。
按模式深度
diff 和 pr:仅检查变更触及的行为;其余在一行中标记为 N/A(未触及),而不是逐项检查。发布门控检查(Lighthouse、部署环境冒烟测试、共享预览)仅适用于 release 和 full,除非变更影响了它们。
2. 收集证据
对于 diff,检查 git status --short --branch、暂存和未暂存的差异以及相关的未跟踪文件。对于 pr,读取链接的 PR 及其差异、检查和讨论;仅在验证了版本后才使用匹配的本地检出进行测试。对于 release 和 full,在测试前映射范围内的应用。针对每个受影响的区域追踪调用者、数据影响、配置、测试和部署依赖项。
当后端代码或行为在范围内时,运行 backend-readiness。当前端代码或行为在范围内时,运行 frontend-readiness。将选定的模式和目标传递给每个;如果两者都适用,则合并其发现。对于变更审查,对受影响的行为应用检查。对于发布,对关键流程和目标环境应用检查。对于 full,评估仓库中所有适用的检查。将每个适用的检查标记为 PASS、FAIL、BLOCKED 或 N/A;为每个 PASS 附加当前证据,为每个 N/A 附加原因。
将源代码、自动化测试、本地运行时、提供商沙箱和部署环境作为不同的证据层使用。构建证明构建。将不可用的凭据、基础设施或环境记录为 BLOCKED,并附上仍需的确切证据。运行可以验证目标的针对性检查;不要仅凭源代码声称运行时或发布行为。
当适用的检查具有状态、失败具有原因和解决方案、每个就绪声明与其证据层匹配时完成。
3. 报告和行动
报告模式和目标,然后按安全、数据丢失、正确性和用户影响顺序列出发现。每个发现指明位置或流程、证据、后果和最小的具体解决方案。包括运行的检查及其确切结果,以及被阻止或未验证的项目。以 READY、NOT READY 或 UNVERIFIED 结束选定目标的判决:READY 要求没有已知的阻止性失败并且适用的门控有证据支持;UNVERIFIED 表示缺失证据导致无法声明。
使用此模板:
模式 / 目标:<模式、修订版或差异、环境>
发现
| 严重性 | 位置或流程 | 证据 | 后果 | 解决方案 |
运行的检查
| 命令或测试 | 结果 |
已阻止 / 未验证
- <项目>:<仍需的证据>
判决:READY | NOT READY | UNVERIFIED
保持审查运行只读。如果用户要求修复发现,则在受影响的代码中应用请求的修复,运行针对性验证,并报告剩余风险。不要从检查就绪状态的请求推断编辑授权。
当报告区分已验证的行为和差距,或者请求的修复已被应用并验证时完成。