用途:这是一套通用的代码质量规则技能,定位为“每个项目都应包含的基础技能”,在编写或审查任意代码时提供统一规范。主要能力围绕代码质量原则与规则展开:遵循 KISS,优先选择能解决问题的最简方案;遵循 DRY,在出现三处重复时才做提取,而非提前抽象;坚持单一职责,每个模块或函数只做一件事;使用描述性强、能表达意图的命名;文件与文件夹使用 kebab-case;函数应有清晰的输入输出并尽量减少副作用;保持函数规模适中,当逻辑需要靠注释解释时就应提取;删除死代码而不是注释掉;绝不静默吞掉错误;优化前先测量,不做过早的性能优化;不做过早抽象,等待三处具体重复后再提取。使用方式:该技能按描述中的触发条件与领域关键词被选中,随后依据其中的工作流程与规则产出可操作的结果,并以显式约束校验输出质量,若仍有缺口则带着明确假设再精炼一次。适用场景:代码审查并消除重复且保持行为不变,或在日常编写代码时作为质量基线。限制与注意事项:资料未提供具体语言、平台或价格信息;若未被触发,可改用描述中的明确领域与任务关键词重新表述;当多个技能指示冲突时,应声明当前步骤以哪个技能为准;若输出过于泛泛,通常是输入缺少环境、范围、格式或成功标准等约束,补充后重试即可。规则索引中提及的详细模式,资料未展开说明。
core-coding-standards
编程与开发
更新于 10-16 01:08