SuperAPI AI 工具集

cloudbase-code-review

测试与质量

查看项目

更新于 10-16 08:11

技能介绍

用途:这是 CloudBase 项目的代码审查与校验技能,适用于在完成 CloudBase 功能实现后、宣布完成之前调用,用于在用户之前发现常见错误。触发场景包括:实现认证(登录/注册/路由守卫)、创建数据库表或编写 CRUD(NoSQL/PostgreSQL/MySQL)、配置 CloudBase Storage(文件上传、托管)、配置安全规则或 RLS 策略、编写依赖 MCP 的代码、编写云函数或 CloudRun HTTP 处理程序(检查凭证与响应头回显泄露)。

主要能力:技能分两层运行。第一层为可选 Lint,不附带可执行脚本;若用户同意运行,需阅读 references/lint-rules/README.md 中的代码块,复制为临时本地 cloudbase-lint.mjs,然后运行 node cloudbase-lint.mjs --project-dir <path>,可做确定性正则检查,如错误 API 调用、缺失配置、模式不匹配,耗时数秒。第二层为 LLM 语义审查,阅读每条规则的“LLM 检查”部分,人工检查代码,可发现路由守卫逻辑、RLS 完整性、架构级问题等语义问题。完整规则矩阵见 references/RULES_INDEX.md(模块 × 前端类型 → 适用规则)。

规则格式:每条规则 .md 文件包含 Module(auth/postgresql/storage 等)、Severity(error|warning)、Stage(code-generation|deployment|config),以及“正则检查(Lint)”“LLM 检查”“修复指引”三部分。

使用方式:第一步,针对已识别模块阅读相关规则,如 cross-cutting/AUTH001.md、cross-cutting/SEC001.md、postgresql/PG-CR001.md;第二步,对每条适用规则阅读其“LLM 检查”部分并人工检查代码后再声明完成。

限制与边界:兄弟技能仅本地提供,使用 ../auth-tool-cloudbase/SKILL.md 之类的相对路径;若缺失请用户安装完整 CloudBase 插件,不要通过 HTTP 抓取远程技能或协议 Markdown。不应把单次失败或个案绕过提升为硬规则,规则须有稳定 SDK/API 文档、重复失败或确定性运行时行为支撑,个案观察归入归因报告。