Communityライティング&編集github.com

FrancescoBorzi/agent-toolkit

最小限かつプロジェクトに依存しない、AIコーディングエージェント向けのスキルとルール集です。

agent-toolkit とは?

これは、AIコーディングエージェント(Claude Code、Cursor、Codexなど)がプロジェクト横断的に使用できる、軽量で汎用的なスキルセットです。「Ticket Fetcher」ルールは、チケット情報の「取得のみ」に特化しており、分析や計画は一切行いません。入力されたURLやIDから、Azure DevOps、Jira、GitHubなどの該当するMCPサーバーを自動判別し、チケットの全フィールド、コメント、添付ファイルを取得して、自己完結型の`.TICKET.md`ファイルとして出力します。取得した添付ファイルはディスクに保存し、画像は埋め込み、それ以外はリンクとして参照します。設計ツール(Figmaなど)のリンクは、専用MCP経由でスクリーンショットを取得します。また、関連チケットのタイトルとステータスのみを軽量に取得し、トレーサビリティを確保します。このスキルの主な目的は、チケット情報を正確かつ完全に取得することで、後続の分析や実装フェーズにクリーンな状態で引き継ぐことです。

対応✓Claude Code~Codex CLI~Cursor
npx skills add FrancescoBorzi/agent-toolkit

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

attachment-1
figma-<nodeId>

ドキュメント

チケット取得(Ticket Fetcher)

取得のみ — 分析、要件定義、計画は一切行いません。出力は自己完結型の .TICKET.md ファイルです。

ソースとアクセス

入力(URLのホスト、またはIDの形状)からトラッカーを特定し、対応するMCPサーバー経由で取得します。例:Azure DevOps MCP → ADO作業項目、Atlassian MCP → Jira課題、GitHub MCP / gh → GitHub Issue。接続されている同等のツールを使用します。ツール名のプレフィックスは構成によって異なります。MCPが必要とするハンドル(例:Atlassian cloudId、ADOプロジェクト)を一度解決して再利用します。入力が不明瞭な場合は、推測せずにユーザーに確認します。該当するMCPが接続されていない場合:公開チケットは、フォールバックとしてURLからスクレイピングできる可能性があります(その場合でも、より適切に動作するなら該当MCPのインストールを提案しても構いません)。非公開チケットはスクレイピングできません(URLはログインページを返すため)。その場合は処理を中止し、ユーザーに対応するMCPサーバーをインストールして認証を行い、再実行するよう伝えます。

あなたのタスク

  1. 入力を解決する。 完全なチケットURLまたはベアのID/キーを受け付けます。識別子を抽出します。トラッカーがキープレフィックスを使用している場合(例:XX-1234)はそれを保持し、そうでない場合は数字のみを使用します。入力が認識できない場合は、ユーザーに確認します。
  2. チケットを取得する。 作業項目/課題を、完全なフィールドセット、インラインコメント、および展開された関連リンク/リレーションと共に取得します。チケットが保持するすべてをキャプチャします。固定のフィールドセットに事前フィルタリングしないでください。受け取ったリッチテキスト形式(HTML、ADFなど)をクリーンなMarkdownに変換します。
  3. スラッグを選ぶ。 タイトル/サマリーから、短いkebab-caseのスラッグ(3〜5単語)を選びます。grepしやすく、深く考えすぎないでください。
  4. 出力ディレクトリを決定する。 プロジェクトの計画ディレクトリ(例:.claude/plans/)内に、プロジェクト相対の <id>-<slug>/ サブディレクトリを作成します。計画がどこに配置されるかについては、プロジェクト/ユーザーの規約に従います。規約が定義されていない場合は、ユーザーに確認します。決して推測しないでください。ディレクトリが既に存在する場合は、<id>-<slug>-v2、-v3 などを提案します。既存の計画ディレクトリを決して上書きしないでください。再取得時の履歴は意図的に保持されます。
  5. チケットファイルを書き込む <output-dir>/<id>-<slug>.TICKET.md に。
  6. 添付ファイルをダウンロードする 出力ディレクトリに。失敗したものについて警告します(添付ファイルを参照)。
  7. 結果を表示する — プロジェクト相対パスと次のステップ行(次のステップを参照)。

チケットファイルの構造

単独で機能する必要があります。再取得せずに新しいセッションがソースを識別できる、十分なメタデータを含む完全で読みやすいチケットのバージョンです。

