mcpField
C
cawplan-ticket-context

cawplan-ticket-context

github.com/cawcut生産性1143 回インストール2 日前に更新
リポジトリ

cawplan-ticket-context について

cawplan-ticket-contextは、CawPlanチケットの詳細を取得して表示するエージェントスキルです。タイトル、本文、進捗コメントを示した後、実装作業には進まずに終了します。

主な機能

  1. 01URLまたはチケットIDで検索
  2. 02タイトルと詳細本文の表示
  3. 03現在の進捗コメントの表示
  4. 04添付ファイル参照の報告

活用シーン

  1. 01CawPlan issue URLの詳細確認
  2. 02チケットの現在の進捗確認
  3. 03後続作業前のチケット背景の把握

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cawcut/skill-cawplan --skill cawplan-ticket-context

インストール後、Claude Code で/cawplan-ticket-contextを入力して読み込まれたか確認します。

詳細

CawPlan チケットのコンテキスト

ブートストラップ

cawplan skill check

ワークフロー

チケットフィールドの意味

CawPlan チケットでは、description は短いタイトル、remarks は詳細ページの説明/本文(多くの場合 HTML)です。これらのフィールドには常に適切なラベルを付けて表示してください。description を本文として扱ったり、チケットのコンテキストを表示する際に remarks を省略したりしないでください。

ユーザーが /cawplan-ticket-context を実行したとき、チケットのコンテキストを照会するよう依頼したとき、またはこのセッションで CawPlan の課題 URL に言及したときに、このスキルを使用してください。

ユーザーメッセージに https://app.cawplan.com/issue/CWP-14471 や https://proto-portal.example.com/issue/CAW-04560 のような CawPlan の課題 URL が含まれていて、SQA 要件分析、5フィールドへの構造化、モジュールツリーの選択、または QA Insights へのアーカイブを依頼していない場合は、このスキルを自動的に起動してください。これらの依頼には cawplan-requirement-analyze を使用してください。課題 URL のみが貼り付けられている場合は、明示的な /cawplan-ticket-context コマンドを待たないでください。

このスキルは表示専用です。チケットを検索して詳細を表示したら、そこで終了してください。ユーザーが後続作業を明示的に依頼しない限り、リポジトリの調査、ソースファイルの検索、実装計画の推測、テストの実行、ファイルの編集、変更のコミット、または別のワークフローへの移行を行わないでください。

以下の入力を任意に組み合わせて受け付けます。

  • CawPlan の課題 URL。例:https://app.cawplan.com/issue/CAWP-13477
  • 製品の課題 URL。例:https://proto-portal.example.com/issue/CAW-04560
  • チケット表示 ID。例:CAWP-13477、CAW-04560、その他の PREFIX-123 形式の ID
  • チケットの一意 ID

固定のプレフィックス一覧からチケット ID を推測しないでください。表示 ID のプレフィックスは製品によって異なります(CAW、CAWP など)。トークンが構造パターン ^[A-Za-z][A-Za-z0-9]+-\d+$ に一致する場合、または /issue/<display-id> のような URL パスセグメントから抽出された場合は、表示 ID として扱ってください。cawplan tickets search を実行して候補を検証してください。検索結果がない場合は、別のプレフィックスを推測せず、一致するチケットが見つからなかったと報告してください。

まず、cawplan tickets search でチケットの詳細を検索し、返されたチケット情報をユーザーに表示してください。表示 ID の場合は、正確に --display_ids 形式を使用してください。

cawplan tickets search --display_ids CAW-04560

複数の表示 ID がある場合は、まとめて渡してください。

cawplan tickets search --display_ids CAWP-13477,CAW-04560

ユーザーが CawPlan の課題 URL を指定した場合は、検索前に表示 ID を抽出してください。ユーザーが一意 ID のみを指定し、表示 ID を指定していない場合は、cawplan tickets search --unique_ids ... で検索し、返されたチケット情報を表示してください。入力に表示 ID 形式の参照と表示 ID 以外の参照が両方含まれる場合は、表示 ID を --display_ids で、一意 ID を --unique_ids で検索してください。

チケットの詳細を表示したら、そこで終了してください。ユーザーが後続作業を明示的に依頼しない限り、ローカルのチケットコンテキストファイルを作成したり、別のワークフローに移行したりしないでください。

添付ファイル

チケットの HTML フィールド(remarks、comment、progress_comment など)には、ファイルが埋め込まれていることがあります。たとえば、<img src=…> のスクリーンショットや、<span|div data-type="…-attachment" data-src=… data-filename=…> ブロックです。これらの CDN URL は非公開です。直接取得しないでください。検索結果にそのような参照が含まれている場合は、チケットの添付ファイル数を(data-filename または alt に名前がある場合はその名前とともに)回答に記載してください。ただし、ダウンロードはしないでください。

添付ファイルの表示、ダウンロード、分析、またはチケットへのファイル追加をユーザーが依頼した場合は、cawplan-ticket-attachments スキルを使用してください。

回答

検索が成功したら、以下をまとめてください。

  • 照会したチケットの表示 ID と一意 ID。
  • cawplan tickets search が返した各チケットの description にあるタイトルと、remarks にある詳細な説明/本文を表示し、チケットの要件を現在のセッションで確認できるようにしてください。
  • 各チケットの progress_comment がある場合は、現在の進捗として表示してください。空または未設定の場合は、現在の進捗サマリーが返されなかったと明記してください。
  • ユーザーが追加の作業を明示的に依頼していない限り、チケットのコンテキストを表示した後にターンを終了してください。

コメント