フレームワーク蒸留
概要
コードではなくアーキテクチャを抽出します。
このスキルを使用して、フレームワークの形状、ランタイムモデル、拡張ポイント、エンジニアリング上のトレードオフをリバースエンジニアリングし、別のAIやチームが別の言語やドメインで同様のアーキテクチャを再現できるようにします。
使用すべき場合
- READMEや公開APIにとどまらないフレームワークアーキテクチャのリバースエンジニアリング
- ランタイム、ライフサイクル、ステートマシン、拡張メカニズムの調査
- 別の言語やドメインでの類似フレームワークの再現
- AIが読み取り可能なアーキテクチャナレッジパッケージの作成
- アーキテクチャとトレードオフによるフレームワークの比較
典型的な対象: エージェントランタイム、ワークフローエンジン、ステートマシンフレームワーク、プラグインシステム、オーケストレーションプラットフォーム。
使用すべきでない場合
- READMEの要約のみ
- APIチュートリアルや使用ガイド
- 一行ごとのコードウォークスルー
- コピーペーストによる再実装
- トレードオフ分析を伴わない機能一覧
リクエストが近いが的外れな場合は、まずスコープをリダイレクトしてください。
必要な入力
最小:
- リポジトリURLまたはローカルソースパス
推奨:
- フレームワーク名
- 分析目標
- ターゲット実装言語またはドメイン
- 深さ:
mini、standard、またはdeep - フォーカス領域
基本原則
アーキテクチャ > コード
理由 > 構文
設計 > API
トレードオフ > 機能
原則 > 実装
ワークフロー
- 適合性を確認し、チュートリアル/API/ファイル単位のリクエストは断るかリダイレクトする。
- 目標から深さを選択する。デフォルトは
standard。高速な初回パスにはmini、網羅的な再現にはdeepを使用。 - ソースコードを深く読む前に、ドキュメント、テスト、サンプル、リポジトリ構造をスキャンする。
- アーキテクチャ、ランタイム、状態、データモデル、拡張ポイント、決定、トレードオフを抽出する。
- 再利用可能なルールを蒸留し、選択したモードと再現目標に合わせた出力を生成する。
実行ルール
- 機能リストではなくアーキテクチャを先頭に持ってくる。
- チュートリアル、API一覧、ファイル単位のウォークスルーに流れないようにする。
- 主張は、可能な場合はコード、ドキュメント、テスト、サンプル、コミット履歴からの証拠に基づいて行う。
- 観測された事実と推測を区別する。証拠が薄い場合は
Observed(観測)、Strong inference(強い推測)、Tentative inference(仮の推測)を使用する。 - 不完全なリポジトリへのアクセスや弱い証拠は明示的に述べる。
- 分析をターゲット言語、ドメイン、フォーカス領域、比較基準に合わせて調整する。
出力モード
mini— 高速な初回パスによるアーキテクチャ概要standard— ほとんどの調査に適した完全なアーキテクチャ抽出deep— フレームワーク再現のための網羅的なリバースエンジニアリング
詳細:
references/output-modes.mdreferences/analysis-checklist.mdreferences/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— プレッシャープロンプトとスコアカード