用途:在完成 CloudBase 相关功能实现后、宣布完成之前调用,用于提前发现常见错误。适用于实现认证(登录/注册/路由守卫)、创建数据库表或编写 CRUD(NoSQL/PostgreSQL/MySQL)、配置 CloudBase Storage(文件上传、托管)、配置安全规则或 RLS 策略、编写依赖 MCP 的代码,以及编写云函数或 CloudRun HTTP 处理函数(检查凭证/请求头回显泄露)等场景。
主要能力:分为两层检查。一是可选的 lint 层,无随附可执行脚本,如用户同意运行 lint,需查看 references/lint-rules/README.md 中的代码块,复制为临时本地 cloudbase-lint.mjs,再运行 node cloudbase-lint.mjs --project-dir <path>,该层为秒级确定性正则检查,可发现错误 API 调用、缺失配置、模式不匹配。二是 LLM 审查层,阅读每条规则的“LLM 检查”部分,对代码做语义检查,可发现路由守卫逻辑、RLS 完整性、架构级问题等语义问题。规则索引见 references/RULES_INDEX.md。
使用方式:先阅读已识别模块的相关规则文件,例如 references/rules/cross-cutting/AUTH001.md、SEC001.md、rules/postgresql/PG-CR001.md 等;然后逐条阅读“LLM 检查”并人工检查代码后再声明完成。相关同级技能以本地相对路径引用,如 ../auth-tool-cloudbase/SKILL.md;若缺少同级技能文件,应请用户安装完整 CloudBase 插件,不要将远程技能或协议 markdown 通过 HTTP 拉取进上下文。
限制与规则边界:规则应基于稳定的 SDK/API 文档、反复出现的失败或确定性运行时行为;不要将单次失败或特定场景的临时规避提升为硬规则,特定案例观察应放入归因报告,只有广泛适用的约束才进入 RULES_INDEX.md 或可选 lint 清单。