code-guard-review-cn

Installation
SKILL.md

代码修改与审查守卫

在代码变更的全生命周期(规划 → 编写 → 审查)中,守住结构质量底线。 规则与语言无关;语言专项知识按需从 references/ 加载。

质量规则

所有规则适用于任何编程语言。背后的理由:小而专注的代码单元更容易阅读、测试和维护,出错时影响面也更小。

# 规则 限制 原因
R0 零编译错误 变更后必须编译/构建通过,零错误零警告 有报错的代码无法运行,其他审查项无意义
R1 单一职责 每个类/函数只承担一项职责 职责混合导致改一处牵动多处
R2 文件体量 ≤ 500 行(推荐 ≤ 300) 超长文件增加认知负担,难以定位
R3 嵌套深度 单函数逻辑嵌套 ≤ 3 层 深嵌套难以跟踪分支,用 guard clause / 提取子函数解决
R4 参数数量 单函数参数 ≤ 5 个 参数过多暗示职责过重,考虑用参数对象或拆分
R5 类型安全 使用语言提供的最严格类型;禁用类型逃逸 TS any、C# dynamic、Java raw type 等会绕过编译检查
R6 类型/泛型体量 类型定义嵌套 ≤ 4 层 超深类型比它保护的代码还难读,应拆为中间别名
R7 DRY 相似逻辑/类型定义不重复 重复导致修改遗漏
Related skills

More from zpqq132555/skills

Installs
2
GitHub Stars
5
First Seen
Apr 13, 2026