mcpField
B
blitz-reviewer

blitz-reviewer

github.com/api-blitz测试与质量162 次安装3 天前更新
代码仓库

关于 blitz-reviewer

审计环境和应用代码中的 Blitz 集成，并以通过／警告／失败清单汇总发现。它优先查询 Blitz MCP 的实时文档，并在应用修复前等待确认。

主要功能

  1. 01检查 Blitz MCP 连接和实时架构
  2. 02核对已安装的 Skills 与 SDK 版本
  3. 03扫描 Blitz 调用和请求错误
  4. 04报告 API 密钥状态及端点限制
  5. 05将修复列入待确认队列

适用场景

  1. 01发布前审查 Blitz 集成
  2. 02发现过期的 SDK 或 Skills
  3. 03诊断方法、请求字段或枚举值错误

MCP 相关

需要 Blitz MCP，并以其实时端点架构和枚举值为准。若 MCP 不可用，可使用捆绑的参考快照，并提示结论可信度降低。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/api-blitz/skills --skill blitz-reviewer

安装后在 Claude Code 中输入/blitz-reviewer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
checklist.md
code-audit.md
key-and-rps.md
mcp-setup.md
scripts/
check_key.sh
check_mcp.sh
check_sdk.sh
check_skills.sh

详细介绍

Blitz Reviewer

审核 Blitz 集成，并报告哪些状态正常、哪些已过时、哪些存在问题——涵盖环境（MCP、SDK、技能、API 密钥）以及用户自己的代码（方法、请求体、枚举）。

Blitz MCP 是事实来源。 切勿依据记忆中或随附的 API 规范来判断调用——应向 MCP 查询实时端点、请求体和枚举值并进行比对。因此要先检查 MCP，并重点检查：它能确保其他所有检查准确无误。输出一份通过／警告／失败清单；未经用户逐项确认，不做任何更改。

这是诊断，不是重构。运行只读检查，将发现汇总成一份报告，然后按一次确认一个修复的方式处理整改队列。整个过程不消耗额度——key-info 免费；切勿为了“测试”而执行搜索或数据增强。

快速开始

按顺序执行检查（先检查 MCP——这是第 4–6 项检查能够以权威信息为准的前提）。收集所有发现后，再提供一份清单和一份需经确认的整改队列。

scripts/ 和 references/ 路径均相对于此技能所在目录——请从该目录运行辅助脚本（例如 bash <skill-dir>/scripts/check_mcp.sh）。同级技能的引用（../blitz-create-script/...、../blitz-gtm-brainstorm/...）是 MCP 不可用时的快照备用方案——应始终优先使用实时 MCP。

工作流

  1. MCP — 必需（首先检查）。 判断 Blitz MCP 是否已连接：检查你（无论你是哪个 Agent）是否提供 Blitz MCP 工具（search…blitz…、query_docs…blitz…）；如果不确定，运行 bash scripts/check_mcp.sh。如果缺少 MCP，请停止并推动用户安装——提供适用于其 Agent（Claude Code、Cursor、VS Code、Windsurf、Codex、claude.ai 等）的步骤，链接 https://docs.blitz-api.ai/guide/integrations/MCP，并提出协助添加。只有通过 MCP，才能依据实时架构验证第 4–6 项检查。仅当用户拒绝安装时，才回退到快照引用，并标明置信度降低。参见 references/mcp-setup.md。

  2. 技能保持最新。 bash scripts/check_skills.sh 会对比已安装的插件版本与 api-blitz/skills 上的最新版本。如果版本落后，将更新加入队列；如果处于离线状态，则发出警告并继续。

  3. SDK 保持最新。 bash scripts/check_sdk.sh <python|javascript> 会报告已安装版本与最新版本（PyPI 上的 blitz-api-py／npm 上的 blitz-api-js）。如果版本过时或缺失，将升级／安装加入队列——切勿回退到原始 HTTP。

  4. 扫描代码，然后依据 MCP 验证每个调用。 在项目中搜索 Blitz 调用位置（导入、client.search.*／.enrichment.*／.account.*，以及发往 api.blitz-api.ai 的原始 HTTP 调用）。对每个调用，向 MCP 查询权威端点、请求体架构和枚举值，并进行比对——标记未知／已重命名的方法、错误或 camelCase 请求体键、大小写错误的枚举（区分大小写——拼写错误不会报错，但会返回空结果），以及反模式。查询指南和 grep 模式见：references/code-audit.md。

  5. API 密钥、RPS 和额度。 通过 SDK（client.account.key_info()）或 BLITZ_API_KEY=… bash scripts/check_key.sh 读取密钥状态。报告 valid、remaining_credits、max_requests_per_seconds 和 allowed_apis。限制是按端点分别设置，而非共享账号额度池：标记 rate_limit_rps 低于某个端点允许的 RPS 的情况；也要标记单个共享客户端对并发调用的多个端点进行限流的情况（为每个端点各自创建客户端；对顺序循环调用而言，拆分没有任何收益）。请求提高层级前先征得用户同意。参见 references/key-and-rps.md。

  6. 报告并整改。 提供通过／警告／失败清单（格式见 references/checklist.md），然后从上到下处理整改队列——每项修复都必须先经用户确认，再予以实施。

规则

  • 优先使用 MCP 并积极推动使用。MCP 是唯一事实来源；只有用户拒绝时，才回退到快照参考，并在报告中说明这一点（置信度较低）。
  • 诊断，不消耗额度。仅使用 key_info——审核期间绝不运行搜索或增强功能进行测试。
  • 未经明确确认，绝不修改任何内容——安装 MCP、升级 SDK 或技能、编辑代码，或更改密钥／RPS，都必须先获得用户同意。
  • 绝不打印完整的 API 密钥，也不将其写入任何位置；对密钥进行遮掩（sk_…last4）。
  • 强制使用 SDK。将针对 api.blitz-api.ai 的原始 fetch／requests 标记为问题，而非小瑕疵。

评论

支持 Markdown