两年前,给一个简单网站做一套后台管理面板要花我一天,也许两天——而且我还为自己手脚快而自豪。现在只需要大约一两个小时。
以前的一天是这样的。安装包,生成 CRUD,配置每个字段和每一列,把关联关系接好,点一遍确认它能用。每个 CRUD 轻轻松松三十到六十分钟。现在我描述我想要什么,agent 跑我们的生成器,写配置,写测试,我来审阅。一天的工作压进一小时。一周的功能压进一天。
不止我一个人看到这一点。2026 年 2 月,一位来自新西兰的客户在我们的反馈表里给了我们 10 分(满分 10 分)。整条评价只有一行:
"用起来很直接(尤其是 Claude 在旁边帮我看着的时候!)"
这就是新常态。开发者不再独自面对文档了。旁边有一个 agent,它早就懂这个包。
我维护 Backpack for Laravel,一个存在了 10 年的后台管理面板包。为了让 AI agent 更擅长用 Backpack 写后台,我们做了不少事——这是个变化很快的细分领域。但当我回头去看为什么 AI agent 在这件事上这么在行,答案让我意外。大部分并不是我们专门为 AI 做的东西。大家都会建议你加的那两样东西——llms.txt 和一个 MCP server——对我们几乎没什么帮助。
下面说说真正有帮助的是什么,你可以对自己的包做同样的事。
没有起作用的那些
先把这些说清楚,因为大多数「让你的包 AI-ready」的建议都是从它们开始的。
llms.txt。我们发布了一个。我不觉得它有多大用。agent 很少去找它。就算去找了,它们找到的也不过是一个目录,指向它们本来就能读的文档。说实话,正在考虑删掉它。
一个 MCP server。我们建了一个,让 agent 能查询我们的文档。结果充其量是喜忧参半。agent 得先决定去调用它,而它通常不会。然后有些 AI 发出的查询简直……可笑。当然我们的 MCP 不会返回什么有用的东西,你的 AI 才打了两个词——离谱!所以不,我不觉得我们的 MCP 现在还有多大帮助——说实话也在考虑删掉它。MCP server 非常适合 agent 无法用其他方式获取的实时数据——或者工具调用。静态文档不属于这一类。
教训:任何 agent 必须「记得去取」的东西都很弱。有效的是已经摆在它面前的东西,或者已经在它脑子里的东西。
我们无意中做对的事
我们最大的收获,来自早在有人用 AI 写代码之前就做出的决定。
1. 稳定的 API 现在就是训练数据
Backpack 的核心 API 在过去四年里几乎没变过。就连我们正在做的 v8,也是从维护开始的:升级和移除依赖、修复不一致之处。你定义字段或列的方式始终如一。我们这么做是为了让老项目升级不痛苦。副作用是:多年的 Backpack 代码进了模型训练数据,而且这些代码至今仍然正确。
当 agent 写出 CRUD::column('name') 时,它不是去搜索,也不是在猜。它本来就知道。你每发布一次重命名,就把模型学到的东西劈成「旧写法」和「新写法」,而它会在往后几年里一直建议旧写法。
有个坏处。模型有时会写出很老版本的模式。我们用项目内指令来修正(下面再讲),而不是指望模型自己追上。
对你的包来说:用废弃,而不是重命名。让旧签名继续能用。把每一次破坏性变更当作要付两次代价:一次给你的用户,一次给每一个学过旧 API 的 agent。
2. 开源意味着大量示例
我们的核心 backpack/crud 是开源的。这意味着十年的 GitHub issues、pull requests、教程、Stack Overflow 回答和博客文章。全都是训练数据。当 agent 真的去找的时候,也全都可搜索。
这是买不到的。但如果你在开源和闭源之间犹豫,这是一个支持开源的新理由。
3. 我们的付费代码也是可读的
文章标题:Llms.txt 和 MCP 并没有带来实质性改变
正文: 这是我认为对商业软件包最重要的一点。Composer 会把所有东西安装到 vendor/ 中,包括我们的付费附加组件。没有混淆,没有远程 API。代理可以打开任何功能的实际源代码,无论是免费还是付费,并准确看到它是如何工作的。
我们一直让这些代码保持简单、有注释、组织方式可预测,这是为了人类。事实证明,这正是代理也需要的。在实践中,代理回答自己关于 Backpack 的大多数问题时,就是通过阅读 vendor/ 来完成的。它们无需被提示就会这么做。
对于你的软件包:如果你销售代码,就以可读的方式交付。混淆的或仅限 SaaS 的功能,对于正在编写你客户代码的代理来说是不可见的。
4. 低仪式感,易于脱身的出口
Backpack 一直有意保持松散。你几乎可以用一个闭包或一个小调整来覆盖任何东西,而不需要创建类、注册服务提供者或扩展五样东西。
事实证明,这对代理来说非常理想。需要一个计算列?一行代码:
CRUD::column('full_name')->value(fn ($entry) => $entry->first_name.' '.$entry->last_name);
没有自定义列类,没有视图,没有绑定。小改动留在一个文件里。这意味着代理需要加载的上下文更少,出错的地方也更少。一个严格、高度抽象化的架构会迫使代理在能够做一点小改动之前,必须先理解大量内容。
对于你的软件包:对于每一个扩展点,问一问定制它需要几个文件。如果答案多于一个,就添加一个快捷方式。
我们有意为之的事情(按影响力排序)
1. Laravel Boost 插件——最大的收获
我们为 Backpack 添加了一个 Laravel Boost 插件。运行 php artisan boost:install,勾选 backpack/crud,你的代理就能直接在其上下文中获得我们的指南和技能:哪些功能存在、如何正确使用它们、应遵循哪些特定版本的模式。该技能按主题拆分(字段、列、过滤器、操作、测试等),因此代理只加载它需要的部分。我们在 v7.1 发布时写过相关文章。
这在 MCP 失败的地方奏效了,原因只有一个:代理不必决定去获取它。工作开始时,它已经在上下文里了。它还修复了上面提到的训练数据问题,因为指令与实际安装的版本相匹配。
对于你的软件包:如果你在 Laravel 生态系统中,就发布 Boost 指南。如果你不在,就发布等效内容:一个简短的、与版本匹配的说明文件,你的用户可以将其放入他们代理的上下文中。
2. 代理可以运行的生成器
php artisan backpack:crud Product 一次性创建模型、请求、控制器、路由和菜单项。然后 php artisan backpack:tests(来自我们的 backpack/test-generators 附加组件)为每个 CrudController 编写功能测试,支持 PHPUnit 或 Pest,而 backpack:tests:status 显示哪些控制器仍然没有测试覆盖。还有一些更小的命令:backpack:field、backpack:column、backpack:filter、backpack:button、backpack:crud-operation。
在有代理的情况下,这比没有代理更重要。一个命令每次都会给出相同的正确结果。代理手写的样板代码,是每个文件都有机会犯一个小错误。代理的时间最好花在真正针对项目特定的事情上。
对于你的软件包:如果用户反复编写相同的脚手架代码,就把它变成一个命令。代理会愉快且可靠地使用 CLI 工具。
3. 可预测的命名
当名称遵循某种模式时,代理就能猜对。一个文本字段有一个文本列。一个 select2 字段有一个 select2_multiple 的同类字段,所以 select2_from_ajax 也有一个 select2_from_ajax_multiple。一个 date_picker 字段与一个 date_picker 列配对。代理已经见过一个,所以它能正确地猜出其余的,而无需打开任何一个文件。
每一处不一致,都是代理猜错的地方,而你要在审查中为此付出代价。
对于你的软件包:让事物可猜测。同一概念在各处使用相同名称,相同的参数顺序,相同的模式。
4. 给代理的 Markdown 文档
我们的文档放在 Cloudflare 后面,我们开启了这样一个功能:当 agent 请求时,直接返回 Markdown 而不是 HTML。Agent 读取我们文档的速度更快、噪音更少。这是一个小小的胜利,而且如果你已经在用 Cloudflare,它是免费的。
给你的软件包的一份清单
大致按影响力排序:
- 把说明放在项目里,而不是藏在某个工具调用后面。Boost guidelines 或类似的文件,要与已安装的版本相匹配。
- 别再重命名东西了。弃用、起别名、让旧签名继续可用。
- 交付可读的源码,包括付费部分。为下一位读者写注释,不管他是不是人类。
- 把重复的脚手架变成命令。代码生成器、测试生成器。
- 砍掉繁文缛节。单文件定制。能用闭包就别用类。
- 让名字可以猜得到。同一个概念,同一个名字,处处一致。
- 如果你的托管方让这件事很容易,那就提供 Markdown 文档。
- 跳过 llms.txt 和只做文档的 MCP,除非你有明确的理由。把时间花在上面的清单上。
无聊的东西才会赢
我们最大的那些胜利,没有一个是靠小聪明。稳定性、开放的代码、简单的架构和好用的生成器,都是我们为人类开发者做的事。它们恰好也正是 AI agent 最需要的。那些专门为 AI 做的补充,只有在把正确的信息摆在 agent 面前、让它不必开口询问时,才真正起了作用。
还有一点,站在用户这边:用你能拿到的最好的模型。今天的前沿模型和半年前最强的模型之间的差距是巨大的。这一点恰恰在这类工作上体现得最明显。
如果你在用 Backpack 配合 AI:你现在搭建管理面板快了多少?一小时而不是十小时?一天而不是一周?在评论区告诉我。我很想拿到真实数字,和我的比一比。