Spotify 开源的 AI 编程插件箱portal-ai-plugins

大厂内部的研发平台，往往有一堆只有老员工才摸得清的门道，新人想查个服务归属、看个故障历史都得翻半天文档。今天继续「每日开源」，看 Spotify 开源的一组东西：portal-ai-plugins，它把自家的工程平台能力，直接接进了 coding agent。

这是什么

portal-ai-plugins 是 Spotify 开源的一个插件市场，用 TypeScript 写成，目前 GitHub 上 3.1 千 Star。它围绕自家的 Portal 平台（Spotify 内部的软件目录与运维平台）做了一组 coding agent 插件，让你在用 Claude Code 这类工具时，能用自然语言去查目录、跑诊断、调用平台操作。简单说，就是给 agent 装上一双能直接操作内部平台的「手」。

核心功能

环境就绪与只读诊断

插件能帮你把 Portal CLI 配到当前的 coding-agent 环境里，还能跑只读诊断，核对插件、CLI、鉴权、以及各项 action 是否就绪。接手新环境时先跑一遍，心里有底。

用自然语言查目录和文档

不用再手动翻内部 wiki，直接用自然语言搜索软件目录和技术文档。还能生成一份简洁的服务简报，把负责人、健康度、故障记录、文档链接这些关键信息聚到一起。

带护栏的操作调用

发现和调用 Portal 的 action 时，内置了帮助、dry-run 和确认 safeguard，不是想调就调。另外还能创建、运行、检查以及排查 Fleetshift 的 shift，从完成的运行里开 PR，或者按需停掉某个运行。

shunt：把重活甩给便宜模型

市场里还附带一个叫 shunt 的插件（目前仅 Claude Code），专门把那些 IO 密集的 agent 活儿，比如大批量读文件、生成样板代码，路由到更便宜的 worker 模型去跑，通过 Portal CLI 的 action 注册表来调度，省钱也省主模型的上下文。

适合谁用

最对口的是用 coding agent 做内部平台工程、SRE 相关工作的团队。它展示了一种思路：把企业自有平台的能力封装成 agent 插件，让 AI 助手能安全地查和做。对想给自家内部平台做类似集成的团队，是个很具体的参考样本。

怎么开始

仓库里的 README 给出了插件的能力和上手路径，核心是先把 Portal CLI 装好、配进 agent 环境，再用只读诊断确认状态：

# 在自己的 coding-agent 环境里配置 Portal CLI # 然后跑只读诊断，确认插件 / CLI / 鉴权 / action 就绪 # 具体命令见仓库 README 的对应小节

这类集成依赖对应的平台和鉴权，建议在你们自己的平台环境里对照着改，不要直接套用到外部服务。

写在最后

portal-ai-plugins 的价值不完全在代码本身，更在于它把「agent 如何安全地接入企业内部平台」这件事，做成了一套可借鉴的范式。如果你也在琢磨怎么让 coding agent 碰得到你们的自家系统，这个项目值得翻一翻。

如果你觉得这个项目有意思，欢迎去 GitHub 点个 Star 支持作者：https://github.com/spotify/portal-ai-plugins

觉得有用点个「在看」，分享给需要的同事。

关注本号，每天一个值得收藏的开源项目。

你最想看哪类项目？前端 / 后端 / AI / DevOps？评论区告诉我，下期安排。

关注公众号，AI时代不迷路，创建价值活下去