用途：为 claude-council 接入新的 AI 提供商，配置提供商 API 设置，排查连接故障，并说明提供商脚本接口。
提供商脚本接口：每个提供商是 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" 测试。
当前提供商及对应密钥变量与默认模型：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。其他细节暂未提供。