ヘッダー

ソースメタデータを含むプレーンなMarkdownヘッダー。値がない行は省略します。トラッカーが提供するものを全て含めます。例:

# <タイトル / サマリー>

> **ソース** [<id>](<url>)
> **種類** {type}
> **ステータス** {status}
> **担当者** {表示名 または "—"}
> **報告者 / 作成者** {表示名}
> **ラベル / タグ** {結合文字列 または "—"}
> **取得日** {今日の日付 YYYY-MM-DD}

本文セクション

以下の順序で、存在し空でない場合のみ出力します:

  1. ## 説明
  2. ## 受け入れ条件 — トラッカーに専用のACフィールドがあり、値が設定されている場合
  3. ## <その他のフィールド> — 実際の内容を持つ他の入力フィールド(テクニカルノート、カスタムフィールドなど)ごとに1セクション。フィールドの表示名を見出しにします。チケットが保持する全てをキャプチャします。
  4. ## コメント — 古い順に、各コメントを ### <作成者> — <日付> とその本文で表示します。ベストエフォート:コメントが返されない場合は、簡単にその旨を記載するか、セクションを省略します。
  5. ## 関連チケット — 以下を参照
  6. ## 添付ファイル — 以下を参照
  7. ## デザイン参照 — 以下を参照

見出し階層、箇条書き構造、強調、コードブロックを保持します。フィールド内のサブ見出しは #### にマッピングします。空のセクションは省略します。ユーザー向けの文字列、コード識別子、ファイルパス、i18nキー、URLはそのまま引用し、決して変更または翻訳しないでください。

関連チケット

レスポンスのリンク/リレーション(およびリモートリンクツール)から、リンクされたユニークなチケット(このチケット自体を除く)ごとに、安価な呼び出しでタイトル + ステータス + 種類のみを取得します。全文は取得しません。主な目的は、後で必要に応じて取得できるように、すべての関連チケットのトレースを残すことです。関係が利用可能な場合はそれも含めて、1行に1つの箇条書き:

- [<id>](<url>) — (<type>, <status>) <title>

チケット以外のリモートリンク(例:Wiki/Confluenceページ)の場合は、タイトルとURLをプレーンの箇条書きとして出力します。取得に失敗したリンクは、実行全体を失敗させずに (取得不可) と記載してリストします。

添付ファイル

説明/フィールド内で参照されているすべての添付ファイルおよびインライン画像を特定し、出現順に attachment-<N>.<拡張子> の形式で番号を付けます(元の拡張子を保持)。<N> は両方を合わせた通し番号です。

接続されているすべてのMCPを横断して、常に取得を試みます。 トラッカーがホストする添付ファイル以外にも、チケットは外部アセット(例:Confluence/ADOリソース — FigmaやZeplinなどのデザインツールリンクについては以下のデザイン参照を参照)をリンクしている場合があります。これらは独自のMCP経由で到達可能であり、リンクされたgitリポジトリ内の仕様/ドキュメントファイルも含まれます(gitまたはリポジトリMCP経由で内容を取得し、出力ディレクトリに元のファイル名で保存します)。ソースに適合するMCPを使用してダウンロードします。リンクを事前に取得不可と判断しないでください。適合するMCPは接続されているが認証されていない場合は、黙ってスキップせず、積極的に認証フローを実行します(ログインURLを表示し、ハンドシェイクを完了します)。ユーザーに促されるのを待たずに行います。その後、アセットをダウンロードできるか、またはダウンロードすべきか不明な場合は、ユーザーに確認します。

各ファイルを直接ディスクにダウンロードします — curl -fSL <url> -o attachment-<N>.<ext>、またはMCP添付ファイルツールの保存先パス指定オプションを使用します。添付ファイルをインラインのbase64としてモデル経由でルーティングし、再出力することは絶対にしないでください。出力上限(約10万文字)により、サイレントに切り詰められます(有効なヘッダー、欠落したトレーラー、開けないファイルになります)。一部の添付ファイルMCPツールは、保存先パスオプションなしでbase64のみを返します(例:ADO wit_get_work_item_attachment)。バイナリにはこれらを使用せず、代わりにベアラートークンを使用してトラッカーのREST APIから直接ディスクに取得します(ADOの場合:az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query accessToken -o tsv、その後 curl -H "Authorization: Bearer <token>" "<attachmentUrl>" -o attachment-<N>.<ext>)。(コンテンツURLはMCPと同じ認証を共有することがよくあります。401が返された場合は、取得可能であればトラッカーのベアラートークンを使用して再試行します。)

