linear-deliver-feature

Linear Deliver Feature

1 つの Linear 課題のライフサイクル全体を管理するコントローラーとして使用します。各フェーズの実装にはより範囲の狭いスキルを実行しますが、状態遷移はここで管理してください。

ワークフローの状態やコードを変更する前に、docs/superpowers-linear-persistence.md を読んで、その指示に従ってください。

まず、実際の Linear 課題に対して linear-status を実行します。検出されたラベル、ステータス、最新のマーク付きコメント、課題説明のダッシュボードを使って、検出されたフェーズから再開してください。Linear の情報が利用できる場合は、記憶やユーザーの直近のチャットメッセージをもとに開始しないでください。

ライフサイクル状態機械

1. detect-current-state - linear-status を実行し、現在のフェーズ、不足している証拠、状態の不一致、推奨される次のスキルを特定します。
2. capture-metadata - Linear のチーム、プロジェクト、ラベルをライブクエリし、scripts/linear_metadata.ts capture で正規化します。
3. create-issue - linear-create-issue を実行し、対象チーム、対象プロジェクト、候補となる一致ラベル／タグ、種別ラベル、LLM 状態ラベル 1 つを指定して、課題を作成または更新します。
4. refine-plan - 課題に plan_status: ready のマーク付き計画コメントが付くか、明示的にブロック済み／不明な状態を受け入れるまで、linear-refine を実行します。
5. implement - ready 状態の計画が存在し、Superpowers のタスクリストが課題説明のダッシュボードに反映され、直接実行と同じ必須の実装者権限コンテキストが渡されているか確認された後に限り、linear-implement を実行します。このコンテキストには、ワークスペースへの書き込みアクセス、パッケージマネージャーと検証コマンドの実行権限、Linear MCP の読み書きツール、ブランチまたは PR 作業が対象となる場合は Git／GitHub ツール、必要なプロジェクト MCP ツールが含まれます。コードを変更し、検証を実行し、トップレベルのタスク間を移る前にダッシュボードを更新してください。マーク付きステータスコメントを投稿するのは、ブロッカー、レビュー準備完了、作業の中止、検証失敗、引き継ぎ、または書き込み不可による変更のみです。
6. validate-comments - ワークフローをレビュー準備完了とする前に、最終的な計画／ステータスコメントと課題説明のダッシュボードに対して scripts/validate_marked_comments.ts を実行します。
7. review-handoff - PR またはパッチの準備ができていること、検証の証拠があること、課題にワークフロー状態ラベルが 1 つだけ付いていることを確認します。レビュー準備完了の場合は llm-review、未完了の場合は llm-blocked です。
8. closeout - レビュー後、PR がマージ済みである場合、課題 ID が直接記載されたコミットの証拠がある場合、または squash／インポートのリリース証拠により、期待されるファイル／内容の証拠が現在の main に含まれ、リリース／main の CI が成功したと確認できる場合に限り、linear-close を実行します。マージ済み PR、直接コミット、またはリリースの証拠に加えて、mainline と CI の証拠も確認します。その後、課題を Done に移し、すべての llm-* ラベルを削除し、累積する sp-* ラベルは保持して、ダッシュボードを更新し、最終クローズの証拠を投稿します。現在の課題 ID とチケットの証拠にある実装済み課題 ID で、別のチームへの移動により Linear のチームプレフィックスが異なる場合は、同じルールに従って古い実装済み ID を手動で確認し、現在の課題をクローズして、クローズの記録に両方の ID を含めます。
9. final-linear-mutations - 書き込みツールが利用可能な場合は Linear MCP で最終ラベル／コメントを適用します。利用できない場合は、変更内容を正確に示した REQUIRED_LINEAR_MUTATIONS を出力します。

現在の状態に必要な証拠が不足している場合は、次のライフサイクル状態に進まないでください。現在の状態で停止し、ブロッカーを記録してください。

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

各ライフサイクル状態の完了後、変更内容、現在の状態が満たされていることを示す証拠、現在の Linear ラベル／ステータス、マークされたコメントの改訂内容、および推奨される次のステップを報告します。

このライフサイクル状態について、ほかに追加することがあるか尋ねてください。ある場合は、現在のステップを続け、関連する課題、計画、コード、検証、またはステータスコメントを更新します。ない場合は、次のワークフローステップへの移行を推奨し、次のライフサイクル状態を明示します。

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

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

Linear MCP の契約

各フェーズのスキルを通じて Linear MCP を使用します。

• linear-status は get_issue と list_comments を使用します。
• linear-create-issue は list_teams、list_projects、list_issue_labels、save_issue を使用します。
• linear-refine は get_issue、list_comments、save_comment、save_issue を使用します。
• linear-implement は get_issue、list_comments、save_comment、save_issue を使用します。
• linear-close は get_issue、list_comments、save_comment、save_issue を使用します。

フェーズ間の検証を省略しないでください。次を使用して、最新のメタデータを取得してください。

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

次を使用して、マークされたコメントと、CLI 形式のタスクリストおよび symbol タスクマーカーを含む linear-ai.dashboard.v1 課題の説明ダッシュボードを検証してください。

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

構造化されたインテークのドライランには、次を使用してください。

scripts/intake_issue.ts --metadata <metadata.json> <input.yaml>

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

停止条件

• Linear MCP の読み取りツールが利用できず、最新のメタデータスナップショットもない場合は、capture-metadata で停止します。
• ライブメタデータから対象チーム、対象プロジェクト、提案する一致ラベル／タグ、または種別ラベルを選択できない場合は、create-issue で停止します。
• 必要なプロダクト情報が不足しており、不明点として受け入れられない場合は、refine-plan で停止します。
• 準備完了した計画が満たされたことを検証によって証明できない場合は、implement で停止します。
• 課題を最終 LLM 状態ラベルのちょうど 1 つに移行できない場合は、review-handoff で停止します。
• PR のマージ、移行済み旧 ID の実装証拠、スカッシュ／インポートのリリースファイルまたは内容の証拠、メインライン、または CI の証拠が不足している場合は、closeout で停止します。クローズアウトが証明されるまでは llm-review を維持してください。

いずれかのフェーズが、プロダクト情報の不足または書き込み権限の欠如によってブロックされた場合は、推測せず、正確な REQUIRED_LINEAR_MUTATIONS を投稿または出力し、ブロックされた引き継ぎ状態で停止してください。