乐于分享
好东西不私藏

你用的AI写代码工具,可能都没按"正确姿势"来

你用的AI写代码工具,可能都没按"正确姿势"来

有没有遇到过这种情况——

让AI帮你写一个功能,它刷刷刷给你一大段代码,看着逻辑清晰、注释完整,你觉得这下稳了。

结果一运行,报了三个错。你让它改,它改好了这个地方,顺手把另一个功能改崩了。

来回折腾一个小时,你最后发现:还是自己重写了一遍。


这不只是你的问题

很多人把这归结为"AI还不够聪明"。

其实不是。真正的问题是:大多数人的AI编程工具,没有一个"正确姿势"来规范它的输出。

就像一个刚入职的实习生,能力有,但不知道你们公司的做事方式和质量标准。你让他写,他就按自己的理解写,写出来你不敢直接用。

AI编程工具现在的状态,就是那个没受过培训的实习生。


Google工程师做了一个"培训手册"

Addy Osmani,Google的资深工程师,《JavaScript设计模式》的作者,在前端圈子里几乎是KOL级别的人物。

他在GitHub上开源了一个项目:agent-skills

GitHub Stars 已突破 6.3 万,Forks 达到 6,915,项目昨天(6月19日)还有代码推送。这是一个持续迭代的项目,而不只是昙花一现的爆款。

这个项目做的事情很简单——它把高级工程师在写代码时会遵循的流程、质量门控和最佳实践,全部编码成了标准化的"技能包"。

你的AI编程助手(不管是Claude Code、Cursor还是Copilot)装上这些技能包之后,它会按照Google级别工程师的工作流程来帮你写代码。


什么叫"正确姿势"?

大多数人用AI写代码,流程是:

提需求 → 拿代码 → 复制粘贴 → 完事

资深工程师的流程是:

先写规格(Spec) → 再做计划(Plan) → 增量实现(Build) → 写测试(Test) → 代码审查(Review) → 发布(Ship)

agent-skills把这个完整流程拆成了多个命令,对应开发的全生命周期:

/spec — 先设计,再写代码。不让AI"边想边写"。

/plan — 把大任务拆成小任务。一次只做一小块,稳扎稳打。

/build — 增量实现。每次只改一点点,频繁验证。

/test — 测试通过了,才算真的完成。不是"看起来对"就够了。

/review — 合并之前,先审查代码质量。

/code-simplify — 能简单就别复杂。"聪明"的代码往往最难维护。

/ship — 发布上线前的检查清单。

每一个命令背后,都有明确的步骤、检查点和退出标准。AI不是"自由发挥",而是按流程走。


最狠的一个设计

agent-skills里有一个很特别的设计——"反合理化机制"

什么意思?

AI有一个习惯:偷懒。你让它写测试,它可能会在心里想"我稍后再添加测试",然后直接去写下一功能。

agent-skills在每个技能包里,都内置了一张**"常见借口表"**,并且配好了反驳论证:

借口:"我稍后再添加测试。"反驳: 不行,测试必须在代码之前或同时完成。测试是证明代码能工作的证据,不是可选项。

借口:"这段代码太简单了,不需要注释。"反驳: 代码是写给人看的,不是写给机器看的。六周后你来维护这段代码时,你不会记得今天在想什么。

这套"反驳论证"是硬编码在技能包里的,AI想偷懒也绕不过去。


它支持哪些平台?

这也是这个项目传播得快的原因之一——它不挑工具。

  • Claude Code(推荐,通过Marketplace一键安装)
  • Cursor(复制SKILL.md到.cursor/rules/
  • GitHub Copilot(作为Copilot角色使用)
  • Windsurf
  • Gemini CLI
  • OpenCode

零门槛,装上去就能用。


说一点客观的话

agent-skills目前还不是"银弹"。

第一,它假设你的AI工具支持自定义技能/规则。 如果你的工具不支持(比如某些简化的在线版),就用不了。

第二,技能包是英文的。 虽然AI能理解,但如果你要在团队里推广,英文文档会增加一点门槛。

第三,它体现的是Google的工程文化。 如果你的团队流程和Google不一样,可能需要自己改一改技能包的内容。

但这些都不是致命缺陷,而且因为它是开源的(MIT协议),你想怎么改就怎么改。


写在最后

AI编程工具这个赛道,2026年一直在快速演进。

Goose(Linux基金会的开源Claude Code替代品)、DeepSeek-TUI(终端里的AI助手)、agent-skills……每个工具都在解决不同层面的问题。

agent-skills走的是另一条路——不替代你的工具,而是让你的工具变得更专业。

就像你请了一个助手,光有助手不够,你还得教它你们公司的做事方式。agent-skills就是那本"做事方式手册",而且是由Google级别工程师写好的。

6.3万人已经把它加入了自己的工具箱。你可能也需要。


数据来源:GitHub | 项目:addyosmani/agent-skills(Stars 63,934,MIT开源协议)


技术前哨 · 每天5分钟,知道技术圈在发生什么