cloudbase-code-review

同级技能（仅本地）

同级 CloudBase 技能与此技能一同提供。请使用 ../auth-tool-cloudbase/SKILL.md 这样的本地相对路径。

如果此环境中缺少所引用的同级技能文件，请让用户安装完整的 CloudBase 插件（或缺失的技能）。不要通过 HTTP 将远程技能或协议 Markdown 获取到 Agent 上下文中。

CloudBase 代码审查

一句话简介：完成 CloudBase 功能实现后，调用此技能，在用户发现常见错误之前将其找出。

何时使用

完成 CloudBase 实现任务后、宣布任务完成前，调用此技能：

• 实现了身份验证（登录 / 注册 / 路由守卫）
• 创建了数据库表或编写了 CRUD（NoSQL / PostgreSQL / MySQL）
• 设置了 CloudBase Storage（文件上传、托管）
• 配置了安全规则或 RLS 策略
• 编写了依赖 MCP 的代码
• 编写了 Cloud Function 或 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。

规则边界

不要将单次失败运行或特定案例的变通方案提升为硬性规则。规则应有稳定的 SDK/API 文档、重复出现的失败或确定性的运行时行为作为依据。特定案例的观察应归入归因报告；只有普遍适用的约束才应纳入 RULES_INDEX.md 或可选的 lint 检查清单。

快速开始

# Step 1: Read relevant rules for identified modules
#   references/rules/cross-cutting/AUTH001.md
#   references/rules/cross-cutting/SEC001.md
#   references/rules/postgresql/PG-CR001.md
#   ...

# Optional: if the user approves running lint, review the script code block in
# references/lint-rules/README.md, copy it to a temporary cloudbase-lint.mjs,
# then run: node cloudbase-lint.mjs --project-dir .

# Step 2: For each applicable rule, read the "LLM 检查" section
#         and manually inspect your code before claiming done.

规则格式

每个规则 .md 文件都遵循以下结构：

# RULE-ID Rule Name

- **Module**: which module (auth / postgresql / storage / ...)
- **Severity**: error | warning
- **Stage**: code-generation | deployment | config

## 正则检查 (Lint)

The condition checked by the optional script code block in `references/lint-rules/README.md`.

## LLM 检查

Semantic review prompt for human or LLM to evaluate.

## 修复指引

How to fix the issue.

参考索引

所有随附的参考文件（技能 lint 可达性所必需）：

• RULES_INDEX.md
• lint-rules/README.md
• rules/cross-cutting/AUTH001.md
• rules/cross-cutting/SEC001.md
• rules/cross-cutting/SKILL001.md
• rules/postgresql/PG-CR001.md
• rules/postgresql/PG-CR002.md
• rules/postgresql/PG-CR003.md
• rules/postgresql/PG-CR004.md
• rules/postgresql/PG-CR005.md
• rules/storage/STORAGE001.md