shuji-bonji/houki-research-skill

houki-hub MCP family を **横断的に**使うときの行動指針を Claude に与える **Claude Skill**。日本の **全法規 (法律・政令・省令・通達・判例・裁決・行政解釈)** を、「法律 → 政令 → 省令 → 通達 → 改正 + 添付 PDF → 行政解釈 → 判例 → 裁決」の階層に**正しい順序で参照しながら**回答するためのオーケストレーション層。
> [!NOTE]
> **スコープ**: 税務 (税理士法) に限らず、**労務 (社労士法)・登記 (司法書士法)・法律事務全般 (弁護士法)** など分野を問わず日本の法令を扱う。現状は family の MCP が houki-egov-mcp (法律本文) + houki-nta-mcp (税務通達) + pdf-reader-mcp (PDF 抽出) なので税務の例が多いが、将来 houki-mhlw-mcp (厚労省) / houki-saiketsu-mcp (裁決) / houki-court-mcp (判例) が加わっても本スキルの行動指針は変わらない設計。
何を提供するのか
提供するのは、**Claude が houki-hub の MCP を横断して使うときに従う行動方針**です。日本の法令を調べて答えるまでの、呼ぶ順序・出典の書き方・止めどころを Markdown で書いたもので、Claude が SKILL.md を読んで従います。
決めているのは次の 4 つです。
| 行動方針 | 何を決めているか |
| --- | --- |
| ① 業法独占規定への注意喚起 | 個別事案への当てはめに触れたとき、何を返し、何を返さず、誰に案内するか |
| ② 横断オーケストレーション | どの MCP をどの順で呼ぶか。略称の解決を最初に置き、法律 → 政令・省令 → 通達 → 改正履歴 → 添付 PDF → 判例・裁決 と辿る |
| ③ citation の標準化 | 出典の書式と、法令・通達・参考情報の拘束力の階層をどう示すか |
| ④ 業務外利用の境界設定 | 参考調査として答えてよい範囲と、業としての相談にあたる範囲の線引き |
エラーの code（OUT_OF_SCOPE など）を受け取ったときの解釈もこの Skill が決めます。code の定義の正本は各 MCP の仕様（specs/current/common_errors/spec.md）で、この Skill の docs/ERROR-CODES.md はそれをまとめた一覧です。
> [!NOTE]
> MCP server ではありません。houki-egov-mcp などは別リポジトリで、この Skill が決めるのは **それらを呼ぶ順序と、答えの書き方** です。配布は plugin で、shuji-bonji/claude-plugins の marketplace から導入できます (経路は インストール に 4 つ)。
なぜ MCP ではなく Skill なのか
Architecture E の「**単一 MCP に責務を集中させない**」原則に基づきます:
- MCP は機械的な fetch + parse に専念
- 複数 MCP を跨ぐロジックを 1 つの MCP に寄せると、その MCP が family の hub になり Architecture E が崩れる
- 業法独占規定への注意喚起のような **人間向けの判断補助** は MCP の責務外
詳細は skills/houki-research/docs/ARCHITECTURE.md。
インストール
クライアントごとに 4 つの経路があります。
| 経路 | 対象 | 手間 | 推奨度 |
| ------------------- | ----------------- | ---- | -------------------------- |
| A. 手動 clone | Claude Code | 小 | 動作確認・編集したい人向け |
| B. .plugin Upload | Cowork (個人) | 最小 | **推奨 (個人 Cowork)** |
| C. marketplace 経由 | Claude Code | 最小 | **推奨 (Claude Code)** |
| D. Org marketplace | Cowork Enterprise | 中 | 組織管理者のみ |
A. 手動 clone (Claude Code)
その後、Claude Code で「houki-research skill を使って」と明示すると skill が起動します。
B. Cowork (個人ユーザー・推奨)
個人の Cowork ユーザーは marketplace URL の追加 UI を持たないため、.plugin ファイルを直接アップロードする方式が標準です。
1. Releases から最新の houki-research-X.Y.Z.plugin をダウンロード
2. Claude Desktop アプリを開き、Cowork タブへ
3. サイドバーの **Plugins** をクリック
4. **「Upload plugin」** ボタン (または「+」アイコン) から先ほどの .plugin ファイルを選択
5. 有効化
> アップロードした plugin はあなたのマシンにローカル保存されます。組織で共有したい場合は経路 D を参照。
C. Claude Code (marketplace 経由・推奨)
v0.7.0 から houki-egov-mcp と houki-nta-mcp を dependencies に宣言しているため、この 1 コマンドで条文と通達の両方を引ける状態になります。有効化も連動します。
ただし、入っただけでは全文検索は効きません。houki-egov-mcp は約 290 MB、houki-nta-mcp は 6 種別で約 100 分の取り込みが要ります。下記「前提となる MCP 群」のあとに続く各リポジトリの README を参照してください。
D. Cowork Enterprise (組織管理者向け)
組織で全社員に配布したい場合は、Organization Settings から marketplace URL を登録します。**この機能は Enterprise admin のみ**が利用できます。
1. Organization Settings → Plugins → **「Add plugin」**
2. Source として **GitHub** を選択
3. URL に https://github.com/shuji-bonji/claude-plugins を入力
4. 利用許可するチームに per-user provisioning または auto-install を設定
詳細: Manage Claude Cowork plugins for your organization
前提となる MCP 群
この節は、Skill を使う前に Claude に登録しておく MCP と、その版を確かめるためのものです。
| MCP / パッケージ | 要否 | 推奨バージョン | 動作する最低バージョン | リンク |
| ---------------------------------- | ---- | -------------- | ---------------------- | ------ |
| @shuji-bonji/houki-egov-mcp | 必須 | v0.20.0 以上 | v0.2.0 | npm · GitHub |