---
title: チームやリポジトリ間の情報の断絶を Skill で補う ~ BFF 情報取得 Skill による実例 ~
tags: 
author: [takanakahiko](https://www.docswell.com/user/takanakahiko)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/PJR958XR79.jpg?width=480
description: チームやリポジトリ間の情報の断絶を Skill で補う ~ BFF 情報取得 Skill による実例 ~ by takanakahiko
published: April 10, 26
canonical: https://www.docswell.com/s/takanakahiko/Z3JGY8-2026-04-10-195224
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/PJR958XR79.jpg)

チームやリポジトリ間の
情報の断絶を Skill で補う
~ BFF 情報取得 Skill による実例 ~
@Claude Code Meetup Japan #4


# Page. 2

![Page Image](https://bcdn.docswell.com/page/PEXQK86YJX.jpg)

誰?
名前 — takanakahiko
▸ 所属 — 株式会社U-NEXT
▸ ひとこと — 最近、崎陽軒のヌン茶が気になっている
▸
2


# Page. 3

![Page Image](https://bcdn.docswell.com/page/3EK95K14ED.jpg)

リポジトリ間の「壁」
Claude Code のスコープは 今いるリポジトリ
別リポジトリの知識が必要なとき、断絶 が生まれる
クライアント ─ ✕ ─ サーバー
リポジトリ
リポジトリ
API スキーマを確認したいのに見えない
▸ 移行元の実装を追いたいのに届かない
▸
3


# Page. 4

![Page Image](https://bcdn.docswell.com/page/L73WKZQD75.jpg)

4


# Page. 5

![Page Image](https://bcdn.docswell.com/page/87DK3R92JG.jpg)

断絶の中心にいる BFF
Web
iOS
GraphQL
─→ BFF ←─ 移行先
Android
その他
多くのチームが参照
スキーマや実装を確認したい
移行作業が進行中
GraphQL 側から BFF 実装を参照
5


# Page. 6

![Page Image](https://bcdn.docswell.com/page/VJPK4WZLE8.jpg)

読めるだけでは足りない
MCP（Serena 等）で別リポジトリのファイル自体は読める
しかし コンテキストがない
▸ どのファイルを読めばいいかわからない
▸ アーキテクチャの前提知識がない
▸ 手探りで 大量のトークンを浪費
→ 知識のパッケージング が必要
6


# Page. 7

![Page Image](https://bcdn.docswell.com/page/2EVVX8W6EQ.jpg)

提案: Skill で断絶を接続する
Web
iOS
─→
Android
その他
Skill
/bff-info
↓
GraphQL
←─
移行先
BFF
全チームが Skill 経由で BFF にアクセス
7


# Page. 8

![Page Image](https://bcdn.docswell.com/page/57GLV5D2EL.jpg)

Plugin として配布する
8


# Page. 9

![Page Image](https://bcdn.docswell.com/page/4EQY6Z19JP.jpg)

Skill が提供する 3 つの機能
bff-info 基本情報
skill 認証フロー・プロジェクト構成等 → 即コンテキストへ
source
agent
schema
agent
スキーマ取得
Swagger / OpenAPI を取得・加工 → 正確なAPI情報
ソースコード閲覧
clone → サブエージェントが解析 → 実装の深掘り
9


# Page. 10

![Page Image](https://bcdn.docswell.com/page/KJ4W436R71.jpg)

skill / agents / scripts の関係
skill → agents → scripts
skill ─ ( 直接 ) → scripts
agents に 解析を委譲（コンテキスト節約）することも
直接アクセスすることも可能。
10


# Page. 11

![Page Image](https://bcdn.docswell.com/page/LE1Y41VV7G.jpg)

Tips: skillを起点にする
allowed-tools
で agents や scripts の権限を纏めて確保
11


# Page. 12

![Page Image](https://bcdn.docswell.com/page/GEWGX8L3J2.jpg)

例: エンドポイントの移行
BFF の実装を参照しながら そのまま移行作業ができる
12


# Page. 13

![Page Image](https://bcdn.docswell.com/page/47ZL68MGJ3.jpg)

「断絶」を「接続」に
Skill = 知識 + スクリプト + エージェント
パッケージングすれば
どのチーム・どのリポジトリからでも
必要な情報にアクセスできる
BFF に限らず — 認証基盤、共通ライブラリ等
チームをまたぐ「参照先」 すべてに応用できる