AgentSkillsCN

skill-clean-code

遵循Clean Code核心准则,提升代码的可读性、可维护性与可预测性。在强制执行命名规范、条件语句、常量定义与注释时使用。

SKILL.md
--- frontmatter
name: skill-clean-code
description: Clean Code core rules for readability, maintainability, and predictability. Use when enforcing naming, conditionals, constants, and comments.

Clean Code Core

Goals

  • Readability
  • Maintainability
  • Predictability
  • Confidence

Rules

  • English semantic naming, no abbreviations.
  • Booleans: is/has/can/should/does.
  • Cause over effect naming.
  • No magic numbers (named constants).
  • Prefer guard clauses and flat control flow.
  • Comments explain WHY, not WHAT.
  • Short iterations: implement -> test -> refactor -> review.