关于 polpo
Polpo 项目技能指导如何检查项目、维护 layout v2 资源、验证并部署，并区分开源运行时与 Cloud 管理功能。适用于维护 Polpo 项目和资源的开发者。
主要功能
- 01检查项目与 CLI 版本
- 02编写 layout v2 项目资源
- 03部署前本地验证
- 04通过 CLI 或工作流部署
- 05区分 OSS 与 Cloud 职责
适用场景
- 01创建或迁移 Polpo 项目资源
- 02部署前排查引用与打包错误
- 03判断功能应属于 OSS 还是 Cloud
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/polpo确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/cli-and-deploy.mdcontract-version.mdplatform-boundaries.mdproject-layout.md详细介绍
Polpo 项目
以已检出的项目和已安装的 CLI 为准。除非明确要求迁移，否则不要重新创建旧版
.polpo/polpo.json 或 .polpo/agents.json 布局。
工作流
- 检查代码库、
.polpo/、package.json和已安装的polpoCLI 版本。 - 保留现有的已关联项目。仅在用户提出要求或不存在项目时，才创建或关联项目。
- 按布局 v2 编写资源：项目元数据、每个 Agent 各自的目录、项目 Loop 定义、团队、技能和技能锁定文件。
- 部署前在本地进行验证。解决未知引用和打包失败，不要依赖再次执行相同的部署来解决问题。
- 通过 CLI 或受支持的工作流进行部署。切勿将提供商密钥放入项目文件。
- 报告项目、已更改的资源、执行过的验证，以及是否仍需 Cloud 配置或推出。
项目边界
- OSS 负责可移植的契约、架构、运行时行为、SDK、CLI 行为和可自托管适配器。
- Cloud 负责托管式租户管理、计费、推出、托管存储、提供商自动化、安全凭据保管和托管式协调。
- 如果某项 Cloud 功能的行为对可自托管运行时普遍有用，就应使用 OSS 原语。不要将可移植的运行时行为建模为仅限仪表板的配置。
参考资料
- 创建或迁移
.polpo/文件前，请阅读 references/project-layout.md。 - 有关引导、关联、验证、部署、拉取、技能和失败语义，请阅读 references/cli-and-deploy.md。
- 在决定由 OSS 还是 Cloud 负责，或诊断仅限托管环境的行为时，请阅读 references/platform-boundaries.md。
- 依赖不同 Polpo 版本中的具体字段或命令前，请阅读 references/contract-version.md。
专项技能
polpo-agents：Agent 定义、模型、策略、技能、记忆和沙箱默认设置。polpo-runtime：补全、Sessions、持久化运行、Project Loops、引导和计划任务。polpo-channels：消息传递提供商、配置、路由、媒体和可信身份。polpo-integrations：Connections、自定义工具、隐藏绑定、MCP 和 OAuth。polpo-react：React hooks、聊天 UI、持久化重连、交互和客户端工具。
评论
支持 Markdown