Agent 总返工？ Google 工程师把工程实践写成了技能库

同一句「改之前先看看现有实现」，你大概已经跟 Agent 说过不下十次。换个会话，它又忘了。

真正麻烦的不是它不会写代码，是它每次都从零推导你想要的工作方式。

提交前跑 lint、改前先读现有实现、只改被点名的文件------这些要求都不难，难的是它们只活在某次对话里，会话一结束就蒸发。结果就是：它改得很快，diff 摊开一看多动了三个类，你得逐行确认有没有顺手改坏别的地方。

第一反应通常是换个更强的模型，或者把提示词再写长一点。但提示词是一次性的，这一轮交代过，下一轮又得重讲一遍。2026-11-12 的 GitHub Trending 上，有个项目把这件事往另一个方向推了一步。

卡住日常开发的，是每次都要重讲的那些约束

addyosmani/agent-skills，一套面向 AI 编程助手的生产级工程技能库，出自 Google 工程师 addyosmani。

素材给的一句话定位是：为 AI Coding Agent 提供一套可直接复用的生产级工程技能，把「让 Agent 真正能干活的日常开发实践」标准化。

这句话里最值得停一下的不是「技能」，是「可复用」和「标准化」。从定位上看，它想换掉的是这么一步：过去工程约束写在每次对话的提示词里，用完即丢；现在它们被固化成 Agent 能反复读取、逐条对照的东西。可以理解为，前者靠你记性好，后者靠机制。

我的看法是：把工程实践写成可复用的技能，比反复调提示词更能减少 Agent 返工。这句话可以被反驳，但至少它把问题指到了一个能动手改的地方。

对你来说，下次返工时先别急着换模型，数一数你为同一个约束重讲了多少遍。这个数字比 star 数更能说明你自己的问题在哪。

作者身份摆在那儿。 Google 工程师出品，素材也把「来源权威」列进了入选理由。素材只给了身份，没给具体职务，这里不往外扩。

热度是当天的、可核对的。 2026-11-12 进入 GitHub 当日 Trending，当日新增 812★；素材给的 96/100 是素材里的热度评分口径，不是 GitHub 的官方评级，两者别混着看。

主题离日常足够近。 入选理由写得很直白：主题高度契合「AI 编程助手 / 日常开发」。它对的不是评测集，是每天都会打开的那个对话框。

三条加起来，说明这是一条「今天就能拿去判断要不要看」的素材。热度只负责把你叫到门口，值不值得进去，还得看它解决的问题是不是你正在遇到的那个。

素材只给了定位与摘要，没有给仓库内部清单，所以这一节只做解读，不假装看过目录。

第一，把实践变成可复用单元。 从「技能库」这个定位上看，它给的不是一篇方法论文章，而是能被 Agent 直接拿来用的一组东西。区别在于：读完文章要自己记住，装了技能则不必每次重新交代。

第二，「生产级」三个字是对结果负责。 可以理解为，它关心的是 Agent 交付的东西能不能进正常开发流程，而不是演示时看着多惊艳。

第三，标准化省的是重复沟通。 把日常开发实践固化下来之后，个人和团队不必在每次任务里重新描述「该怎么做」。

以上三点都是从定位推出来的理解，不是项目官方说明。具体包含哪些技能、怎么安装、覆盖哪些开发阶段，素材没有提供，本文不做展开，需要时以仓库 README 为准。

对你来说，现在能判断的是「这个方向值不值得跟」，还不能判断「它具体好不好用」。这两件事别混在一起。

把规矩写成文件。 仓库里放一份 AGENTS.md，或在 CONTRIBUTING 里补一段：改前先读现有实现、只改被点名的文件、提交前跑哪条测试。写一次，省掉后面几十次重复交代。
让 Agent 先报改动范围。 动手前让它输出「我打算改哪几个文件」，你确认后再执行。这一步能挡掉大部分顺手改坏的情况。
同一句话说第三遍就归档。 重复出现的指令，就是该进文件的内容。这是最低成本的标准化。

以下是建议的验证路径，不是项目官方步骤；三条都不用装东西，今天下班前就能先落地第 1 条。第 2 条更快见效：它改的是流程，不是工具。

适合已经把 AI 编程助手用进日常开发、被「改得太多、不敢合」困扰的人；也适合想给团队定一套共同做法的人。

不适合想找「模型更强、生成更快」工具的人------它作用在流程层，不改模型能力；不适合只是偶尔让 Agent 补一段测试的读者；也不适合项目本来就有严格 CI 和 review 在兜底的团队，规范已经有人在执行了，再加一层只是重复。

如果「AI 写得快但不敢合」是你现在的真实问题，这份 11 月 12 日的 Trending 条目值得花五分钟点开：它至少把问题命名对了。

你用 Agent 写代码时，最常重讲的是哪一条约束？评论区聊聊。