Reflection Skills MCP

🚀 Reflection Skills MCP

Reflection Skills MCP はオープンソースの モデルコンテキストプロトコル (MCP) サーバー で、開発者向けの精選された一連の リフレクションフレームワーク、演習、およびプロンプトパック を提供します。

このサーバーは以下の用途で使用することを想定しています。

• 日記やリフレクションアプリ (Jots など)
• コーチングやメンタリングエージェント
• 開発者の生産性向上ツール
• 振り返りツール
• 個人用エージェントワークフロー

サーバーは、構造化された、証拠に基づくリフレクションガイダンス を返す MCP ツールを公開しており、深さとコンテキストに応じて設定可能です。

v1 は品質と一貫性を維持するため、10枚の高効果カード に限定されています。

🚀 クイックスタート

このリポジトリは、MCP サーバーを使って構造化されたリフレクションガイダンスを提供するためのものです。以下に、サーバーをローカルで実行する方法を説明します。

インストールとビルド

npm install
npm run build
node packages/server/build/index.js

設定

MCP ホスト (Claude Desktop、VS Code など) を次のように設定します。

{
  "command": "node",
  "args": ["ABSOLUTE_PATH/packages/server/build/index.js"]
}

ホスティングは不要です。本番環境では、この MCP サーバーを Streamable HTTP を介したリモート MCP サービスとして使用することができます。

✨ 主な機能

リポジトリの構成

これは4つの主要な要素を持つ モノレポ です。

1. スキーマ – 共有される JSON スキーマと TypeScript 型
2. データセット – 精選されたリフレクション「カード」と検索インデックス
3. サーバー – リフレクションツールを公開する MCP サーバー
4. ツール – CLI、評価、サンプル、および CI

reflection-skills-mcp/
├─ docs/ # 公式ドキュメント
├─ packages/
│ ├─ schema/ # スキーマ + TS 型
│ ├─ dataset/ # カード + インデックス
│ ├─ server/ # MCP サーバー (stdio / HTTP)
│ ├─ cli/ # ローカルランナー + ユーティリティ
│ ├─ evals/ # 検索品質評価
│ └─ examples/ # クライアントサンプル
└─ .github/workflows/ # CI

「カード」とは

カード は、リフレクション知識の小さな構造化された単位です。

• フレームワーク (例: SBAR、トレードオフ分析)
• 演習 (例: 5 Whys)
• プロンプトパック (例: 日次パルス)

各カードは次の特徴を持ちます。

• 短く実行可能
• 開発者向けの言語で記述
• 小さく固定されたタグセット でタグ付け
• 再利用可能なライセンス

開発者向けタグ (v1)

incident · decision · collaboration · shipping · learning · debugging

公開されている MCP ツール

サーバーは以下の MCP ツールを公開しています。

reflection.search_cards

クエリ、タグ、またはタイプでカードを検索します。

reflection.get_card

ID で完全なカードを取得します。

reflection.recommend

シグナル (焦点領域、ユースケース) と設定に基づいてカードを推薦します。

reflection.daily_pulse

日次パルスメッセージ + 小さなプロンプト + 推薦カードを生成します。

すべてのツールは、以下の特徴を持ちます。

• 部分的な設定 を受け付けます。
• 適切なデフォルト値 を適用します。
• ユーザー固有のデータを必要としません。

詳細は を参照してください。

設定モデル

すべてのツールは、オプションの ReflectionContextConfig オブジェクトを受け付けます。 以下の項目を制御できます。

• 深さ (quick | standard | deep)
• 対象レベル (junior | mid | senior | staff_plus)
• 焦点次元 (明確性、トレードオフ、学習など)
• 時間予算
• 出力サイズ
• ユースケース (リフレクション後、日次パルス、週次レビュー)

設定が提供されない場合、安全なデフォルト値が適用されます。

スキーマは以下にあります。 packages/schema/json/ReflectionContextConfig.schema.json

データセット (v1)

v1 は正確に 10 枚のカードを含んでいます。

frameworks/
exercises/
prompt-packs/
studies/ (予約済み、v1 では空)

カードは以下にあります。 packages/dataset/cards/v1/

インデックスは以下で事前計算されています。 packages/dataset/indexes/cards.index.json

詳細は docs/dataset-guide.md と docs/card-authoring.md を参照してください。

評価

このリポジトリには、回帰を防ぐための軽量な検索評価が含まれています。

• 入力: packages/evals/cases/v1.jsonl
• 指標: precision@k, recall@k

実行方法:

npm --prefix packages/evals run evals

詳細は docs/evals.md を参照してください。

📚 ドキュメント

潜在的なユースケース

Reflection Skills MCP は意図的に汎用的かつ再利用可能に設計されています。一般的なユースケースは以下の通りです。

• 日記やリフレクションアプリ 独自のコンテンツエンジンを構築することなく、構造化されたリフレクションガイダンス、日次パルス、およびフレームワークを提供します。
• コーチングやメンタリングエージェント 一貫したリフレクションフレームワークを持つ「サポートバディ」、「シニアエンジニア」、または「リード」のペルソナを実現します。
• 開発者の生産性向上ツール 既存のワークフローに PR 後、インシデント後、または日終わりのリフレクションプロンプトを追加します。
• 振り返りとチーム学習 共有言語と構造を持つ軽量な振り返り、事後調査、および決定レビューをサポートします。
• 個人用エージェントワークフロー MCP を介してローカルまたはリモートのエージェント設定にリフレクション知識レイヤーとして組み込みます。

MCP はステートレスでオープンソースであり、ユーザーデータへのアクセスを必要としないため、多くのコンテキストで安全に統合できます。

このリポジトリではないもの

❌ 日記アプリ ❌ パーソナライゼーションエンジン ❌ 心理療法やメンタルヘルスシステム ❌ ホスト型 SaaS

これはポータブルなリフレクション知識サーバーです。

コントリビューション

コントリビューションは歓迎されますが、意図的に範囲が限定されています。 以下を読んでください。

• CONTRIBUTING.md
• docs/card-authoring.md

v2 の拡張は、最初にイシューを介して提案する必要があります。

📄 ライセンス

• コード は MIT ライセンス の下でライセンスされています。
• リフレクションカードのコンテンツ (フレームワーク、演習、プロンプトパック) は CC BY 4.0 の下でライセンスされています。

このリポジトリで参照されているフレームワークは業界標準の方法です。元のフレームワークは独自の作品として主張されておらず、カードの選定、構造、および表現のみがここでライセンスされています。