开发者接口

开发者接口

IC Hub 为主流 Agent、CLI 和 MCP 提供 Skill 元数据、Skill 清单和下载授权入口。

公开信息

公开页面可以读取 Skill 名称、摘要、分类、标签、评分、版本、适用场景和公开预览内容。

常用公开接口

公开接口用于发现、搜索和授权前预检。具体字段以后端返回为准，常见入口包括：

GET /api/public/skills/search
GET /api/public/skills/{slug}
GET /api/public/install-manifest/{slug}

授权信息

完整包下载、签名链接、下载记录和企业空间权限需要登录后访问。企业场景可通过访问令牌和空间授权完成集成。

访问令牌

企业空间或自动化流程可使用访问令牌读取授权范围内的 Skill 清单和下载入口。令牌应按项目或空间隔离，并定期轮换。不要把令牌写入公开仓库、截图或文档。

Agent 使用集成

每个 Skill 会提供面向 IC Coder、Codex、Claude Code、Trae、Qoder、Codebuddy 的上传说明和启动提示词。Cursor、MCP、CLI 保留为高级可选用法，用于项目规则转换、工具接入或批量校验。

Agent 读取流程

1. 读取公开元数据，确认 Skill 是否存在。
2. 读取 Skill 清单，确认支持的 Agent、版本和文件结构。
3. 如果需要完整包，进入授权下载流程。
4. 下载后校验 SHA256。
5. 上传压缩包并复制启动提示词。
6. 让 Agent 先确认计划和风险，再接入项目并记录执行结果。

错误处理建议

• 401：先检查登录态或访问令牌。
• 403：检查企业空间授权、包状态或下载权限。
• 404：确认 slug 是否正确、Skill 是否公开。
• 409：确认版本、授权状态或订单状态。
• 5xx：保留请求时间、路径和响应信息，联系服务团队排查。