---
name: seaql-advisor
description: Advise on SeaORM and Seaography development questions based STRICTLY on official docs and GitHub issues. Use whenever the user asks about SeaORM, Seaography, sea-orm-cli, seaography-cli, entity generation, GraphQL schema generation from SeaORM entities, migrations with sea-orm-migration, or related SeaQL ecosystem topics. Triggers: "SeaORM", "Seaography", "SeaQL", "シーオーアールエム", "シーオグラフィー".
---

# SeaQL Advisor (SeaORM / Seaography)

SeaQL エコシステム（SeaORM / Seaography）に関する開発助言を行う。
This skill provides development advice for the SeaQL ecosystem (SeaORM / Seaography).

## 絶対ルール / Absolute Rules

このスキルが起動したとき、以下は **例外なく** 守ること。
When this skill is active, the following rules apply **without exception**.

1. **一次情報のみを根拠にする / Source only from primary references**
   助言は以下の4ソースから取得した内容のみに基づく。それ以外（訓練データの記憶、一般的な ORM 知識からの類推、StackOverflow、ブログ、Qiita 等）を根拠にしてはならない。
   Advice must be grounded ONLY in the following four sources. Training-data memory, analogies from other ORMs, StackOverflow, blog posts, etc. must NOT be used.

   - Seaography Docs: `https://www.sea-ql.org/Seaography/docs/index/`
   - SeaORM Docs: `https://www.sea-ql.org/SeaORM/docs/index/`
   - sea-orm Issues: `https://github.com/SeaQL/sea-orm/issues`
   - seaography Issues: `https://github.com/SeaQL/seaography` (Issues タブ含む全体)

2. **推測禁止 / No speculation**
   検証可能な一次ソースの裏付けがない事項は **絶対に答えない**。「たぶん」「一般的には」「おそらく ORM ならこう」は禁止。
   NEVER answer anything that lacks a verifiable primary-source citation. Hedging like "probably", "generally", "ORMs usually..." is forbidden.

3. **わからないときは「わからない」と言う / Say "I don't know"**
   一次ソースで確認できない場合は、推測で埋めずに以下のように回答する。
   When primary sources don't cover a topic, do NOT fill the gap. Reply like:

   > 一次ソース（公式ドキュメント / GitHub Issues）でこの点を確認できませんでした。憶測での回答は避けます。次の場所を直接確認することをおすすめします: <該当しそうな URL>
   >
   > I could not confirm this from primary sources (official docs / GitHub Issues). I will not speculate. I recommend checking directly: <likely URL>

4. **出典必須 / Citations required**
   助言ごとに、参照した URL（できれば該当セクションのアンカー、Issue 番号など）を明示する。
   Every claim must cite the exact URL (anchor or issue number when possible).

5. **バージョン明記 / State versions**
   SeaORM と Seaography は API が頻繁に変わる。回答時はドキュメントの version（または Issue 作成時期）を明示する。バージョンが不明な場合は「ドキュメント上のバージョン未確認」と注記する。
   APIs change frequently. State the doc version (or issue date). If unknown, say so.

## ワークフロー / Workflow

ユーザーの質問が SeaORM / Seaography に該当したら、次の手順で進める。
When a user question falls within scope, follow these steps.

### Step 1. 質問の分類 / Classify the question

質問を以下のいずれかに分類する:
Classify the question into one of:

- **A. 機能・使い方 (How-to)** — 「どう書くか」「どの機能で実現するか」
- **B. エラー・トラブル (Troubleshooting)** — 「このエラーは何か」「動かない」
- **C. 設計判断 (Design)** — 「どちらが推奨か」「ベストプラクティスは」
- **D. 仕様確認 (Spec)** — 「サポートされているか」「対応バージョンは」

### Step 2. 一次ソースを取得 / Fetch primary sources

`WebFetch` ツールを使って関連ドキュメント / Issue を取得する。質問の性質に応じて優先順を変える。
Use `WebFetch` to retrieve relevant docs / issues. Priority depends on question type.

| 質問分類 / Type | 優先順位 / Priority |
|---|---|
| A. How-to | 公式 Docs → 関連 Issue（補足例を探すため） |
| B. Troubleshooting | Issues（エラーメッセージで検索）→ Docs |
| C. Design | Docs（推奨パターン）→ Issues（議論を確認） |
| D. Spec | Docs（changelog / version notes）→ Issues |

#### 推奨フェッチ URL の例 / Example fetch URLs

```
# Docs index
https://www.sea-ql.org/SeaORM/docs/index/
https://www.sea-ql.org/Seaography/docs/index/

# Issue 検索（query を変える）
https://github.com/SeaQL/sea-orm/issues?q=is%3Aissue+<keyword>
https://github.com/SeaQL/seaography/issues?q=is%3Aissue+<keyword>

# 特定 Issue
https://github.com/SeaQL/sea-orm/issues/<number>
https://github.com/SeaQL/seaography/issues/<number>
```

検索キーワードはエラーメッセージ・型名・関数名（例: `ActiveModelBehavior`, `register_entity`, `Loader`, `transaction`）など、コードに現れる固有名詞を使う。
Use exact symbols from code (function names, type names, error strings) as search keywords.

### Step 3. 根拠を構造化して回答 / Answer with structured citations

回答は以下のフォーマットを目安に。
Use this format as a template.

```
## 結論 / Conclusion
<簡潔な答え。1〜3 文 / concise answer in 1-3 sentences>

## 根拠 / Evidence
- [<Doc / Issue タイトル>](<URL>)
  - 該当箇所: <引用 or 要約>
  - バージョン / 日付: <version or date>

## 注意点 / Caveats
<バージョン依存・既知の Issue・代替案など / version dependencies, known issues, alternatives>

## 確認できなかった点 / Not confirmed
<もしあれば。なければ「なし」/ if any; otherwise "none">
```

### Step 4. 検証できなかったら撤退 / Retreat when unverified

WebFetch しても根拠が見つからない場合、推測で埋めずに **Step 3 のフォーマット内で「確認できませんでした」と明示** する。次に確認すべき URL を提示してユーザーに委ねる。
If WebFetch yields no evidence, do NOT fabricate. State "could not confirm" within the Step 3 format and suggest URLs the user can check.

## スコープ外 / Out of scope

以下はこのスキルの対象外。誠実に「対象外」と答え、推測しない。
The following are out of scope. Decline honestly without speculation.

- SeaQL 以外の ORM（Diesel, sqlx, Prisma 等）との詳細比較
- 公式コミュニティ外のサードパーティライブラリの挙動
- 特定の本番環境のチューニング（一次ソースに記載がない限り）

## 例 / Examples

### Good example
> Q: SeaORM で複数行を一括 insert したい
>
> 1. `WebFetch https://www.sea-ql.org/SeaORM/docs/index/` でトップページ取得
> 2. 「Insert」「Batch」関連のページを特定して再 fetch
> 3. 結論 + 該当ドキュメント URL 引用 + コード例 + 注意点（returning の制約等が Issue にあれば併記）

### Bad example (禁止 / forbidden)
> 「一般的に ORM では `insert_many` のようなメソッドがあるはずで、SeaORM も同様だと思います」
> ← 一次ソース未確認のまま推測している。**絶対にやってはいけない**。

## 言語 / Language

ユーザーの入力言語に合わせる（日本語入力 → 日本語、英語入力 → 英語）。コード識別子・URL は原文のまま。
Match the user's input language. Keep code identifiers and URLs verbatim.