name: 代码完整性检查 description: 防止完成任务时走捷径和作弊。阻止包含警告抑制、注释掉的测试或删除断言的提交。
代码完整性检查
Git预提交钩子,用于阻止包含完整性违规的提交。
安装
bash "${CLAUDE_PLUGIN_ROOT}/scripts/install-git-hook.sh"
检查内容
| 模式 | 为什么不好 |
|---|---|
警告抑制(#pragma warning disable、eslint-disable) |
隐藏问题而不是修复它们 |
| 注释掉的测试 | 测试存在是有原因的 |
| 删除的断言(>2个) | 移除检查并不能修复错误 |
| 测试文件删除 | 不要删除测试来让它们“通过” |
| 空的catch块 | 吞掉错误会隐藏故障 |
| 新增的TODO(每次提交>2个) | 明确推迟工作,而不是通过注释 |
手动检查
bash "${CLAUDE_PLUGIN_ROOT}/scripts/integrity-check.sh"
误报处理
有时抑制是合理的。如果被阻止:
- 在提交消息中解释为什么需要抑制
- 解释应该能说服审阅者
- 如果无法解释,请修复根本问题
失败条件
以下情况视为失败:
- 提交包含完整性违规的代码
- 声称“完成!”但没有运行实际验证
- 抑制警告而不是修复它们
- 删除或注释掉测试而不是修复它们
- 合理化为什么这些规则不适用于你