AI 写代码越来越快，但品味跟不上？这个 Skill 专治”能跑但不好看”

你用 AI 写代码有一段时间了，有没有这种感觉：代码跑得通，但回看的时候总觉得哪里不对劲——变量名随意、分层混乱、明明可以复用的地方硬抄了一遍……

问题不在 AI，在于没人教它「什么叫好代码」。

今天挖到一个 Skill，正好填这个坑——clean-code-principles，专门用来给 AI 编程习惯做质量审查。

这个 Skill 解决什么问题

很多团队上了 AI 编程工具之后，代码产量上去了，但代码债也跟着堆起来了。AI 写代码快是快，但它不会自发遵循 SOLID、DRY、KISS 这类工程原则——除非你明确告诉它怎么判断。

clean-code-principles 就是这个「判断标准」。它把代码质量分成 6 个维度，每个维度对应具体规则，AI 每次写完代码你都可以让它对照检查：

• SOLID 原则（10 条规则）：单一职责、开闭原则、里氏替换、接口隔离、依赖反转
• DRY / KISS / YAGNI（各 2 条）：别重复、别过度设计、不提前假设
• 代码可读性：命名规范、注释质量、函数大小、参数数量
• 架构分层：Repository 模式、Feature Folders、模块边界
• 设计模式：什么场景该用什么模式

它会给出具体的 CLEAN / SUSPICIOUS / INFLATED / CRITICAL 四级判定，直接告诉你哪一行有什么问题、违反了什么规则。

实际用起来什么感觉

触发方式很自然，你不需要记住特定命令，用人话就行：

• 「Review 这段代码质量」
• 「Check SOLID principles」
• 「Find sloppy patterns in app/Services/」

比如你让它 review 一个 Laravel Service 文件，它会指出：
– 哪个函数违反了单一职责（一个函数干了三件事）
– 哪个类对接口的依赖违反了 DIP
– 哪里可以抽象但没有抽象

直接给出 file:line - [rule-id] Description of issue 格式的审计结果，粘贴到 PR 里当评论都行。

为什么值得装

GitHub 上这个 repo 有 86 颗星，整个 agent-skills 集合覆盖 Laravel、React、TypeScript、测试、安全等多个方向，clean-code-principles 是其中一个子 Skill。

安装方式也很简单：

npx skills add AsyrafHussin/agent-skills --skill clean-code-principles

装完直接用，不需要配置，不用 API Key，一个 SKILL.md 文件就是全部。

如果你团队在用 Laravel + React/TypeScript，这个 Skill 特别适合作为 Code Review 前的第一道自动检查——在 AI 层面就把代码品味拉齐，比等人工 review 再打回重写效率高得多。

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

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