关于 integrating-providers
为 Claude Council 编写 AI 提供方集成的技能,说明如何添加可执行的 Shell 脚本、配置 API 密钥并测试。文档列出当前提供方及默认模型,并包含故障排查指引。
主要功能
- 01定义提供方脚本的输入输出约定
- 02说明创建和测试脚本的步骤
- 03列出 API 密钥变量与默认模型
- 04提供提供方发现及 API 错误排查
适用场景
- 01为 Claude Council 添加 AI 提供方
- 02按约定编写 Shell 提供方脚本
- 03配置密钥并验证提供方响应
- 04排查脚本未发现或响应解析失败
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hex/ claude-council --skill integrating-providers安装后在 Claude Code 中输入/integrating-providers确认已加载。
附带文件api-patterns.md
详细介绍
向 Claude Council 添加 AI 提供方
提供方脚本接口
每个提供方都是 scripts/providers/ 中的一个 shell 脚本,该脚本:
- 将提示词作为第一个参数
- 将 AI 响应输出到 stdout
- 成功时退出码为 0,失败时退出码非 0
快速入门
- 创建
scripts/providers/{name}.sh(模板请参阅api-patterns.md) - 执行
chmod +x scripts/providers/{name}.sh - 设置
{NAME}_API_KEY环境变量 - 测试:
./scripts/providers/{name}.sh "Hello"
当前提供方
| 提供方 | API 密钥变量 | 默认模型 |
|---|---|---|
| Gemini | GEMINI_API_KEY | gemini-3.1-pro-preview |
| OpenAI | OPENAI_API_KEY | gpt-5.5-pro |
| Grok | XAI_API_KEY(或 GROK_API_KEY) | grok-4.20-reasoning |
| Perplexity | PERPLEXITY_API_KEY | sonar-reasoning-pro |
故障排除
- 未被发现:检查是否已设置 API 密钥,以及脚本是否可执行
- API 错误:验证密钥,检查速率限制,并确认模型名称
- 解析失败:添加
echo "$RESPONSE"进行调试,并检查响应格式
参考
有关 API 模式和代码模板,请参阅此目录中的 api-patterns.md。
评论
支持 Markdown