linear-status

Linear Status

1 件の Linear イシューの読み取り専用ステータス確認および再開判定に使用します。エージェントが次に何をすべきか分からない場合は、ここから開始してください。

Linear MCP Contract

利用可能な場合は、次の Linear MCP ツールを使用してください。

• get_issue - イシューの説明ダッシュボード、ラベル、ステータス、担当者、プロジェクト、ブランチのメタデータ、リンクを読み取ります。
• list_comments - 最新のマーク付きプランコメントとステータスコメントを探します。

マーク付きコメントとイシューの説明ダッシュボードを、次を使って検証してください。

scripts/validate_marked_comments.ts --description <issue-description-file> <comment-file>

エージェントが利用できるローカルの JavaScript パッケージマネージャーまたはランタイムを使用してください。Bun では .ts スクリプトを直接実行できます。Node/npm/pnpm/yarn 環境では、tsx などの TypeScript ランナーを通じて実行してください。

Linear MCP の読み取りツールを利用できない場合は、イシューの説明、ラベル、ステータス、最新のマーク付きコメントを貼り付けるよう依頼してください。Linear MCP の書き込みツールを利用できない場合、またはイシューの状態を修復する必要がある場合は、適用すべき説明、ラベル、ステータス、コメントを正確に記載した REQUIRED_LINEAR_MUTATIONS を出力してください。

フェーズ判定

記憶ではなく、実際のイシューの状態から現在のフェーズを判定してください。

• setup-blocked - 必須の Linear ラベル、プロジェクト、またはコンポーネント／種別ラベルが不足しています。linear-doctor を実行してください。
• create-issue - Linear イシューが存在しないか、受付メタデータが不完全です。linear-create-issue を実行してください。
• refine-plan - イシューに llm-refine が付いている、有効な ready プランがない、または未解決のプロダクト上の疑問があります。linear-refine を実行してください。
• implement - イシューに llm-ready が付いており、最新の有効なプランの plan_status: ready です。linear-implement を実行してください。
• blocked - イシューに llm-blocked が付いているか、最新のステータスコメントに未解決の質問があります。linear-refine を実行するか、記載されたブロッカーについて質問してください。
• review-handoff - イシューに llm-review が付いているか、最新のステータスコメントが review_ready です。人によるレビューの準備をしてください。
• repair-state - ラベル、説明ダッシュボード、コメントの内容が一致しない、複数の llm-* 状態が存在する、最新のマーク付きコメントが無効、必須のダッシュボード／ステータスの根拠が不足している、または in-use のクレームロックが古いか矛盾している（Claim Lock Check を参照）状態です。

ラベル、説明ダッシュボード、コメントの内容が一致しない場合は、検証済みのマーク付き情報を根拠として優先し、説明、ラベル、またはステータスに対する最小限の修復を提案してください。

Claim Lock Check

docs/workflow.md の Claim Lock Rule に従って in-use クレームロックを調べ、ロックが放置されているように見える場合は、repair-state の下で claim-stale の検出結果を報告してください。

Tier 1 — 構造上の矛盾（ラベルのみで判定可能、信頼性あり）。現在の状態と正当に共存できない場合は、in-use を指摘してください。

• イシューが Done／クローズ済みなのに in-use が付いたままになっている（解除漏れ）。
• in-use が付いているものの、アクティブな作業状態がない、または停止時に解除される状態（llm-ready、llm-blocked）になっている。

llm-refine、llm-active、または llm-review と併せて付いている in-use は、正当に保持されているロックです。ラベルだけを根拠に指摘しないでください。

Tier 2 — 古さの判定（クレームのメタデータが必要）。説明に linear-ai:claim ブロックがある場合、now - claimed_at が古さのしきい値（デフォルトは 60 分。ユーザーによる変更を許可）を超えたらロックを stale とみなしてください。claimed_by と経過時間を報告してください。in-use があるのに claim ブロックがない場合は、不一致として指摘してください（ラベルと claim ブロックは両方とも存在するか、両方とも存在しない必要があります）。そのうえで、Tier 1 の確認にフォールバックしてください。

ロックが stale または矛盾している場合は、最小限の修復として in-use ラベルと linear-ai:claim ブロックの削除を提案してください。書き込みツールを利用できるファイナライザーとして明示的に作業している場合を除き、修復を適用しないでください。それ以外の場合は、REQUIRED_LINEAR_MUTATIONS として出力してください。

ステップ完了時の引き継ぎ

次の内容を報告してください。

• 現在のフェーズ
• このステータス確認で状態を修正または明確化した場合は、その変更内容
• issue のラベル／ステータスと、最新のマーク付きコメントから得られる根拠
• 不足している根拠
• 未解決のブロッカー
• 推奨する次のステップ
• 推奨する次のスキル

このステータス確認のステップに追加することがあるか尋ねてください。ある場合は、新たな根拠を再確認して現在のステップを続行してください。ない場合は、次のワークフローステップへの移行を推奨し、実行するスキル名を伝えてください。

追加事項について「いいえ」と回答された後、推奨する次のスキルに進むかどうかを尋ねてください。推奨する次のスキル名を明示し、ユーザーの確認を待ってください。自動的に実行してはいけません。

次の形式で回答してください。

• 現在のフェーズ
• 変更内容
• 根拠
• 不足している根拠
• 未解決のブロッカー
• 推奨する次のステップ
• 推奨する次のスキル
• 質問：次に進む前に追加することはありますか？
• 質問：推奨する次のスキルに進みますか？

フェーズの診断、不足している根拠の一覧、推奨する次のスキルを提示したら終了してください。書き込みツールを使用できるファイナライザーとして明示的に動作する場合を除き、issue の状態を変更してはいけません。