该技能是一份社区代码简化最佳实践指南,供 AI 智能体与 LLM 在简化、清理最近修改的代码时参考。用途包括:降低嵌套、复杂度与重复,改进命名与可读性,应用语言惯用写法,以及审查可维护性问题。
核心原则为:先理解项目约定再改动;只改变写法,不改变行为;只聚焦近期修改的代码,保持较小 diff;清晰优先于简短。
规则按优先级分 8 类:1. 上下文发现(CRITICAL,ctx-,4 条):如简化前先读 CLAUDE.md、检查 lint/格式化配置、沿用既有模式、项目约定优先于通用最佳实践;2. 行为保持(CRITICAL,behave-,6 条):保留返回值与输出、错误信息与类型、公开函数签名、副作用,禁止细微语义变化,提交前验证;3. 范围管理(HIGH,scope-,5 条):仅改近期代码、最小 diff、不做无关重构、不做全局重写、尊重模块边界;4. 控制流简化(HIGH,flow-,9 条):提前返回、守卫子句、禁止嵌套三元、显式优于紧凑、嵌套压平至 2-3 层、单一职责、避免双重否定、可选链与空值合并、简化布尔表达式;5. 命名与清晰(MEDIUM-HIGH,name-,6 条):名称揭示意图、数据用名词动作动词、避免缩写与泛化名、词汇一致、优先字符串插值;6. 减少重复(MEDIUM,dup-,5 条):三次法则、避免一次性辅助函数、仅在提升清晰度时提取、避免过度抽象、数据驱动模式;7. 死代码清理(MEDIUM,dead-,5 条):删除未用代码、删除而非注释、去掉显而易见注释、保留解释“为什么”的注释、清理陈旧 TODO/FIXME;8. 语言惯用法(LOW-MEDIUM,idiom-,7 条):TypeScript 严格类型与 const 断言、Rust 的 ? 传播与迭代器链、Python 推导式、Go 立即错误处理、优先语言与标准库内置。
使用方式:按优先级顺序应用规则,先做 CRITICAL 类;查参考文件 references/_sections.md(分类定义与顺序)和 assets/templates/_template.md(新规则模板),metadata.json 含版本与参考信息。限制:该指南针对近期修改的代码,默认不鼓励大范围重构;具体平台、收费与集成方式暂未提供。