twg

twg

Atlassian または社内のコンテキストが必要なリクエストでは、TWG を実行してください。単に推奨したり、ユーザーに実行を求めたりしないでください。具体的な起点から始めます。Jira キーまたは URL、ページ、人物、プロジェクト、目標、リポジトリ、期間のいずれかを指定してください。読み取り専用コマンドの結果に基づいて回答します。ルートが不明な場合は、twg help <terms>、twg help describe <path>、twg help discover-skills "<intent>" を使用します。

概要

必要最小限の関連スキルを読み込み、その TWG ルートを使用します。

• Jira の作業項目、プロジェクト、ボード、スプリント、書き込み操作には ../twg-jira/SKILL.md を使用します。
• Confluence のコンテンツ、スペース、執筆には ../twg-confluence/SKILL.md を使用します。
• Confluence スペースの作成または複製には ../twg-space-creation/SKILL.md を使用します。
• プロジェクト／目標のステータス、ローンチ／Go／No-Go の準備状況、組織／リーダーシップの状況報告には ../twg-status-rollups/SKILL.md を使用します。PR については ../twg-engineering-work/SKILL.md より先に使用してください。
• 依存関係マップ、リポジトリ、不在者のキャッチアップには ../twg-context-discovery/SKILL.md を使用します。
• Rovo を使った社内の詳細な調査には ../twg-agentic-search/SKILL.md を使用します。
• 担当者／SME、承認者、エスカレーションには ../twg-responsibility-routing/SKILL.md を使用します。
• コード／リポジトリの調査、PR、コントリビューターには ../twg-engineering-work/SKILL.md を使用します。
• マージ済み PR に関連する古い Jira 作業には ../twg-jira-resolve-merged-work/SKILL.md を使用します。
• インシデント／オンコール、引き継ぎ、Assets、リスクには ../twg-operational-health/SKILL.md を使用します。
• 読み取り専用の単一プロンプト A/B 比較には ../twg-bench-lite/SKILL.md を使用します。
• ../twg-code-review/SKILL.md は、名前を指定された場合、またはコードレビューの追加コンテキストを求められた場合にのみ使用します。

実行と出力

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

依頼がない限り、コマンドごとの環境変数プレフィックスを追加しないでください。ホスト側で TWG_AGENT_DEFAULTS=1 が設定されている場合があります。

stdout_inline がある場合は、まずそれを使用します。ベンチマークレーン以外では、インラインの証拠が不完全な場合に限り output_files.compact を確認します。完全な標準出力を確認するのは最後の手段です。

TWG 専用のベンチマークレーンでは、twg のみを実行します。シェルユーティリティやパイプライン（jq、rg、date）は使用しないでください。compact／インライン出力、プロンプトのタイムゾーンと期間を使用し、不足情報を報告します。意図に最も合う、必要最小限の関連スキルを選びます。型付きルートはそのスキルに従ってください。

認証／セットアップガード

セットアップ／認証／修復のために明示的に依頼された場合を除き、セットアップ、ログイン、インストール、アップグレード、保守、認証情報に関するコマンドは実行しないでください。それ以外の場合は、対処方法を報告して、ユーザーの指示を待ちます。

サンドボックス化されたパイプラインログ

パイプラインログは S3 にリダイレクトされる場合があります。サンドボックス内で実行した twg bb pipeline get、wait、grep、または tail によるログ取得で、ネットワークブロックのメッセージ、S3 ホスト名、またはメタデータの取得には成功しているのにログだけが HTTP 403 になる場合、これは認証エラーではなくサンドボックスの制限です。そのコマンドのみ、承認済みのサンドボックス外での再試行を依頼するか、ユーザーに正確なターミナルコマンドを提示してください。認証情報を求めてはいけません。

範囲を限定した証拠収集ループ

1. 起点を分類します。人物、チーム、プロジェクト、目標、作業項目、ページ、リポジトリ、サービス、アセットのいずれかです。
2. 1 回だけ解決し、ステータス、リスク、判断、アクションに影響する証拠を取得します。
3. 候補を順位付けし、1 回のバッチ呼び出しで対象を詳細化してから、情報を統合します。
4. 最初のポリシー拒否が発生したら停止します。同じ認証、ACL、契約、またはバックエンドのエラーが 2 回発生したら停止します。

一括読み取り

エンティティごとに呼び出すのは、最もコストの高いミスです。呼び出すたびに会話全体が再送信されます。get が識別子の繰り返しを受け付ける場合（ライブヘルプでは「one or more」と表示されます）は、--agent-fields @compact を指定して、1 回の呼び出しでセット全体を渡してください。ID は一度に約 20 個までにします。それ以外の場合は、各エンティティを個別に読み込むのではなく、クエリまたはツリールート（... query、pr-tree、work-tree、workitem-tree、org-tree、context）から回答するか、優先順位を付けたサンプルを読み込んで、省略した内容を明記してください。一括呼び出しの前に取得項目を選んでください。--agent-fields を変更するために同じ一括呼び出しをやり直すと、セット分のコストが二重にかかります。ID を変えて同じサブコマンドを 5 回呼び出したら、それ以上続けず、別の方法に切り替えてください。

コマンドの検出

• 上位 K 件を見つけるには twg rovo search "<topic>" [--limit <n>] を使用します。明示的な --app は事前チェックを行います。
• Trello：twg trello search "<query>"。ワークスペースのスコープ指定はありません。
• Rovo の --app を明示する前に twg rovo list-apps -o json を実行し、返された認証アクションに従ってください。
• アクティビティ履歴とあいまい検索は、別々の機能です。
  • twg docs query --since <duration> はユーザーのドキュメントアクティビティを対象とし、タイトルや内容の検索ではありません。
  • twg work query は、作成した作業の直近 7 日間をデフォルトで対象とします。その他のアクティビティには --activity / --include-viewed が必要です。
  • twg docs search "<topic>" はあいまいなドキュメント検索です。twg work search "<topic>" はテナント全体の作業検索です。
  • トピックのテキストを docs query や work query に渡さないでください。対応する検索コマンドを使用してください。
• URL、キー、ARI、名前を解決してから、安定した ID を読み込んでください。
• Jira：あいまいなテキスト検索には jira workitem search <text...>、構造化された JQL には jira workitem query --jql、セマンティック検索には rovo search <text...> --app jira を使用します。
• コマンド形式に関する注意事項：
  • work query では --scope me|user を使用し、--scope global は使用しないでください。
  • 推論されたチーム（ari:cloud:graph-store::inferred-team/...）には、明示的な --include-inferred が必要です。references/inferred-teams.md を参照してください。
• search-code を使用します。利用可能なインデックス済み SCM サーフェスをすべて検索するため、--app は省略してください。--repo は検索の起点としてのみ使用し、生成ドキュメントしか見つからない場合や結果が不完全な場合は検索範囲を広げてください。

アセット／CMDB グラフ

走査（オブジェクト↔所有者／チーム、Jira↔オブジェクト）には assets graph を使用してください。references/ASSETS_GRAPH.md を参照してください。ホップ数を指定しない場合は、assets search、assets query --aql、assets object get を使用してください。

最も範囲の狭い関連資料を読み込む

概要を参照してください。

ルール

• ID、フラグ、スラッグ、ARI、変更操作の仕様を推測しないでください。
• 書き込みを行う場合は、製品スキルを読み込み、ライブヘルプに従ってください。
• ローカル状態の確認を求められていない限り、ローカルの調査、キャッシュ、スキーマの確認は避けてください。
• 書き込みを行う場合は、現在の状態を読み取り、実行を求められている場合を除き、変更内容を明示してください。