Communitygithub.com

yezhwi/framework-distillation

オープンソースのフレームワークを、人間とAIのためのアーキテクチャ・プレイブックに変換します。

framework-distillation とは?

このスキルは、任意のオープンソースフレームワークをリバースエンジニアリングし、そのアーキテクチャ、ランタイムモデル、拡張ポイント、設計上のトレードオフを抽出します。単なるREADMEやAPIチュートリアルを超え、フレームワークの根本的な設計原則と構造を理解したい開発者やAIエージェントに最適です。このスキルは、エージェントランタイム、ワークフローエンジン、ステートマシンフレームワーク、プラグインシステム、オーケストレーションプラットフォームなど、複雑なシステムを対象としています。出力モードは、クイックファーストパスの「mini」、一般的な解析の「standard」、フレームワーク再現に特化した詳細な「deep」の3つから選択でき、分析結果はアーキテクチャ設計の再利用可能なルールとして体系化されます。Claude Code、Cursor、Codex、WindsurfなどのAIエージェントツール上で動作し、Markdown形式で構造化された分析結果を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add yezhwi/framework-distillation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

フレームワーク蒸留

概要

コードではなくアーキテクチャを抽出します。

このスキルを使用して、フレームワークの形状、ランタイムモデル、拡張ポイント、エンジニアリング上のトレードオフをリバースエンジニアリングし、別のAIやチームが別の言語やドメインで同様のアーキテクチャを再現できるようにします。

使用すべき場合

  • READMEや公開APIにとどまらないフレームワークアーキテクチャのリバースエンジニアリング
  • ランタイム、ライフサイクル、ステートマシン、拡張メカニズムの調査
  • 別の言語やドメインでの類似フレームワークの再現
  • AIが読み取り可能なアーキテクチャナレッジパッケージの作成
  • アーキテクチャとトレードオフによるフレームワークの比較

典型的な対象: エージェントランタイム、ワークフローエンジン、ステートマシンフレームワーク、プラグインシステム、オーケストレーションプラットフォーム。

使用すべきでない場合

  • READMEの要約のみ
  • APIチュートリアルや使用ガイド
  • 一行ごとのコードウォークスルー
  • コピーペーストによる再実装
  • トレードオフ分析を伴わない機能一覧

リクエストが近いが的外れな場合は、まずスコープをリダイレクトしてください。

必要な入力

最小:

  • リポジトリURLまたはローカルソースパス

推奨:

  • フレームワーク名
  • 分析目標
  • ターゲット実装言語またはドメイン
  • 深さ: mini、standard、または deep
  • フォーカス領域

基本原則

アーキテクチャ > コード
理由 > 構文
設計 > API
トレードオフ > 機能
原則 > 実装

ワークフロー

  1. 適合性を確認し、チュートリアル/API/ファイル単位のリクエストは断るかリダイレクトする。
  2. 目標から深さを選択する。デフォルトは standard。高速な初回パスには mini、網羅的な再現には deep を使用。
  3. ソースコードを深く読む前に、ドキュメント、テスト、サンプル、リポジトリ構造をスキャンする。
  4. アーキテクチャ、ランタイム、状態、データモデル、拡張ポイント、決定、トレードオフを抽出する。
  5. 再利用可能なルールを蒸留し、選択したモードと再現目標に合わせた出力を生成する。

実行ルール

  • 機能リストではなくアーキテクチャを先頭に持ってくる。
  • チュートリアル、API一覧、ファイル単位のウォークスルーに流れないようにする。
  • 主張は、可能な場合はコード、ドキュメント、テスト、サンプル、コミット履歴からの証拠に基づいて行う。
  • 観測された事実と推測を区別する。証拠が薄い場合は Observed(観測)、Strong inference(強い推測)、Tentative inference(仮の推測)を使用する。
  • 不完全なリポジトリへのアクセスや弱い証拠は明示的に述べる。
  • 分析をターゲット言語、ドメイン、フォーカス領域、比較基準に合わせて調整する。

出力モード

  • mini — 高速な初回パスによるアーキテクチャ概要
  • standard — ほとんどの調査に適した完全なアーキテクチャ抽出
  • deep — フレームワーク再現のための網羅的なリバースエンジニアリング

詳細:

  • references/output-modes.md
  • references/analysis-checklist.md
  • references/deliverables.md

アンチパターン

避けるべきこと:

  • READMEのみの要約
  • APIをリストするだけでアーキテクチャがない
  • 設計を抽出せずにサンプルを説明する
  • なぜ存在するかを問わずにコードを説明する
  • トレードオフ、失敗パス、拡張ポイントを無視する
  • 原則を蒸留せずに実装をコピーする
  • 証拠が弱いのに哲学や根拠を事実として宣言する
  • 機能チェックリストだけでフレームワークを比較する

サポート関連資料

  • references/output-modes.md — 出力形状、テンプレート、図
  • references/analysis-checklist.md — 分析チェックリストと品質ゲート
  • references/deliverables.md — 成果物構造とAIシミュレーションプロンプト
  • references/self-test.md — 抜け穴レビューと適用された修正
  • references/simulated-dialogue-tests.md — プレッシャープロンプトとスコアカード

関連スキル