twg-agentic-search

twg-agentic-search

ルートの twg スキルと併用してください。正確なコマンド構文は、実行時の twg help、特にフィルターや出力オプションが重要な場合は twg help describe "rovo search" を参照してください。

CLI ランチャーのフォールバック

twg <command> を実行します。シェルで command not found と表示された場合は、 $HOME/.local/bin/twg（macOS/Linux）／$env:LOCALAPPDATA\Programs\twg\bin\twg.exe（PowerShell）を使用し、 そのディレクトリを PATH に追加するようユーザーに伝えてください。認証エラーやコマンドエラーを PATH の問題として扱わないでください。

ワークフロー

1. リクエストを、曖昧な調査、または複数のプロダクトにまたがる社内調査に分類します。 情報源が不明確な場合、最新の社内ナレッジが必要な場合、または回答が Confluence、Jira、Drive、Slack、Bitbucket、GitHub、その他の Rovo 接続アプリにまたがる可能性がある場合は、このスキルを優先してください。
2. Atlassian サイトを確認するか、推定します。設定済み、または明示されたサイトがなく、曖昧さによって検索内容が変わる場合に限り、質問してください。
3. アプリや情報源の利用可否によって計画が変わる場合は、 twg rovo list-apps -o json を実行します。返された組み込み機能、コネクター、準備状況、認証／セットアップの操作を参考に検索範囲を決めてください。ユーザーから依頼されていない限り、セットアップやログインは開始しないでください。
4. 具体的なトピックと、求められている成果物または意思決定の種類を組み合わせたクエリを 1 つ使って検索を開始します。最初の結果が異なる範囲の情報を混在させている、一次情報が不足している、または求められている時点の情報が見つからない場合に限り、信頼できる情報源を優先する検索、または最近の更新に焦点を当てた検索で最大 1 回絞り込みます。最初のクエリで返された候補ごとに、タイトルを指定した検索を繰り返さないでください。
5. フィルターを慎重に選びます。公式の社内ナレッジには、Confluence と Jira の組み込み機能をデフォルトで使用します。有用で利用可能な場合に限り、Slack、Google Drive、Bitbucket、GitHub、その他のコネクターに範囲を広げます。証拠を絞り込みつつ、回答になり得る情報を隠さないように、アプリ、種類、最近の情報、所有者／貢献者／担当者／報告者／ステータス、タイトルのみ、ラベル／スペース、サイトのフィルターを使用します。
6. 出力を制限して検索します。

twg rovo search "<query>" --output json --output-summary auto --agent-fields @compact
twg rovo search "<query>" --output json --output-summary auto --agent-fields @evidence

候補を絞り込むには @compact を使用し、スニペット、URL、情報の出所について詳しい情報が必要な場合は @evidence を使用します。

証拠に関するルール

• 検索スニペットは候補として扱い、事実として扱わないでください。
• 最終的な主張をまとめる前に、少数かつ多様な一次情報を取得して内容を確認します。ドキュメントを探す場合は、要件、アーキテクチャ／設計、現在のデリバリーなど、重複しない役割を網羅してください。結果の URL／種類に応じて、twg confluence content get、twg jira workitem get、twg jira workitem query、twg bb pull-requests get <id>、twg bb repo get、または該当するプロダクトのコマンドなど、プロダクト固有のコマンドを使用します。
• ドキュメントや PRD を探す場合は、これらの役割を対象に、情報源を最大 5 件選択します。重大な矛盾がある場合を除き、各役割につき情報源を 1 件確認します。検索結果に候補がさらにあっても、各役割、現在のデリバリー、重要な矛盾が裏付けられた時点で終了します。
• ユーザーが非公式な情報を明示的に求めている場合を除き、個人の下書きや古いチャット上の言及より、公式スペース、所有者が明確なプロジェクトページ、最新の Jira 課題、最近の意思決定記録を優先します。
• 内容を確認した証拠について、矛盾、最新性、所有者、信頼性を比較します。
• プロダクト固有の URL または ID から内容を確認できる候補については、@evidence 検索を再実行しないでください。また、同じ情報源を別の表示形式で再取得しないでください。 ACL の制限、利用できないコネクター、再現率の低さ、未解決の矛盾は、単一の主張にまとめずに明示してください。

出力

回答または最もよく裏付けられた結論を先に示します。内容を確認した情報源のタイトルと URL を引用し、情報がある場合は情報源のアプリ、日付またはステータス、各情報源を信頼した理由を記載します。確認済みの事実、可能性の高い解釈、矛盾、情報の欠落を分けて示してください。