mcpField
R
research-step

research-step

github.com/allenaiエージェントワークフロー4249 回インストール1 日前に更新
リポジトリ

research-step について

研究を beads epic として管理し、型付きサブ課題とスキーマ定義の出力を使うワークフロールーティングスキルです。研究課題の検討から計画、実行、要約更新までエージェントを導き、各手順では説明ファイルを参照します。

主な機能

  1. 01指定されたワークフローへの振り分け
  2. 02研究ミッションの作成と推敲
  3. 03beads グラフでの型付きタスク計画
  4. 04準備済みタスクの実行と後続処理
  5. 05人向け要約の再生成

活用シーン

  1. 01計画前の研究課題の検討
  2. 02研究タスクグラフの初期化と計画
  3. 03準備済みの研究タスクの実行
  4. 04beads からのセッション要約更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/allenai/asta-plugins --skill research-step

インストール後、Claude Code で/research-stepを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
schemas.yaml
scripts/
epic-root.sh
summary-check.sh
validate-output.sh
write-meta.sh
workflows/
brainstorm.md
execute.md
init.md
plan.md
update-summary.md

詳細

Research Step

リサーチセッションを beads のエピックとしてモデル化します。各作業単位は型付きのサブ課題で、その metadata.research_step.output は assets/schemas.yaml の JSON スキーマに一致します。

このスキルはルーターです。作業ディレクトリとユーザーのリクエストを確認し、ワークフローを1つ選んでから、workflows/ 内の対応する .md ファイルを読み、その手順に従います。記憶を頼りにワークフローを実行しないでください。必ず最初にファイルを開いてください。

セットアップ

必須の事前条件はありません。mission.md が存在しない場合、brainstorm ワークフローがユーザーによる草案作成を支援します。

bd と jq のインストール、bd init の実行、scripts/summary-check.sh が動作することの確認は、init ワークフローの責任です。init の実行後は、後続のワークフローで環境が準備済みであることを前提とします。

ファイル

パス役割
mission.md入力。リサーチタスクです。
.beads/状態の信頼できる唯一の情報源です。
summary.mdセッションの派生ビューで、update-summary によって再生成されます。Beads が信頼できる唯一の情報源であり、このファイルは人間と brainstorm のための要約にすぎません。フロントマターの beads_snapshot には、このファイルの生成元となった状態が記録されます。
background_knowledge.txt任意。課題のメタデータから summary_path を介して参照される長文のコンテキストです。

ワークフロー

名前目的詳細な手順
brainstormデフォルト。現在の状態を対話形式で検討し、mission.md の草案作成や改善を行います。ユーザーが実行の準備ができたら、他のワークフローに引き継ぎます。workflows/brainstorm.md
init環境をセットアップします。bd／jq をインストールし、bd init を実行して、scripts/summary-check.sh の動作を確認します。その後 plan に引き継ぎます。workflows/init.md
planグラフを作成または拡張します。mission.md からエピックと初期フロンティアをブートストラップするか、課題がクローズされた後に下流タスクを再計画します。workflows/plan.md
execute準備ができたタスクを1つ、最初から最後まで実行します。クローズしたタスクの種類によって新しい構造が解放される場合は plan に引き継ぎ、それ以外の場合は update-summary に引き継ぎます。workflows/execute.md
update-summarybeads から summary.md を再生成します。冪等です。scripts/summary-check.sh が status: fresh を報告した場合は何も行いません。workflows/update-summary.md

タスク種別のスキーマは assets/schemas.yaml にあります。

ルーティング

1. 明示的なリクエストに従う

ユーザーがワークフローを指定した場合（「リサーチを初期化する」「要約を更新する」「次のステップを実行する」「タスク bd-xyz を実行する」など）、そのワークフローに振り分けます。

2. それ以外 → brainstorm

ユーザーがワークフローを指定していない場合は、brainstorm を実行します。作業ディレクトリを確認し、ユーザーの質問に回答し、必要に応じて mission.md の草案作成や改善を行います。ユーザーが実行の準備ができたら、init／plan／execute／update-summary に引き継ぎます。

3. 連続実行
  • init → 必ずその後に plan を実行します（続いて update-summary が実行されます）。
  • plan → 新しいグラフを要約に反映するため、必ずその後に update-summary を実行します。
  • execute → クローズしたタスクの種類が literature_review、hypothesis、analysis、synthesis のいずれかの場合は、plan に連続して引き継ぎます（続いて update-summary が実行されます）。それ以外の場合は update-summary に直接引き継ぎます。
  • update-summary と brainstorm → 連続実行はしません。

境界

このスキルは出力品質を検証せず、結果をキャッシュしません。mission.md を作成できるのは brainstorm のみで、ユーザーの確認を得た場合に限ります。bd init を実行するのは init です。各ワークフローの .md ファイルに、それぞれの範囲が記載されています。

コメント

Markdown 対応