outline-budgeter について
outline-budgeterは、学術サーベイのアウトラインにおける章構成を調整するスキルです。outline/outline.ymlの細分化された小節を統合し、変更理由を記録して、論文として十分な内容を持つ構成を目指します。
主な機能
- 01H2とH3の数を集計
- 02ドラフトの種類に応じたH3予算
- 03構成と根拠に基づく隣接小節の統合
- 04小節IDの維持と更新
- 05アウトライン予算レポートの作成
活用シーン
- 01細かい小節が多すぎるアウトラインの調整
- 02section-mapperの前後での構成調整
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill outline-budgeterインストール後、Claude Code で/outline-budgeterを入力して読み込まれたか確認します。
詳細
アウトラインの予算調整(文章は出力しない)
トリガーとルーティング
- トリガー:アウトラインの予算調整、小節の統合、小節が多すぎる、H3 の増殖、大纲预算, 合并小节, 大纲太碎。
- 使用するタイミング:
outline/outline.ymlが存在するものの、各セクションが薄くなりそうな場合(H2/H3 が多すぎる場合)。section-mapperの前、または実行直後に使用します。
目的:よくある調査論文の失敗パターンであるH3 の増殖(小さな小節が多すぎること)を防ぎ、アウトラインのように内容が薄い PDF になるのを避けます。
このスキルでは、outline/outline.yml を論文らしい予算配分に書き換えます。
- 最終的な目次の目標:約 6~8 個の H2 セクション(序論/関連研究+中核となる章 3~4 個+考察+結論)
- H3 の目標:数を減らし、内容を充実させた小節にする(
draft_profileに応じて、course_paper<=6、survey<=10、deep<=12)
考察/結論は C5 の統合時に(全体セクションとして)追加されるため、アウトライン自体の H2 は通常 6 個以下にします。
入力
outline/outline.yml- 任意(根拠に基づいて統合する際に役立ちます):
queries.md(任意:draft_profileが設定されている場合は、H3 の予算を決める際に使用します)outline/mapping.tsvoutline/coverage_report.mdGOAL.md
出力
outline/outline.yml(その場で更新)outline/OUTLINE_BUDGET_REPORT.md(箇条書きのみ。統合した内容と理由を記載)
ワークフロー(文章は出力しない)
- アウトラインを読み、簡単な予算スナップショットを算出します。
queries.mdにdraft_profile(course_paper/survey/deep)が設定されている場合は、それを使って H3 の予算目標を決めます。- H2 の数(アウトラインに含まれない考察/結論は除く)
- H3 の合計数
- H2 の章ごとの H3 の数
- 統合計画を決めます(構造優先、根拠も考慮)。
- 類似した軸やキーワードを持つ、隣接する H3 を優先して統合します。
- 対応範囲が弱い H3 を優先します(
mapping.tsvが存在する場合)。 outline/coverage_report.md(outline-refinerが生成)が存在する場合は、対応範囲が弱い小節や再利用率が高い小節を特定し、統合に役立てます。GOAL.mdをスコープの制約として使い、異なる研究課題やスコープ境界が混在するような統合は避けます。- 新しい小節を作るのではなく、細かな違いは箇条書きや軸の中に含めることを優先します。
outline/outline.ymlに統合を適用します。
- タイトルを統合し、より明確で内容の充実した小節タイトルにします。
- 箇条書きを統合します(テンプレートの重複を除き、Stage A のフィールドを維持します:Intent/RQ/Evidence needs/Expected cites)。
- 可能な限り ID を維持します。
- ID を変更する必要がある場合は、レポートに明記し、
mapping.tsvの再生成が必要であることを前提とします。
- ID を変更する必要がある場合は、レポートに明記し、
outline/OUTLINE_BUDGET_REPORT.mdを作成します。
- 統合前/統合後の数。
- 統合一覧(旧 ID/タイトル -> 新 ID/タイトル)。
- リスク(例:mapping のリセットが必要)。
品質チェックリスト
- プレースホルダー(
TODO/…/(placeholder))がない。 - アウトラインの予算が論文らしい目標に合っている。
- 残った各 H3 に、根拠を優先する執筆を支えられるだけの内容がある(箇条書きに具体的な比較+評価の基準+失敗モードが記載されている)。
トラブルシューティング
問題:統合によって小節の範囲が広くなりすぎる
対処:
- H3 は 1 つに保ちつつ、箇条書きを明示的な比較軸と必須の根拠フィールドに分けます。根拠が十分にある場合は、細かな分割を後回しにします。
問題:ID の変更後に mapping が機能しなくなる
対処:
section-mapperを再実行してoutline/mapping.tsvを再生成し、その後outline-refinerを再実行します。
コメント
Markdown 対応