Install Teamwork Graph CLI skills for coding agents
現在、このエクスペリエンスはベータ版です。
TWG CLI には、インストール可能なスキルが付属しています。これは、コーディング エージェントにアトラシアン製品での作業方法を教えるコンテキスト ファイルです。一度インストールすれば、あとは実現したいことを自然な言葉で説明するだけです。
スキルをインストールする
TWG インストーラーは、スキルを自動でインストールします。正規のスキル バンドルが常に ~/.agents/skills に書き込まれ、Codex、Cursor、Gemini CLI、GitHub Copilot、Rovo Dev、および汎用的な .agents/skills レイアウトをサポートするその他のエージェントによって使用されます。
独自のスキル ディレクトリを必要とするエージェントを検出すると、バンドルもそこにコピーされます。たとえば、Claude Code がすでにインストールされている場合、Claude Code は ~/.claude/skills の下にコピーを受け取ります。
スキルを手動で修復または更新するには、次を実行します。
twg skills install --global手動インストールでは、特定のエージェントを追加してターゲットにすることもできます。
twg skills install --global --agent claudeClaude
Claude Code は .claude/skills/ にスキルを保存します。TWG のインストール中に Claude Code が検出された場合、TWG のスキルはその場所に自動で配置されます。その後、ご自身のプロジェクトで Claude Code を開いて次のように質問を開始してください。
「私の未解決の Jira 課題を教えて。」
「Summarize the work my team did this week. (今週チームが行った作業をまとめて。)」
「Create a Confluence page summarizing our Q2 goals. (第 2 四半期の目標をまとめた Confluence ページを作成して。)」
Codex
OpenAI Codex は、汎用的な .agents/skills/ ディレクトリ (インストールに常に含まれます) からスキルを読み取ります。追加の手順は必要ありません。その後、Codex に次のように質問してください。
「Show me the current sprint and any blockers. (現在のスプリントとブロッカーを表示して。)」
「Find PRs I authored this month. (今月私が作成したプル リクエストを見つけて。)」
「What goals are at risk for my team? (チームのどの目標にリスクがある?)」
Gemini
Gemini CLI も、.agents/skills/ から自動で読み取ります。その後、次のように質問してください。
「Who do I collaborate with most? (最も多くコラボレーションする相手は?)」
「Get full context on PROJ-123 — linked PRs, docs, and dependencies. (PROJ-123 のリンクされたプル リクエスト、ドキュメント、依存関係などのフル コンテキストを入手して。)」
「Show my reporting chain. (私のレポート チェーンを表示して。)」
その他のエージェント
インストーラーは、Cursor、GitHub Copilot、Rovo Dev、Augment、Kiro CLI、OpenCode、およびスキルまたはコンテキスト ディレクトリをサポートする任意のエージェントもサポートしています。汎用的な場所である .agents/skills/ は、ほとんどのエージェントですぐに利用できます。追加のエージェントのコピーは、そのエージェントがローカルで検出された場合、または --agent を指定してリクエストした場合にのみインストールされます。
インストールされるもの
スキルは、.agents/skills/ (および検出または要求されたエージェント固有の場所) の下に 2 つの兄弟スキル ディレクトリとして配置されます。
レイアウト | 目的 |
|---|---|
| ルート TWG 運用契約、コマンド検出、出力処理、製品注意事項、およびスクリプト/TWG ラッパー |
| ステータス ロールアップ、コンテキスト検出、エンジニアリング作業、運用に対する成果主義のレシピ |
| オンデマンドで読み込まれるリファレンス ドキュメント (出力処理とワークフローのレシピを含む) |
エージェントはこれらを自動で読み取ります。特別なプロンプト プレフィックスは必要ありません。
コマンド検出
エージェントは、コマンド検出で twg help を直接使用する必要があります。
twg help
twg help page get
twg help jira workitem
twg help describe "jira"
twg help describe "jira workitem get"コマンド名、エイリアス、引数、オプションを推測する前に、twg help <用語> を使用します。馴染みのないコマンドの正確な引数、選択肢、既定値、例が重要な場合は、その前に twg help describe <パス> を使用します。名前空間のパスを指定すると、コンパクトな YAML ルーティング マップが返されます。正確な実行可能コマンドのパスを指定すると、既定で JSON コントラクトが返されます。レンダリングされた --help は、人間が読み取れるコマンド ページが特に必要な場合にのみ使用してください。
次のステップ
この内容はお役に立ちましたか?