用途:用于审查 PR、提交前自查或作为自动化审查提示。使用方式是按清单逐项检查,并可选为发现的问题标注 Blocker、Major、Minor 级别。主要检查项包括:API 设计与稳定性,确认 Sources/ContentstackUtils/ 中新增或变更的 public/open 类型必要、符合 semver 且有文档(用户可见变更需更新 README.md/CHANGELOG.md),除明确理由(如主版本)外不得有破坏性变更,命名需与既有 Utils 和 RTE 术语一致;错误处理与健壮性,新增 throws 路径应使用清晰领域类型(如 VariantUtilityError),区分无效输入与解析失败,公共路径避免强制解包并为非可选参数说明前置条件,RTE JSON 解码与 HTML 遍历需容忍文档化的堆载荷结构并指出嵌入项回归;依赖与安全,Package.swift/ContentstackUtils.podspec 变更需有理由且不引入已知漏洞,需处理 Snyk 等扫描发现的安全问题;测试方面,Sources/ContentstackUtils/ 的新增或修改行为应尽量在 Tests/ContentstackUtilsTests/ 中覆盖,测试需可读、确定性并遵循命名与 mock 约定;内嵌与原生代码如 Kanna/libxml2/Modules/ 需审查上游一致性、许可及 Apple 与 Linux 构建。严重程度示例:Blocker 如未批准的破坏公共 API、安全问题、可测却无测试;Major 如错误不一致、README 示例无法编译;Minor 如风格、少量文档。限制:该技能针对特定 Swift 仓库,具体执行依赖人工或自动化审查流程,未提供价格、平台或效果信息。
code-review
测试与质量
更新于 10-15 20:28