变更规模审查指南
帮助开发者控制代码变更规模并规划可审查的分阶段交付。
该技能仅提供变更规模建议,不声明权限、外部数据流、依赖或破坏性操作,风险面较低;但未定义用户确认、敏感数据处理、回滚或具体归因流程,因此扣除8分。
规则简短且内部一致,明确了普通变更800行、复杂逻辑500行及超限时的拆分要求;但未说明无差异、无法识别依赖或调用点、机械变更边界及异常输入时的反馈,因此扣除12分。
目标场景是代码评审中的变更规模控制,核心触发条件较清楚;但技能元数据和正文未充分声明非适用范围、输入输出格式、触发语义或中文使用方式,因此扣除7分。
信息结构清晰,仓库提供Apache-2.0许可证和官方来源;但技能缺少安装说明、示例、参数定义、已知限制、版本、变更记录、维护责任和更新路径,因此扣除9分。
可直接帮助评审者判断是否需要拆分大型变更,并要求结合实际差异、依赖和调用点;但没有规定可直接交付的输出模板或验证步骤,且规模阈值的适用性证据有限,因此扣除9分。
技能文件本身可审计,规则和判定条件可追溯;但未提供测试、示例结果、CI覆盖或第三方复现证据,静态审查下只能给予有限分数,因此扣除7分。
- 这是仅基于源文件的低置信度静态评估,未执行技能或独立验证其效果。
- 800行和500行阈值未给出适用依据,不能替代对风险、依赖、调用点和审查能力的实际判断。
- 技能没有规定标准化输出格式;超限时的拆分建议可能不一致。
它能做什么 & 适用场景
该技能为代码审查提供变更规模指导。除机械性变更外,建议总变更行数不超过800行;复杂逻辑变更应控制在500行以内。超出限制时,它会根据实际差异、依赖关系和受影响的调用点,判断是否可以拆分为多个审查阶段。它适合希望提高代码审查可读性和交付可控性的开发团队。
检查代码变更的总行数,并将其与800行的一般上限和500行的复杂逻辑上限进行比较。对于超出规模的变更,分析实际差异、相关依赖和受影响的调用点,说明是否可以拆分,并指出最小的连贯首阶段。
- 开发者提交大型非机械性变更前,需要判断其是否超出适合审查的规模。
- 审查者面对复杂逻辑改动时,需要依据500行指导评估风险。
- 团队准备拆分大型提交时,需要确定最小且连贯的第一阶段。
- 维护者希望根据依赖关系和调用点规划更易审查的交付顺序。
优缺点一览
- 提供明确的800行和500行规模阈值。
- 要求分阶段建议基于实际差异、依赖关系和调用点。
- 范围聚焦于代码审查中的变更规模控制。
- 未定义如何精确计算变更行数。
- 未提供测试套件、自动化检查或具体集成命令。
- 未说明单独安装或触发该技能的方法。
如何安装
该仓库是包含20个技能的集合,README未提供单独安装此技能的步骤。安装整个 Codex CLI 可在 macOS 或 Linux 运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh,Windows 运行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex",或使用 npm install -g @openai/codex、brew install --cask codex。
如何使用
在已安装并运行 Codex CLI 的代码审查场景中调用此技能。让 Codex 评估实际变更规模;如果超过限制,要求它依据差异、依赖关系和受影响调用点提出可审查的分阶段方案。README和SKILL.md未提供特定触发命令或示例提示词。