linear-doctor

Linear Doctor

ワークフローの実行前、またはセットアップの状態が不明な場合に、セットアップの確認として使用します。

Linear MCP コントラクト

利用可能な場合は、次の Linear MCP ツールを使用します。

• list_teams - 利用可能なチームを読み取ります。
• list_projects - 利用可能なプロジェクトとそのチームを読み取ります。
• list_issue_labels - タイプ、コンポーネント、LLM、Superpowers のラベルを読み取ります。
• save_issue は必須ではありません。エージェントに既存の課題の修正を明示的に依頼された場合を除き、セットアップの診断は読み取り専用です。

次の方法で、現在のメタデータを取得して検証します。

scripts/linear_metadata.ts capture --teams linear-teams.json --projects linear-projects.json --labels linear-labels.json > linear-metadata.json
scripts/linear_metadata.ts validate --metadata linear-metadata.json

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

Linear MCP の読み取りツールが利用できない場合は、エクスポートしたチーム、プロジェクト、ラベルの情報を求めてください。Linear MCP の書き込みツールが利用できない場合、またはラベルの作成がサポートされていない場合は、正確なセットアップ変更を含む REQUIRED_LINEAR_MUTATIONS を出力してください。

必須のセットアップ

不足している llm-* ワークフローラベルを報告します。

• llm-refine
• llm-ready
• llm-active
• llm-blocked
• llm-review

不足しているクレームロックラベル（llm-* 状態マシンの対象外）を報告します。

• in-use

不足している sp-* Superpowers フェーズラベルを報告します。

• sp-clarify
• sp-plan
• sp-implement
• sp-review
• sp-verify

不足しているコンポーネントラベル、タイプラベル、対象チーム、対象プロジェクトを報告します。コンポーネント、タイプ、プロジェクトの名前はワークスペースによって異なるため、古くなった一覧をハードコードするのではなく、現在の Linear メタデータから有力な値を提案してください。

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

次の項目を報告します。

• 現在のフェーズ
• このドクターの実行でセットアップを修復または明確化した場合は、その内容
• 現在のチーム、プロジェクト、ラベルから得られた根拠
• 不足している根拠
• 未解決のブロッカー
• 推奨する次のステップ
• 推奨する次のスキル

このセットアップのステップに追加するものがないか尋ねてください。ある場合は、そのセットアップ項目を確認して現在のステップを続けます。ない場合は、次のワークフローステップ（通常、新しい課題なら linear-create-issue、既存の課題なら linear-status）に進むことを推奨します。

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

次の形式で回答します。

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

セットアップの準備が整うか、不足しているラベル、プロジェクト、ステータスを正確に示す REQUIRED_LINEAR_MUTATIONS の一覧が提示された時点で終了します。