factory-tickets

factory-tickets

このスキルの機能

factory-tickets は、ソフトウェアファクトリーの読み取り専用の個人作業リストエンジンです。抽象的なステータスではなく「次のアクション」に基づいて分類し、ユーザーのアクティブなキューの最新情報を、すぐに実行に移せる形で提示します。

トラッカーに依存しない統合レイヤー（factory-mission/references/tracker-integration.md）を使用して、外部のイシュートラッカーと PR ホスト（GitHub、GitLab、Linear、Jira）を直接操作します。

---

使用するタイミング

• セッションの開始時や一日の計画を立てるときに、次に何に対応する必要があるかを正確に把握するため。
• 自分のプルリクエストのうち、マージ可能なもの、ブロックされているもの、レビューへのフィードバックを待っているものを確認するため。
• 割り当てがなく、ブロックされていない（spec-gated）実行可能なチケットを見つけるため。

使用しないタイミング：

• チケットのステータスや担当者を変更したり、本文を編集したりする場合（このスキルは厳密な読み取り専用です）。
• タスクを実行または実装する場合（代わりに factory-mission を使用してください）。

---

操作プロセス

1. プロバイダーとユーザー情報の確認

1. アクティブなトラッカープロバイダーと認証情報を確認します（factory-mission/references/tracker-integration.md）。
2. 認証済みユーザーのログイン名を特定します。検索対象は次に限定します：
   • 認証済みアカウントが作成したプルリクエスト。
   • 認証済みアカウント（または明示的に指定された別のログイン名）に割り当てられたチケット。

2. 2つの情報源に対するページング検索

個々のアイテムをポーリングしてはいけません。2つのページング検索（MCP または CLI 経由）を実行し、各情報源につき1回のラウンドトリップですべてのアクティブな項目を取得します：

1. プルリクエスト検索：ユーザーのオープン PR を取得します。ドラフトの状態、レビュー判定、未解決のスレッド、名前付きチェックのステータス、マージ可能かどうかを含めます。
2. イシュー検索：ユーザーに割り当てられたオープンイシューを取得します。タイトル、説明、状態、ラベル、マイルストーン、関連するプロジェクトのメタデータを含めます。

3. 根拠の照合（トラッカー非依存）

1つの PR が複数のチケットを相互参照していることはよくあります。明確な根拠がある場合に限り、プルリクエストをチケットに関連付けます：

• トラッカーによって確立されたクローズリンク。
• リポジトリの規則に従って、チケット番号を含むブランチ名。
• チケット番号を明示的に記載したPR タイトル。 明確な根拠がない場合は、関連付けの欄を空欄にします。単にテキストに言及されているだけで推測してはいけません。

4. 次のアクションを分類（次のアクション別セクション）

取得した各項目を、次の優先度セクションのいずれか1つだけに割り当てます。割り当てた内容をそのまま表示し、書式設定時に再分類してはいけません：

1. アクティブなプルリクエスト（自分の番）：次のアクションをユーザーが行うプルリクエスト：
   • Merge — 必須チェックがすべて成功し、人による承認が完了しています。マージ可能なものを最初に表示します（最優先）。
   • Address Review Feedback — レビュアーから変更を求められています。
   • Fix failing check: <name> — 必須 CI チェックが失敗しています（まとめて表示せず、チェック名を報告します）。
   • Answer N comment threads — 未解決のレビュアーからの質問があります。
   • Finish Draft — PR はまだドラフト状態です。
2. アクティブなプルリクエスト（相手の番）：外部の対応を待っているプルリクエスト：
   • Awaiting Review — レビュー可能な状態で、レビューを依頼されたレビュアーからの回答を待っています。
   • Awaiting CI — 必須チェックがまだ実行中です。
3. マージ済み、チケットは未解決：このチケットをクローズする PR はマージ済みですが、チケットはボード上でオープンのままです。次のアクションは、確認してからクローズすることです。
4. 今すぐ着手可能（バックログ）：ライフサイクルが spec-gated で、自動化ゲートが agent-can-execute であり、関連付けられたプルリクエストがないオープンイシュー。（該当する項目がない場合は、「なし」と明示します）。
5. 他の人の対応待ち：未解決のブロック依存関係があるオープンイシュー。ブロックしているチケットを明記します。

注：エピックと親イシューは、以下のルールの後にある付録に記載し、子項目の数と進捗を表示します。アクティブなタスクリストには含めません。

---

不変条件と安全制約

1. 厳格な読み取り専用：このスキルでは、チケット、ラベル、担当者、ボードの各フィールドを物理的に編集、コメント、作成、変更することはできません。gh や glab の書き込みコマンドは含まれていません。
2. キャッシュなし：実行のたびにライブデータを取得します。キャッシュされたキューや古いキューは、キューがないよりも悪い状態です。
3. ロールアップから推測しない：ジョブが単にキャンセルまたはスキップされただけの場合、ロールアップされた「失敗」のコミットステータスからチェックのステータスを報告しないでください。実際に失敗したコンテキストを確認し、名前を明記してください。
4. 解析されなかった単語の報告：ユーザーのリクエストにクエリパーサーが認識しない単語が含まれている場合、それらを省かないでください。テーブルの下に「未解析の用語」セクションを設け、無視された用語がわかるように記載してください。