用途:在实现前审查技术提案,找出可能让提案错误、不安全或无法证明的设计选择。适用于系统架构、功能规格、RFC、ADR 以及定义系统变更方式的问题。审查对象是提案的行为与权衡,而非文档篇幅或格式。
主要能力:要求使用一个未参与撰写提案的全新子代理进行独立审查,并向其提供完整上下文,要求其直接工作、不得再委派,且保持只读。若无法使用全新子代理,应停止并报告独立审查受阻;只有用户明确接受有记录的自审时才继续。审查过程包括:阅读目标、提案、需求、预期架构、仓库说明、相关现有代码、测试、模式、配置和链接材料;在代码、测试、模式、配置、基础设施或运行时证据支持前,将关于当前系统的声明视为未验证;说明问题、受影响用户、预期结果、成功度量、范围、约束和主要权衡;追踪一个真实案例从输入到可观察结果,涵盖归属、验证、状态变更、副作用、响应时机、失败、重试、清理及用户可见内容;用审查重点挑战所选设计,寻找以更少状态、耦合、重复或运维工作达到相同结果与证明的更简单选择;提出实质性开放问题,并在证据支持时给出建议答案。
审查重点:与需求和已接受架构的契合度;归属、边界、接口、数据、兼容性、迁移、发布和回滚;部分失败、重试、取消、并发、启动、关闭和恢复;声称的规模、有限资源、延迟、吞吐量、存储、成本、依赖失败和运维恢复;身份、授权、不可信输入、凭据、破坏性权限和敏感数据处理;要求重要规则和失败路径具备可观察的验收标准与证明。
开放问题:仅当两个有能力的实现会以影响用户、数据、接口、安全、规模、性能、运维、成本、兼容性或证明的方式给出不同答案时才报告。分为阻塞(未回答不应开始实现)和重要(提案应记录答案,审查者可基于现有证据推荐安全默认值)。省略风格性、可安全留在实现内、超出范围或超出提案声称规模的问题。
发现:只报告能改变设计或其安全性的缺陷。阻塞:选择不安全、与目标或当前系统矛盾,或无法从重要失败中恢复。重要:提案允许实质不同的实现,或在行为、规模、性能、安全、运维、兼容性或证明上留下有意义风险。每项发现或开放问题需包含位置、具体失败或歧义、影响、证据,以及最小修正或建议答案。
结论:批准(无阻塞或重要发现或开放问题)、请求更改(存在可修复的阻塞或重要发现或开放问题)、受阻(审查缺少所需上下文、仓库证据、专家覆盖或独立审查者)。需说明仍未验证的内容,不得因文档详细或模板齐全而批准。
限制:该技能不重写提案、不规划工作、不审查实现代码、不实施更改。若缺少独立审查者或必要上下文,审查应标记为受阻。资料未提供具体安装命令、收费或平台信息。