spotify/portal-ai-plugins

项目介绍

这个仓库是一个插件市场，把 Spotify Portal 接入 Claude Code、Codex、Cursor 和 pi 等编程助手环境。它封装了 Portal CLI（@spotify/portal-cli），让助手直接执行针对软件目录的固定工作流，而不必手动敲 CLI 命令。

工作流包括：初始化认证、只读的就绪诊断、用自然语言搜索软件目录和技术文档、生成含归属/健康/事件信息的服务简报，以及发现、预览并安全调用 Portal 动作（带帮助、试运行和确认机制）。此外还有一组 Fleetshift 工作流，用于根据目标创建 shift、启动并监控运行、查看目标与 PR、从状态和日志排查失败任务，以及在完成后确认打开 PR。另有独立插件 shunt（目前仅限 Claude Code），通过 Portal 动作注册表把批量读文件、样板代码生成等 I/O 密集任务交给运行更便宜模型的 AiKA 处理。

快速使用

Claude Code 用户在 shell 中执行：

claude plugin marketplace add spotify/portal-ai-plugins
claude plugin install portal@portal
claude plugin install shunt@portal   # 可选

新开一个会话后运行 /portal:setup 配置 Portal CLI 认证。Codex 用户先执行 codex plugin marketplace add spotify/portal-ai-plugins，再启动 codex，打开 /plugins 安装 Spotify Portal，新建任务并输入「Set up Spotify Portal for me.」。Cursor 用户需在团队市场中注册该仓库，再从 Settings → Plugins 安装。pi 用户执行 pi install git:github.com/spotify/portal-ai-plugins，然后运行 /skill:setup。

setup 会先确认 CLI 提供 auth、actions、owner、search、service 这五个命令后再继续。插件通过 npx @spotify/portal-cli <command> 调用 CLI。

使用约束

你需要有 Spotify Portal 的访问权限，并使用支持插件市场的编程助手。项目没有独立界面，各项功能都经由宿主助手驱动，并依赖能通过 npx 获取到 Portal CLI。不同宿主的安装命令和语法各不相同，shunt 目前仅支持 Claude Code。

会改变状态的操作（调用 Portal 动作、运行 shift、打开 PR）都配有帮助、试运行预览和确认步骤；诊断与 shift 检查类工作流为只读。仓库采用 Apache-2.0 许可证。

HotRepo 点评

在 HotRepo 2026-11-02 的 TypeScript 周榜记录中，该项目为 2,820 Star、222 Fork，当周新增 297 Star，最好名次为第 16。站内目前只有这一条周榜快照，只能说明该周期内受到关注，不足以判断趋势。对读者而言，更值得注意的不是功能新颖度，而是分发方式：厂商把内部 Portal 运维能力一次性打包成多种编程助手各自的插件形态。

项目源码与说明