用途:在技能启用期间,对任何被编写、修改或评审的代码施加强制性的工程标准,语言无关,需遵循目标语言的习惯用法。当速度与整洁冲突时,除非存在明确的运维紧急情况,否则选择整洁方案。
主要能力与规则:每次改动至少要改善可读性、命名、简洁性、内聚性、可测试性、错误处理、去重或关注点分离之一,不添加仅“能用”的代码;为读者优化,优先直白而非炫技;命名须揭示意图并使用领域语言,避免 data、info、thing、manager、helper、util 等泛称,布尔名如 isActive、hasItems,集合名用复数,函数名描述动作。方法要小且单一职责、单一抽象层级,参数尽量零到二个。区分抽象层级,业务逻辑与 I/O、框架胶水、序列化分离。副作用必须显式,避免既回答问题又执行动作的方法。条件控制上优先卫语句、减少嵌套、抽取复杂谓词。错误即设计:对无效假设快速失败,不静默吞掉错误,提供诊断上下文。保持模块与类高内聚、公共接口小,优先组合而非继承。在正确语义层级去重,避免为合并表面相似代码而制造过早抽象。默认测试先行(TDD),测试行为而非实现细节,测试须可读、确定、顺序无关并按预期结果命名,修复缺陷前尽量补充回归覆盖;若严格测试先行确实受阻需明确说明并立即补上最接近的有效覆盖。边改边重构,保持测试通过。使用目标语言惯用法但不得隐藏意图,避免元编程与魔法,把外部系统隔离在清晰边界后。
完成定义:实现正确、设计可理解且命名清晰、被触及的代码比之前更整洁、相关测试存在并通过、改动区域无明显重复或死代码。
使用方式与参考:需要解释某条规则或面对非显而易见的设计决策时,阅读 reference.md 获取详细理由、示例与设计启发式。具体安装命令、支持的平台及收费方式等信息暂未提供。