关于 provider-integration
为 Claude Council 编写或接入 AI 提供方的 Agent 技能，说明 Shell 提供方脚本的接口、配置和测试方法，并列出 API 与 CLI 提供方的发现规则。
主要功能
- 01Shell 脚本提供方接口
- 02API 密钥与模型配置
- 03CLI 提供方发现规则
- 04故障排查与脚本测试
适用场景
- 01为 Claude Council 添加 API 提供方
- 02接入基于 CLI 的提供方
- 03排查提供方未发现或调用失败
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/provider-integration确认已加载。
附带文件api-patterns.md
详细介绍
向 Claude Council 添加 AI 提供商
提供商脚本接口
每个提供商都是 scripts/providers/ 中的一个 shell 脚本，该脚本：
- 将提示词作为第一个参数接收
- 将 AI 响应输出到 stdout
- 成功时以 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-flash-latest |
| OpenAI | OPENAI_API_KEY | gpt-6-astra |
| Grok | XAI_API_KEY（或 GROK_API_KEY） | grok-latest |
| Perplexity | PERPLEXITY_API_KEY | low（Agent API 预设） |
| Kimi | KIMI_API_KEY | kimi-k3 |
| Ollama | 无（本地） | ollama list 显示的第一个模型 |
| OpenRouter | OPENROUTER_API_KEY | anthropic/claude-fable-5.1（或为 OPENROUTER_MODELS 中的每个条目分配一个席位） |
CLI 提供商（codex、antigravity、grok-cli、kimi-cli、cursor-cli）无需密钥：当其二进制文件位于 PATH 中时，系统会发现它们，并使用相应 CLI 自身的登录状态。claude-cli 和 copilot-cli 是例外：每位用户的 PATH 中都有 claude，而每个 copilot 问题都会消耗一次高级请求，因此两者都没有发现机制，只会在 --providers 或 COUNCIL_PROVIDERS 中指定时加入。无头运行模式请参阅 scripts/providers/kimi-cli.sh 和 cursor-cli.sh：只读模式、从中解析答案的 JSON 输出格式、仅在显式设置 *_CLI_MODEL 时使用 --model，并以 run_with_deadline 代替 API 提供商的重试。CLI 超时或失败时，会通过 scripts/lib/cli-stderr.sh 中的 cli_failure_message 报告：显示超时信息，或显示 CLI stderr 的最后 500 个字节（已去除颜色代码）。
故障排除
- 未发现：检查是否已设置 API 密钥，以及脚本是否可执行
- API 错误：验证密钥、检查速率限制并确认模型名称
- 解析失败：添加
echo "$RESPONSE"进行调试，并检查响应格式
参考
API 模式和代码模板请参阅此目录中的 api-patterns.md。
评论
支持 Markdown