用途:审查 PR 新增或修改的公共 CDK 接口的设计质量,判断其抽象层次是否恰当、是否符合 CDK 设计指南、是否清晰且不易埋坑,使其长期可维护。只审查本次改动涉及的 prop、方法、属性、接口、枚举或 L2,不评判 diff 未触及的既有设计。
主要能力:按 Feature placement、Abstraction/L1 leak、Conformance、Footgun/ages-well 四类逐项检查改动面,既看已存在且违规之处,也看该类型接口应提供却缺失的能力;缺失能力与已声明缺陷同等对待。审查前需查阅权威 AWS 服务与 CloudFormation 文档,确认属性、模式或默认值真实存在,并确认 CDK 框架是否已自动接线,避免误报。
使用方式:先列出 diff 新增或修改的公共 API 并判定其类型(grantable、stateful、connectable、attribute-bearing),再阅读 design-rules.md 作为检查清单,逐族核对改动面,按危害程度评级,找到缺陷并引用规则(文件+章节)及具体修复方案后停止。输出使用 cdk-review-principles 定义的结构化字段,message 为完整评论,类别取 Feature placement & abstraction、Design Guidelines conformance、Clarity/simplicity/consistency、Footgun-free & ages-well interface quality 之一。
限制:不负责正确性缺陷(缺失实现、逻辑错误、路径损坏)、回归风险(既有 API 破坏性变更)、安全暴露(过宽 IAM、公开资源、泄露密钥)以及测试与文档文字质量;仅保留“新 L2 是否有 README 使用示例”这一设计信号。严重度沿用 cdk-review-principles 的 BLOCKING/RECOMMENDED/OPTIONAL 标准,不在此重新定义。