portal-ai-plugins 六大工作流清单setup、doctor、search 到 feedback 完整指南【免费下载链接】portal-ai-plugins项目地址: https://gitcode.com/gh_mirrors/po/portal-ai-pluginsportal-ai-plugins是 Spotify 官方开源的 AI 编程插件它把 Spotify Portal 的核心能力接入 Claude Code、Codex 和 Cursor。安装后AI 助手可以通过 Portal CLI 完成认证配置、服务搜索、服务简报、健康诊断、动作调用和反馈提交六大工作流让开发者用自然语言就能查询软件目录、追踪服务负责人并安全执行 Portal 操作。一、项目速览3 行命令装好 Spotify Portal 插件项目根目录的 README.md 列出了所有支持的宿主环境。以 Claude Code 为例claude plugin marketplace add spotify/portal-ai-plugins claude plugin install portalportal新开一个会话输入/portal:setup即可完成认证。Codex 和 Cursor 也有对应的安装入口详见 README.md 的 Installation 章节。 插件以portal为命名空间所有工作流都以/portal:workflow的形式调用记忆成本很低。二、六大工作流清单一览工作流一句话用途源码位置setup配置并验证 Portal CLI 认证skills/setup/SKILL.mddoctor只读健康检查不改动任何状态skills/doctor/SKILL.mdsearch自然语言搜索软件目录与技术文档skills/search/SKILL.mdservice生成服务简报负责人、健康、事故skills/service/SKILL.mdactions发现并安全调用 Portal 动作skills/actions/SKILL.mdfeedback向 Portal 团队提交 CLI 体验反馈skills/feedback/SKILL.md每个工作流的规范指令都存放在skills/目录下这是项目的单一事实来源。三、setup一键完成 Portal 认证配置setup是入门第一步它会按固定顺序完成 5 个环节命令探测验证 CLI 是否具备auth、actions、owner、search、service五个命令检查已有实例列出已认证的 Portal 实例多实例时让你手动选择按需登录仅在未认证时打开浏览器完成 OAuth绝不会要求你在聊天框粘贴 token选定并验证实例确认 Agent 可用用actions list --json证明认证链路完全打通完成后会输出一份简洁报告CLI 来源、实例名与后端地址、认证状态。安全规则写得很严详见 skills/setup/SKILL.md。四、doctor只读体检排查问题神器装完插件却没反应/portal:doctor是你的排障神器。它的核心原则是只读——不安装、不认证、不切换实例、不执行任何变更类动作见 CLAUDE.md 中的设计规则。诊断流程覆盖四层插件层检查portal是否安装启用、版本是否最新CLI 层验证 Node.js 运行时和命令面是否完整认证层检查认证状态多实例且未指明目标时报告歧义而非擅自选择访问层用actions list --json验证只读访问最终输出一张四行状态表Ready / warning / blocked任何一项被阻塞就不会谎报整体就绪。规则详见 skills/doctor/SKILL.md。五、search用自然语言搜索软件目录想知道支付相关的服务有哪些直接把话丢给search即可。它会用你的原话作为初始查询词调用 Portal CLI只在意图明确时用--type限定搜索范围software-catalog或techdocs返回精选短名单而非原始结果文档保留准确的实体引用、标题和链接首查为空时自动放宽关键词重试一次它有一条铁律结果少时绝不编造服务或文档。完整工作流见 skills/search/SKILL.md。六、service30 秒拿到服务简报service工作流把这个服务谁在管、健康吗、文档在哪一次问清。按需求精准匹配命令你想了解对应能力负责人、值班、Slack 频道、Runbookowner命令构建、部署、运行时、事故service status服务文档service docs完整简报以上全部注意它区分不可用和健康某个维度查不到就如实报告不可用绝不美化结果并保留时效证据和来源链接。详见 skills/service/SKILL.md。七、actions发现与调用 Portal 动作的安全姿势Portal 动作Action是平台的可执行操作集合。actions工作流的调用安全链条非常值得学习先actions list --json发现可用动作变更类动作必须--dry-run --json预览向用户展示将发生的变更用户授权后才执行破坏性操作才加--yes严禁把 dry-run 结果当作执行成功这套预览 → 展示 → 授权 → 执行的模式是 AI Agent 安全调用的最佳实践。完整规则见 skills/actions/SKILL.md。八、feedback一条命令直达 Portal 团队对 Portal CLI 有吐槽或建议feedback工作流通过telemetry:submit-feedback动作提交反馈且规则严谨提交前展示逐字原文并征得确认不总结、不润色、不翻译文本中不能含密钥、token 或个人数据单向通道不回复、不建单需要答复的问题请走 Portal 支持渠道退出码 2 表示未认证先跑auth login再重试范围仅限 CLI 体验命令、参数、输出、认证流详见 skills/feedback/SKILL.md。九、隐藏彩蛋shunt 插件省 82-94% Token市场里还附带一个shunt插件目前仅 Claude Code把批量读文件、样板代码生成等 I/O 密集型工作分流给 AiKA 模式的廉价 worker 模型官方评测显示可节省82-94%的 Token。它由 Hooks拦截大文件读取、ScriptsAiKA 调用管道、Skills调用时机指引三层组成完整说明见 plugins/shunt/README.md。十、快速上手与参考文件清单5 分钟上手路径按 README.md 安装插件新会话运行/portal:setup有问题随时/portal:doctor开始用自然语言search和service关键文件索引项目总览README.md插件设计规范CLAUDE.md六大工作流skills/shunt 插件plugins/shunt/从 setup 到 feedback六个工作流覆盖了装、查、诊、用、反馈的完整闭环。无论你是刚接触 Spotify 工程体系的新手还是想给 AI 助手装上企业级基础设施能力的老手这份清单都值得收藏 ⭐【免费下载链接】portal-ai-plugins项目地址: https://gitcode.com/gh_mirrors/po/portal-ai-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考