Heidi Labs
GitHub TrendingGitHub Trending 项目约 4 分钟1,434 字

Spotify Portal AI 插件

本文目录

将 Spotify Portal 带入 Claude Code、Codex、Cursor 和 pi。

该插件为 Portal CLI 提供聚焦的工作流:设置身份认证、搜索你的软件目录、构建服务简报、运行诊断,以及调用 Portal 操作。

亮点#

  • 为当前使用的编码代理环境设置 Portal CLI。
  • 运行只读诊断,以验证插件、CLI、身份认证和操作的就绪状态。
  • 使用自然语言查询搜索软件目录和技术文档。
  • 生成简洁的服务简报,包含可用的归属、健康状况、事件和文档详细信息。
  • 通过内置帮助、试运行(dry-run)和确认保护机制,发现并安全地调用 Portal 操作。
  • 创建、运行、检查 Fleetshift 班次(shift),从已完成的运行中发起 PR,并按请求停止运行。

该市场还提供 shunt(目前仅支持 Claude Code):这是一个插件,它通过 Portal CLI 操作注册表,将 I/O 密集型的代理工作——批量文件读取和样板代码生成——路由到运行更廉价工作模型的 AiKA 模式。参见 plugins/shunt/README.md。

安装#

Claude Code#

claude plugin marketplace add spotify/portal-ai-plugins
claude plugin install portal@portal
claude plugin install shunt@portal # 可选:节省 token 的 AiKA 委托

启动新会话并运行:

/portal:setup

Codex#

codex plugin marketplace add spotify/portal-ai-plugins
codex

打开 /plugins,安装 Spotify Portal,启动新任务,然后输入:

Set up Spotify Portal for me.

Cursor#

在 Cursor 团队市场中注册 spotify/portal-ai-plugins 仓库,然后从 Cursor Settings → Plugins 安装 Spotify Portal。

pi#

pi install git:github.com/spotify/portal-ai-plugins

启动新会话并运行:

/skill:setup

工作流#

工作流用途
setup配置 Portal CLI 身份认证
doctor运行只读就绪状态诊断
search搜索软件目录和技术文档
service生成简洁的运维服务简报
actions发现、检查、预览并安全调用 Portal 操作
feedback向 Portal 团队提交关于 Portal CLI 的反馈
fleetshift-create-shift根据目标起草并创建 Fleetshift 班次,并提供试运行预览
fleetshift-run-shift触发班次,以有界等待进行监控,并按请求停止
fleetshift-check-shift报告班次的进度、目标和 PR(只读)
fleetshift-troubleshoot-shift根据状态和日志诊断失败的班次任务(只读)
fleetshift-create-prs经确认后为已完成的班次目标发起 PR

Portal CLI#

这些工作流通过以下方式调用上游 CLI:

npx @spotify/portal-cli <command>

设置流程会在继续之前验证所需的 auth、actions、owner、search 和 service 命令。