让 AI 写代码不再野路子:这个架构 Skill 逼它遵循 Clean Architecture

用 Claude Code 写代码最怕什么?AI 给你吐出来一团 utils.js,塞了 300 行乱七八糟的函数,命名全是 handleData、processInfo 这种鬼东西。

不是 AI 不够聪明,是你没给它装”架构滤镜”。

software-architecture 这个 Skill 就是来干这个的——装上它之后,每次 AI 下手写代码前,会先问你一句:这事该放哪层?用什么设计模式?有没有现成的库能用?

核心功能

它基于 Clean Architecture 和 DDD(领域驱动设计),给 AI 装了三套规矩:

  • Library-First(库优先):动手写自定义代码前必须先搜 npm、评估 SaaS 和第三方 API。不是自己造轮子,而是把轮子用在刀刃上。只有业务逻辑独特、性能关键、或者安全敏感的场景才值得手写。
  • 命名纪律:禁止 utils、helpers、common 这类通用垃圾命名。必须用领域术语:OrderCalculator、UserAuthenticator——名字本身就是文档。
  • 边界清晰:业务逻辑不混进 UI 组件,数据库查询不放进控制器。框架是外层细节,核心业务规则要离框架远远的。

代码风格也有硬标准

这个 Skill 不只讲架构,还管代码长什么样:

  • 能用 early return 就别嵌套 if——AI 写的条件判断树常常三层嵌套起步,这个 Skill 会逼它提前退出
  • 组件 / 函数超过 80 行必须拆分
  • 单个文件超过 200 行必须拆文件
  • 函数追求 50 行以内

适用场景

只要你用 AI 写代码,这个 Skill 就该开着。不管是:

  • 从零设计一个新系统
  • review 一段已有的代码
  • 重构一个历史遗留的”大泥球”

它会引导 AI 先画架构图、识别边界、找现成库,而不是上来就开写。

怎么装

一行命令:

npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill software-architecture

装完重启 Claude Code,Skill 自动加载。GitHub 上这个 Skill 所属的仓库累计 47K+ stars,在 AI 编程圈有相当的认可度。

让 AI 写代码变专业,先让它有架构纪律。

https://github.com/sickn33/agentic-awesome-skills


GitHub: https://github.com/sickn33/agentic-awesome-skills

评论区

0 条评论

登录后可评论。

江望 731 阅读