让 AI 写的代码也经得起review:SOLID原则+23条代码整洁规则一次配齐

你有没有这种感觉——AI 生成的代码,当时跑通了,回头再看满脑子问号?

函数巨长、类名不知所云、一个文件塞了 800 行……AI 写代码快是快,但代码质量这事儿它不太 care。毕竟它只管「能跑」,不管「能维护」。

这个 Skill 就是来补这个短板的。

clean-code-principles 是一套给 AI 编码 Agent 用的代码整洁原则库。不是什么花哨的框架,就是把软件行业几十年沉淀下来的黄金法则——SOLID、DRY、KISS、YAGNI、设计模式——整理成 23 条可执行的规则,让 AI 在写代码的第一时间就能对齐专业标准。

它把规则分了优先级:
– CRITICAL:SOLID 五原则 + 核心原则(DRY、KISS、YAGNI 等)
– HIGH:设计模式(Repository 等)
– MEDIUM:代码组织、命名规范
– LOW:函数规范、文档

每一类都有「反面示例 → 正面示例」的对比,TypeScript 代码直接可抄。

触发方式也很自然,说「review architecture」「check SOLID principles」「refactoring advice」「code smells」它就会自动激活。

适用场景:
– 架构评审:让 AI 对照规则打分,不合格直接给修复建议
– 重构现有代码:它会标出哪些地方违反了哪条原则,精确到文件和行号
– 制定团队代码规范:可以直接基于它的规则库做团队内审标准
– 教学场景:新手也能通过 AI 的评审反馈学会识别代码坏味道

这个 Skill 语言无关,TypeScript、Python、PHP、Go 都能用。规则是抽象的,例子是 TypeScript,但迁移到其他语言完全没门槛。

来自 AsyrafHussin/agent-skills 这个仓库,GitHub 72 stars,目前约 1.2k 次安装,支持 Claude Code、Cursor、Cline、Codex 等 40+ 主流 AI 编码 Agent。

GitHub:
https://github.com/AsyrafHussin/agent-skills


GitHub: https://github.com/AsyrafHussin/agent-skills

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 168 阅读