项目简介
面向 Claude Code、Codex、Cursor 等 AI 编程代理的插件集,将 Spotify Portal 接入开发流程。通过 Portal CLI 提供认证配置、软件目录搜索、服务简报、只读诊断与安全操作调用等工作流。
README 预览
# Spotify Portal AI Plugins\n\nBring [Spotify Portal](https://portal.spotify.com) into Claude Code, Codex, and Cursor.\n\nThis plugin provides focused workflows for the\n[Portal CLI](https://www.npmjs.com/package/@spotify/portal-cli): set up\nauthentication, search your software catalog, build service briefings, run\ndiagnostics, and invoke Portal actions.\n\n## Highlights\n\n- Set up the Portal CLI for your current coding-agent environment.\n- Run read-only diagnostics to verify plugin, CLI, authentication, and action readiness.\n- Search the software catalog and technical documentation using natural language queries.\n- Generate concise service briefings with available ownership, health, incident, and documentation details.\n- Discover and safely invoke Portal actions with built-in help, dry-run, and confirmation safeguards.\n\nThe marketplace also ships **shunt** (Claude Code only for now): a plugin that routes I/O-heavy agent work — bulk file reads and boilerplate generation — to AiKA modes running cheaper worker models, via the Portal CLI actions registry. See [`plugins/shunt/README.md`](plugins/shunt/README.md).\n\n## Installation\n\n### Claude Code\n\n```bash\nclaude plugin marketplace add spotify/portal-ai-plugins\nclaude plugin install portal@portal\nclaude plugin install shunt@portal # optional: token-saving AiKA delegation\n```\n\nStart a new session and run:\n\n```text\n/portal:setup\n```\n\n### Codex\n\n```bash\ncodex plugin marketplace add spotify/portal-ai-plugins\ncodex\n```\n\nOpen `/plugins`, install Spotify Portal, start a new task, and ask:\n\n```text\nSet up Spotify Portal for me.\n```\n\n### Cursor\n\nRegister the [spotify/portal-ai-plugins](https://github.com/spotify/portal-ai-plugins)\nrepository in your Cursor team marketplace, then install Spotify Portal from\n**Cursor Settings → Plugins**.\n\n## Workflows\n\n| Workflow | Purpose |\n| --- | --- |\n| `setup` | Configure Portal CLI authentication |\n| `doctor` | Run read-only readiness diag