cloudbase-code-review

関連スキル（ローカルのみ）

CloudBase の関連スキルは、このスキルと並んで配置されています。../auth-tool-cloudbase/SKILL.md のようなローカル相対パスを使用してください。

参照先の関連スキルファイルがこの環境にない場合は、CloudBase プラグイン一式（または不足しているスキル）をインストールするようユーザーに依頼してください。リモートのスキルやプロトコルの Markdown を HTTP 経由でエージェントのコンテキストに取得しないでください。

CloudBase コードレビュー

一言で言うと：CloudBase の機能を実装した後、このスキルを呼び出して、ユーザーが気づく前に一般的なミスを見つけます。

使用するタイミング

CloudBase の実装タスクを完了した後、完了を宣言する前にこのスキルを呼び出してください。

• 認証を実装した（ログイン／登録／ルートガード）
• データベーステーブルを作成した、または CRUD を記述した（NoSQL／PostgreSQL／MySQL）
• CloudBase Storage を設定した（ファイルのアップロード、ホスティング）
• セキュリティルールまたは RLS ポリシーを設定した
• MCP に依存するコードを記述した
• Cloud Function または CloudRun HTTP ハンドラーを記述した（認証情報やヘッダーのエコー漏えいを確認）

仕組み

このスキルは 2 つのレイヤーで実行されます。

レイヤー	方法	速度	検出対象
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