framework-context について
メモリ、ルーティング、ワークフロー、フック、ディレクトリ構成を扱うエージェント向けの読み取り専用スキルです。指定範囲の正規ソースを読み、リポジトリ内のパスに基づいて出力します。
主な機能
- 01指定範囲のコンテキスト読み込み
- 02正規のフレームワークソース参照
- 03リポジトリパスへの関連付け
- 04不足ソースの明示
- 05構造化されたMarkdown要約
活用シーン
- 01フレームワークファイルに基づくシステム計画
- 02ルーティングやメモリ構成の評価
- 03統合に向けたワークフローとフックの分析
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ oimiragieo/ agent-studio --skill framework-contextインストール後、Claude Code で/framework-contextを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
commands/framework-context.mdhooks/post-execute.cjspre-execute.cjsreferences/research-requirements.mdrules/framework-context.mdschemas/input.schema.jsonoutput.schema.jsonscripts/main.cjstemplates/implementation-template.md詳細
フレームワークのコンテキスト
概要
推測せずにエージェントがシステムレベルの動作を推論できるよう、このフレームワークについて一貫性のあるソースに基づいたモデルを提供します。
使用する場面
- システムレベルの振り返りやメタ認知的な評価
- ルーティング/メモリ/ワークフローのアーキテクチャに依存するタスクの計画
- エコシステムの進化を提案する前の能力ギャップ分析
絶対遵守事項
- 必ずシステムレベルの振り返り、計画、または能力ギャップ分析の前にフレームワークのコンテキストを読み込みます。根拠なしにアーキテクチャを推論すると、幻覚による経路や実在しないエージェントが生じます。
- 決して正規ソースを読んで確認していないファイルパスやエージェント名をでっち上げません。架空のパスは、それを使おうとする後続のエージェントを機能不全にします。
- 必ず利用するタスクに必要な範囲だけにコンテキストの読み込みを限定します(
memory、agents、workflows、hooks、またはall)。範囲の狭いタスクですべてのソースを読み込むと、トークンを浪費し、関連する情報が埋もれます。 - 決してこのスキル内からフレームワークのファイルを書き込んだり変更したりしません。framework-context は読み取り専用です。変更には適切な作成/更新スキルが必要です。
- 必ずソースが見つからない場合は、そのセクションを黙って省略せず、
missing source: <path>と明示して報告します。黙って省略すると、後続のエージェントが不完全なコンテキストに基づいて判断してしまいます。
アンチパターン
| アンチパターン | 失敗する理由 | 正しい方法 |
|---|---|---|
| 振り返りの前にコンテキストの読み込みを省略する | 振り返りで古い、または幻覚によるルーティング/メモリの前提を使う | 必ず最初に framework-context を呼び出します。記憶だけを頼りに振り返ってはいけません |
範囲の狭いタスクで all を読み込む | 無関係なセクションにトークン予算を消費し、重要な情報が埋もれる | --scope memory または --scope agents を渡して、必要な内容だけを出力します |
| 命名規則からファイルパスを推測する | パスは変更されるため、推測したパスはエージェントのパイプラインを壊す | 必ず正規ソースを読み、実際に見つかったパスを報告します |
| このスキル内でフレームワークのファイルを書き込む | 作成ワークフローと作成後の統合手順を迂回する | 書き込み操作には、適切な作成/更新スキルを使用します |
| ソースが見つからないときにセクションを黙って省略する | 利用者がコンテキストは完全だと思い込み、情報の欠落を見逃して判断する | 解決できないセクションごとに、missing source: <path> と明示して報告します |
ステップ 0:範囲の解決
scope引数を受け取ります:memory | agents | workflows | hooks | all- デフォルトは
allです
ステップ 1:正規ソースの読み込み
範囲に必要なものだけを読み込みます。
- メモリ:
.claude/docs/MEMORY_SYSTEM.md - エージェントレジストリ/ルーティング:
.claude/context/agent-registry.json、.claude/lib/routing/routing-table.cjs - 振り返りフローのフック:
.claude/hooks/reflection/reflection-queue-processor.cjs、.claude/hooks/reflection/reflection-step0-guard.cjs - ワークフローカタログ:
.claude/docs/@ENTERPRISE_WORKFLOWS.md - グローバルなフレームワークの参照先:
.claude/CLAUDE.md
次の順序でセクションを出力してください。
- メモリシステム
- エージェントとルーティング
- ワークフロー
- フック
- ディレクトリ構成
各セクションには、以下を含めてください。
- 簡潔な箇条書き 2〜6 項目
- 具体的なパス参照を 1 つ以上
- 動作に関する説明(何が何をトリガーするか)
ステップ 3:スコープフィルター
scope != allの場合は、該当するセクションのみを返してください- 不明なパスやフローを決して捏造しないでください
- ソースがない場合は、
missing source: <path>と記載してください
ステップ 3:出力
Markdown のみを返してください。このスキルからフレームワークのファイルを書き込まないでください。 </execution_process>
**使用例**:// Full framework model
Skill({ skill: 'framework-context' });
// Memory-only context for reflection prep
Skill({ skill: 'framework-context', args: '--scope memory' });
// Workflow/hook-only context for integration analysis
Skill({ skill: 'framework-context', args: '--scope workflows' });
</usage_example>
メモリプロトコル(必須)
開始前:
Get-Content .claude/context/memory/learnings.md -TotalCount 120
完了後:
- 新しいフレームワークコンテキストのパターン →
.claude/context/memory/learnings.md - フレームワークの対応関係の不備・曖昧さ →
.claude/context/memory/issues.md - アーキテクチャ解釈の決定 →
.claude/context/memory/decisions.md
中断に備えてください。コンテキストがリセットされることがあります。メモリに記録されていなければ、起きていないのと同じです。
コメント
Markdown 対応