SuperAPI AI 工具集

sdk-config-validator

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:校验 Claude Agent SDK 项目的配置文件、环境搭建、依赖与项目结构,适用于用户反馈“校验 SDK 设置”“检查 SDK 配置”“SDK 无法工作”、出现初始化或导入错误,或在新项目开始 SDK 开发前、安装依赖后验证正确性。

主要能力:校验 TypeScript/Python SDK 配置文件;检查 SDK 版本兼容性与依赖;验证 .env 环境变量;校验项目结构与必需文件;生成带可执行修复建议的校验报告;提供常见配置模板。

使用方式: 基本校验:bash scripts/validate-typescript.sh /path/to/project;bash scripts/validate-python.sh /path/to/project;bash scripts/check-sdk-version.sh /path/to/project。 环境校验:bash scripts/validate-env-setup.sh /path/to/project。 生成模板:cp templates/.env.example.template /path/to/project/.env.example;cp templates/tsconfig-sdk.json /path/to/project/tsconfig.json;cp templates/pyproject-sdk.toml /path/to/project/pyproject.toml。

工作流程:检测项目类型(package.json 或 pyproject.toml)、运行对应校验脚本、检查依赖版本、校验环境变量、生成报告、提供应用修复建议。

可检测的常见问题:包名错误(anthropic-agent-sdk 应为 claude-agent-sdk)、缺少 SDK 依赖、TypeScript 编译选项不正确、缺少必需环境变量(如 ANTHROPIC_API_KEY)、使用 MCP 服务器时缺少 FastMCP Cloud API key、MCP 传输类型错误(FastMCP Cloud 应使用 http 而非 sse)、SDK 版本与 Node/Python 不兼容、缺少配置文件、模块解析设置错误、Python 代码缺少 async/await。

退出码:0 表示全部通过;1 表示存在配置错误;2 表示严重错误(缺少 SDK、结构无效)。

限制:具体支持版本、模板细节与报告格式暂未提供;示例见 examples/ 目录。