mcpField
O
outline-budgeter

outline-budgeter

github.com/willoscarドキュメント51741 回インストール4 週間前に更新
リポジトリ

outline-budgeter について

outline-budgeterは、学術サーベイのアウトラインにおける章構成を調整するスキルです。outline/outline.ymlの細分化された小節を統合し、変更理由を記録して、論文として十分な内容を持つ構成を目指します。

主な機能

  1. 01H2とH3の数を集計
  2. 02ドラフトの種類に応じたH3予算
  3. 03構成と根拠に基づく隣接小節の統合
  4. 04小節IDの維持と更新
  5. 05アウトライン予算レポートの作成

活用シーン

  1. 01細かい小節が多すぎるアウトラインの調整
  2. 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.tsv
    • outline/coverage_report.md
    • GOAL.md

出力

  • outline/outline.yml(その場で更新)
  • outline/OUTLINE_BUDGET_REPORT.md(箇条書きのみ。統合した内容と理由を記載)

ワークフロー(文章は出力しない)

  1. アウトラインを読み、簡単な予算スナップショットを算出します。
  • queries.md に draft_profile(course_paper/survey/deep)が設定されている場合は、それを使って H3 の予算目標を決めます。
  • H2 の数(アウトラインに含まれない考察/結論は除く)
  • H3 の合計数
  • H2 の章ごとの H3 の数
  1. 統合計画を決めます(構造優先、根拠も考慮)。
  • 類似した軸やキーワードを持つ、隣接する H3 を優先して統合します。
  • 対応範囲が弱い H3 を優先します(mapping.tsv が存在する場合)。
  • outline/coverage_report.md(outline-refiner が生成)が存在する場合は、対応範囲が弱い小節や再利用率が高い小節を特定し、統合に役立てます。
  • GOAL.md をスコープの制約として使い、異なる研究課題やスコープ境界が混在するような統合は避けます。
  • 新しい小節を作るのではなく、細かな違いは箇条書きや軸の中に含めることを優先します。
  1. outline/outline.yml に統合を適用します。
  • タイトルを統合し、より明確で内容の充実した小節タイトルにします。
  • 箇条書きを統合します(テンプレートの重複を除き、Stage A のフィールドを維持します:Intent/RQ/Evidence needs/Expected cites)。
  • 可能な限り ID を維持します。
    • ID を変更する必要がある場合は、レポートに明記し、mapping.tsv の再生成が必要であることを前提とします。
  1. outline/OUTLINE_BUDGET_REPORT.md を作成します。
  • 統合前/統合後の数。
  • 統合一覧(旧 ID/タイトル -> 新 ID/タイトル)。
  • リスク(例:mapping のリセットが必要)。

品質チェックリスト

  • プレースホルダー(TODO/…/(placeholder))がない。
  • アウトラインの予算が論文らしい目標に合っている。
  • 残った各 H3 に、根拠を優先する執筆を支えられるだけの内容がある(箇条書きに具体的な比較+評価の基準+失敗モードが記載されている)。

トラブルシューティング

問題:統合によって小節の範囲が広くなりすぎる

対処:

  • H3 は 1 つに保ちつつ、箇条書きを明示的な比較軸と必須の根拠フィールドに分けます。根拠が十分にある場合は、細かな分割を後回しにします。
問題:ID の変更後に mapping が機能しなくなる

対処:

  • section-mapper を再実行して outline/mapping.tsv を再生成し、その後 outline-refiner を再実行します。

コメント