qiaomu-heavyskill

HeavySkill

マルチエージェント推論パイプラインです。K 個の隔離されたサブエージェントが独立して推論し、Codex が議論を進行し、Claude が読みやすい Markdown と HTML のレポートを生成します。

arXiv:2605.02396 に基づいています。主な知見：議論には生成的な性質があり、統合担当は、個々のトレースのどれにも存在しない正解を生成します。

2 つのモード

質問に正解があるかどうかに応じて選択します。

モード	使う場面	サブエージェントの種類	例
検証	正解またはより良い答えがある	推論アプローチ	コードのバグ、数学、論理、事実分析
議論	唯一の正解がなく、複数の見解が妥当	ステークホルダーの視点	技術スタックの選択、社会的なトピック、製品の決定、戦略

役割

役割	実装	責任
並列思考担当	K 個の独立したサブエージェント（Agent ツール、並列実行）	それぞれ 1 つのトレースを作成し、コンテキストを分離
議論の進行役	/codex:rescue を介した Codex	批判的な評価 → 統合した結論
レポート作成者	Claude（メインコンテキスト）	Codex の出力から Markdown と HTML を生成

サブエージェントを使う理由

同じコンテキストウィンドウでトレースを順番に作成するのは、アーキテクチャ上誤りです。無視するよう指示しても、モデルの注意は先行するトレースを認識してしまいます。各サブエージェントには、新しく隔離されたコンテキストが与えられます。これにより、指示による独立性ではなく、真の独立性が実現します。

ワークフロー

1. 明確化 — モード（検証／議論）、質問、成功基準、K（3＝標準／4＝複雑／5＝重大な影響を伴う場合）を特定します。
2. K 個のサブエージェントを並列で起動 — Agent ツールを使い、K 個の呼び出しを同時に実行します。それぞれに隔離されたコンテキストを与え、アプローチの種類または視点のレンズを 1 つ割り当てます。
3. 収集 — すべての出力を集め、収束しているグループを特定し、外れ値に印を付け、順序をシャッフルします（Codex の位置バイアスを防止）。
4. Codex による議論 — トレースを構造化されたプロンプトに整形し、/codex:rescue を呼び出します。Codex は分類 → トレースごとの評価 → すべてに問題がある場合は再導出 → 統合、の順に処理します。
5. レポートを生成 — Claude が次を生成します。
   • heavyskill-report.md — 構造化された Markdown レポート
   • heavyskill-report.html — 読みやすい単一ページの HTML レポート
   • heavyskill-report.pdf — トレースの概要、議論、最終判定をまとめた PDF。Chrome ヘッドレスを使って HTML からエクスポートします
6. 反復（任意） — Codex の確信度が Low／Medium の場合は、議論をもう 1 ラウンド実行します。合計で最大 2 ラウンドです。

サブエージェントのプロンプト、アプローチの種類、視点のレンズ、Codex のプロンプトテンプレート、HTML テンプレートについては、フレームワークを参照してください。

出力仕様

• ファイルを書き込む前に、フォルダー ~/Downloads/heavyskill-reports/{question-slug}-{date}/ を作成します。
• 各サブエージェントのトレースは、到着した時点で traces/trace-{letter}-{approach}.md に書き込みます。
• Codex の生出力は deliberation.md に書き込みます。
• 最終 Markdown レポートは {slug}.md に書き込みます。
• 最終 HTML レポートは {slug}.html に書き込みます。Medium 風（オフホワイトの背景、ほぼ黒のテキスト、大きく読みやすい文字、ゆったりした余白、エディトリアルな雰囲気）で、自己完結型とし、外部依存を使用しません。
• HTML の書き込み後、Chrome ヘッドレスを使って {slug}.pdf にエクスポートします（コマンドは framework.md の Step 3 を参照）。PDF は共有用の主要な成果物です。トレースの概要、議論の過程、最終判定を 1 つのドキュメントにまとめます。
• Codex の出力を会話内に一字一句そのまま提示します。言い換えはしません。
• レポート名は質問から生成します。汎用的なファイル名は使いません。