无尘阁日记

无尘阁日记

WorkBuddy技能评测 #244 | 开发规范与工具集成:38 条把「代码风格」写成 AI 能执行的规则
silcano

基本信息

  • 组内条数:38 条,热度 3,874 – 3,991
  • 代表技能:error-handling(wellcrafted 的 trySync/tryAsync)、git(conventional commits)、styling(CSS/Tailwind)、documentation(README/JSDoc)、drizzle-orm、services-layer、typebox、workflow、technical-articles、specification-writing
  • 来源特征:明显是某一个 TypeScript 全栈项目的内部规范,被整理成技能公开

它解决了什么痛点

这一组解决的是「同一个项目里,AI 写出来的代码风格各不相同」。每个技能都在确立一条不可协商的约定:错误必须用 Result 类型而不是 throw、commit message 必须遵循 conventional commits、样式只能用 Tailwind 的既有 token。

它的价值密度取决于你是否用同一套技术栈。如果你写 TypeScript + Drizzle + Tailwind,这 38 条几乎就是一份现成的团队规范,可以直接抄进自己的 CLAUDE.md。如果你写 Python 或 Go,能借用的只有 git、documentation、specification-writing 这三条通用的。

对我有没有用(技术 / 自媒体 / AI / 读书)

技术:中等偏上,但强依赖栈。TypeScript 全栈项目能拿走 80%,其它栈只能拿 20%。其中 specification-writing 是唯一与语言无关且真的稀缺的 —— 它讲的是「怎么写规格让 AI 有足够上下文去实现,同时留出发挥空间」,这个度很难把握。自媒体:弱,technical-articles 那一条算沾边(写技术文章的结构)。AI:中等,specification-writing 和 workflow 属于上下文工程。读书:无。

典型场景

你和 AI 一起维护一个多人协作的 TS 项目,最近 commit 越来越乱、错误处理越来越随意。做法:把 git、error-handling、documentation 三条装进项目根目录的 skills 里,让它每次动代码前先读。成果:两周后 commit 记录能自动生成 changelog,错误处理不再混用 throw 和 return null。这类收益很慢,但不会退。

一句话结论

这是「别人的团队规范」,抄之前先看栈对不对得上。只有 specification-writing 是无条件值得读的。

📊 完整对比数据见在线总表:WorkBuddy 技能市场全量调研总表(腾讯文档)