リソース

AI アシスタントとの連携

公式 Wealth Reader スキルを開発用アシスタントにインストールすると、このドキュメントに従ってウィジェット、callback、データ更新の連携を生成できます。

スキルとは

スキルは SKILL.md ファイルを含むフォルダーです。AI アシスタントは説明に合うタスクでこれを読み込みます。Wealth Reader はオープン形式の Agent Skills として、MIT ライセンスで公開リポジトリ https://github.com/Wealth-Reader/wealthreader-skills に提供しています。

wealthreader-integration スキルの対象:

ウィジェットとバックエンド callback の連携。
ネイティブアプリ向けのリダイレクト認証（OAuth）。
接続の token を使ったデータ更新とエラー処理。

決済開始や銀行コネクターの開発は対象外です。また、顧客登録の代わりにはなりません。クライアントエリアで api_key、許可済みドメイン、callback URL を設定する必要があります。

同じフォルダーを Claude Code、Codex、Cursor、Antigravity、Gemini CLI、GitHub Copilot、Grok Build、Windsurf、OpenCode、Amp、Cline、Roo Code、Kiro、および SKILL.md を読む他の AI アシスタントで使用できます。

コマンド 1 つでインストール

npx skills add Wealth-Reader/wealthreader-skills

インストーラーが利用中のアシスタントを検出し、スキルのコピー先を選べます。各ツール独自のインストーラーも使用できます。

# GitHub CLI
gh skill install Wealth-Reader/wealthreader-skills wealthreader-integration --agent claude-code --scope user

# Gemini CLI
gemini skills install https://github.com/Wealth-Reader/wealthreader-skills.git --consent

# Amp
amp skill add https://github.com/Wealth-Reader/wealthreader-skills --global

手動インストール

リポジトリ内の skills/wealthreader-integration/ フォルダーをアシスタントが読むディレクトリにコピーし、新しいセッションを開きます。.agents/skills/（プロジェクト）と ~/.agents/skills/（ユーザー）は、多くの AI アシスタントが読む共通パスです。Claude Code、Cline、Kiro は各ツール専用のディレクトリのみを読みます。

AI アシスタント	プロジェクトのディレクトリ	ユーザーのディレクトリ	呼び出し方
Claude Code	`.claude/skills/`	`~/.claude/skills/`	`/wealthreader-integration` または自動
Codex (CLI, IDE, ChatGPT)	`.agents/skills/`	`~/.agents/skills/`	`$wealthreader-integration` または `/skills`
Cursor	`.agents/skills/` または `.cursor/skills/`	`~/.agents/skills/` または `~/.cursor/skills/`	選択メニュー `/` または自動
Antigravity	`.agents/skills/`	`~/.gemini/config/skills/`	スキル名を指定
Gemini CLI	`.agents/skills/` または `.gemini/skills/`	`~/.agents/skills/` または `~/.gemini/skills/`	自動; `/skills list`
GitHub Copilot	`.agents/skills/` または `.github/skills/`	`~/.agents/skills/` または `~/.copilot/skills/`	自動
Grok Build	`.grok/skills/` (こちらも読み込み `.claude/skills/`)	`~/.grok/skills/` または `~/.agents/skills/`	`/wealthreader-integration`
Windsurf	`.agents/skills/` または `.windsurf/skills/`	`~/.agents/skills/` または `~/.codeium/windsurf/skills/`	`@wealthreader-integration`
OpenCode	`.agents/skills/` または `.opencode/skills/`	`~/.agents/skills/` または `~/.config/opencode/skills/`	自動
Amp	`.agents/skills/`	`~/.agents/skills/` または `~/.config/agents/skills/`	自動
Cline	`.cline/skills/` (こちらも読み込み `.claude/skills/`)	`~/.cline/skills/`	`/wealthreader-integration`
Roo Code	`.agents/skills/` または `.roo/skills/`	`~/.agents/skills/` または `~/.roo/skills/`	自動
Kiro	`.kiro/skills/`	`~/.kiro/skills/`	`/wealthreader-integration`

これらのパスは 2026 年 9 月 5 日に各ツールの公開ドキュメントで確認しました。最新の表はリポジトリの README にあります。

使用方法

アプリの言語とフレームワークを指定して連携を依頼します。依頼例:

wealthreader-integration スキルを使って、アプリに Wealth Reader のウィジェットとバックエンド callback を追加してください。口座と取引を取得し、実際の銀行リクエストを行わずにローカルでテストしてください。

このスキルは、他のオープンバンキング API や OAuth から推測するのではなく、このガイドに記載された仕様に従うよう AI アシスタントを導きます。フローごとに対応するページを読みます。

ウィジェットと callback: iframe: フロントエンドと iframe: バックエンド。
リダイレクト: OAuth: バックエンド。
データ更新とエラー: API リファレンスとエラー一覧。

検証すること・しないこと

合成データとウィジェットのテストユーザー（MOCKDATA、MOCKOTP、MOCKLOGINKO）を使ってローカルテストを生成します。実際の銀行接続を独自に実行しません。
callback のデータを永続化してから {"status":"ok"} を返すこと、postMessage をオリジンで絞り込むこと、無効な認証情報で再試行ループに入らないことを確認します。
callback の真正性など、このドキュメントで規定していない本番環境の制御は、推測せずに未確定事項として示します。本番稼働前にサポートと解決してください。

スキルがチャットで api_key やトークンを要求することはありません。秘密情報はサーバーに保持し、フロントエンド、ログ、リポジトリに含めないでください。ローカルテストの成功は、実際の銀行接続の動作を証明するものではありません。

メンテナンス

スキルは公開ドキュメントのみを基に作成され、各仕様の出典へリンクしています。このガイドと不一致があれば、リポジトリに issue を作成してください。

最終更新 2026-09-10