1. 浏览公开 Skill
在 Marketplace 或 Registry 中按类别、运行时、验证状态、权限或发布者查找 Skill。
2. 检查 manifest
安装前打开 manifest，检查 schema、运行时、权限、版本、示例和审核状态。
3. 创建 Project Key
登录后创建项目，并为已批准运行调用生成有作用域的 Key。
4. 调用 REST API
使用 Authorization: Bearer PROJECT_KEY 和类型化输入调用运行端点。
5. 配置 MCP
把 SkillHub MCP 加入 Agent 工作台，使已批准 Skill 以工具形式出现。
6. 查看日志
测试调用后检查运行日志、策略阻断、限流和账务信号。
开始前先选一个低风险流程
第一次测试建议选 SEO 页面检查、Listing 质检、CSV 清洗或客服工单摘要这类低风险工作。不要在第一次测试中使用客户 secret 或生产写入动作。
- 优先选择已验证或低风险 Skill。
- 第一次调用使用样例数据或脱敏数据。
- 先确定谁来复核输出，再让结果进入客户或内部系统。
第一次 REST 测试
第一次 REST 测试要证明认证、输入 schema、响应结构、策略检查和日志都能跑通，再考虑自动化。
- 从可信环境发送 Authorization: Bearer PROJECT_KEY。
- payload 必须与 Skill manifest 输入 schema 匹配。
- 保存返回的 invocation id，并确认日志里能看到。
第一次 MCP 测试
第一次 MCP 测试要确认 Agent 工作台能发现已批准工具、读懂工具描述，并且只能调用项目策略允许的 Skills。
- 确认工具列表只展示项目已批准 Skills。
- 检查工具名称和描述是否同时让人和 Agent 看得懂。
- 触发一次安全调用，并确认策略决策和返回结果。
常见配置问题
早期失败通常来自缺少 Project Key、环境变量错误、schema 不匹配、策略阻断，或把未通过审核/未完成配置的 Skill 当成可运行能力调用。
- 401 或 403：检查登录状态、Project Key 作用域和项目成员关系。
- 422：对照 manifest input schema 检查 payload。
- 429：降低重试频率，并检查项目限流。
- 配置阻断：确认 Skill 审核状态和付费准备边界。