research-add-fields

Research Add Fields — フィールドスキーマへの追加

fields.yaml をその場で更新し、調査の観点を追加します。

トリガー

/research-add-fields

パイプライン内の位置

/research-outline → ► /research-add-fields ◄ → /research-deep → /research-report

/research-outline によって fields.yaml が作成された後であれば、いつでも実行できます。ただし、新しいフィールドを最初の段階からディープエージェントに埋めてもらえるよう、/research-deep の前に実行するのが最も効果的です。

ワークフロー

ステップ 1 — フィールドファイルを自動検出

現在の作業ディレクトリを起点に Glob で */fields.yaml を検索します。すでに定義されている内容を確認するために Read し、候補が既存のフィールドと重複しないようにします。また、ユーザーに確認を求める際に、現在のカテゴリを提示できます。

ステップ 2 — 追加元を選択

次の 2 つの選択肢を示して AskUserQuestion で質問します。

• A. 直接入力 — ユーザーがフィールド名、説明、カテゴリを指定します。
• B. ウェブ検索 — Task ツール（subagent_type: general-purpose）を介して調査サブエージェントを起動し、そのトピック分野で一般的なフィールドを提案してもらいます。

ステップ 3 — 表示して確認

• A または B で得られたフィールド候補をユーザーに提示します。
• 候補ごとに AskUserQuestion で、残す／削除する／編集する、のいずれかを確認します。
• 残す各フィールドについて、category（既存の field_categories[].category と一致するもの、または新しいカテゴリ）、detail_level（brief | moderate | detailed）、required（デフォルトは false）を指定します。

ステップ 4 — 更新を保存

確認済みのフィールドを fields.yaml に追加し、既存の構造と順序を維持します。その場で保存します。

フィールドの形式（/research-outline と同じ）

field_categories:
  - category: <name>
    fields:
      - name: <field_name>
        description: <what to capture>
        detail_level: brief | moderate | detailed
        required: false

出力

更新済みの {topic}/fields.yaml — その場で変更し、保存前にユーザーの確認を得ます。

注意事項

• 後から required: true を追加すると、すでに完了した項目に問題が生じます。 /research-deep が一部の項目についてすでに JSON を生成している場合、新しい必須フィールドを追加すると、それらの JSON は検証に失敗します。フィールドを required: false として追加するか、対象項目について /research-deep を再実行する計画を立ててください。
• カテゴリ名は文字列として完全一致で照合されます。 新しいフィールドの category が既存の field_categories[].category と一致しない場合、スキーマに新しいトップレベルカテゴリが作成されます。それ自体は問題ありませんが、意図したものか確認してください。ここでの誤字は、気づかないままカテゴリが分割される原因になります。
• オプション B のウェブ検索サブエージェントは、会話のコンテキストの外で動作します。 提案が既存のスキーマに適合し、現在のカテゴリと競合しないよう、トピックと既存カテゴリの明示的な一覧を渡してください。
• fields.yaml は ~/.claude/skills/research-outline/validate_json.py からも使用されます。 このスキルが書き込むスキーマは、同バリデーターとの互換性を保つ必要があります。field_categories[].fields[].name と required の形式を維持し、特殊な YAML 構文は使用しないでください。