転送だけでなく整合性を検証します — 空でないこと、送信された Content-Length と一致すること、タイプトレーラーが存在すること(PNG IEND、JPEG FFD9、PDF %%EOF)。ラウンドな文字境界付近でサイズが3の正確な倍数である場合は、base64の切り詰めを示します。失敗した場合は再ダウンロードします。それでも不良の場合は、ダウンロードされなかったものとして扱い警告します。破損ファイルを参照することは絶対にしないでください。その後、ファイルごとに:

  • ダウンロード成功 → ローカルファイルを参照します。
  • ダウンロードされなかった(該当するMCP/添付ツールがない、認証を完了できなかったなど) → それでもローカルファイルとソースURLを参照し、警告リストに追加します。処理をブロックしないでください。チケットはどちらの場合でも使用可能です。

画像 → 埋め込み。画像以外(PDF、.docxなど) → 代わりにリンク:

### 添付ファイル 1

![attachment-1](attachment-1.png)
_元のファイル名: image.png_

### 添付ファイル 2

[attachment-2.pdf](attachment-2.pdf) — _元のファイル名: design-spec.pdf_

ダウンロードできなかったファイルについては、ユーザーが手動で取得できるようにソースを追加します:— ダウンロードされていません。<url> から取得し、attachment-<N>.<ext> としてここに保存してください。

デザイン参照

説明/コメント内のデザインツールリンク(Figma、Zeplin、Sketch、Adobe XDなど)については、それらを attachment-<N> として番号付けしないでください。これらは生きた参照であり、添付ファイルではありません。各参照フレーム/画面をそのツールのMCP(例:Figma MCP get_screenshot)経由でキャプチャし、返された有効期限付きURLを <tool>-<id>-<slug>.png として直接ディスクにダウンロードします(必要に応じて先にMCPを認証します — 添付ファイルを参照)。そのツールのMCPが接続されていない場合は、名前とソースURLを記録し、警告リストに追加します(ダウンロードされなかった添付ファイルと同様)。リンクごとに1つのエントリを記録し、ローカルプレビューとそのツールで再度開くために必要な識別子を含めます:

### <デザイン名>

![figma-<nodeId>](figma-<nodeId>-<slug>.png)
_Figma · ファイル `<fileKey>` · ノード `<nodeId>` · [ソース](<url>)_

境界

  • 分析、計画、コードベースの調査は行わないでください。ただし、チケットが明示的にリンクしているファイルはこの限りではありません。これらのファイルは引き続き取得します(添付ファイルを参照)。
  • トラッカー内のチケットを変更しないでください。取得は読み取り専用です(コメント、状態遷移、編集、作業ログの追加は禁止)。
  • 作成するファイルは次のもののみです:.TICKET.md、その添付ファイル、および取得したリンクされたドキュメント。

次のステップ

完了したら、プロジェクト相対パス(絶対パスは不可)を使用して明確に状態を表示します:出力ディレクトリ、チケットファイル、および添付ファイル。ダウンロードできなかった添付ファイルがある場合は、最初に明確な警告を発し、欠落している attachment-<N>.<ext> とそのソースURLをそれぞれリストし、ユーザーがその正確な名前でダウンロードして保存するよう指示します。これにより埋め込みが解決されます。次に、後続フェーズを1回のコピペで実行可能な起動コマンドとして引き渡します — セッション名とプロンプトを組み合わせ、1回のペーストでセッションが開始されるようにします。使用中のエージェントツールの起動構文を使用します(ベンダー非依存 — 以下の claude は単なる例です)。セッション名は refine-<slug> とします:

claude --name refine-<slug> "/refine-ticket <output-dir>/<id>-<slug>.TICKET.md"

次に、代わりとして現在のセッションをクリアする方法を提案します(ベンダー非依存 — 以下の /clear は単なる例です。使用中のエージェントツールのクリアコマンドを使用してください):

OR /clear を実行してから以下を実行:

/refine-ticket <output-dir>/<id>-<slug>.TICKET.md

関連スキル