mcpField
L
linear-create-issue

linear-create-issue

github.com/lkshrk生産性144 回インストール4 週間前に更新
リポジトリ

linear-create-issue について

受付情報を Linear に登録できる課題へ整理するワークフロースキルです。最新のチーム、プロジェクト、ラベル情報を使ってメタデータ選択を支援し、書き込みツールがない場合は必要な変更を明示します。

主な機能

  1. 01最新のチーム、プロジェクト、ラベルの取得
  2. 02課題受付とメタデータ選択の案内
  3. 03JavaScriptランナーの検出と補助スクリプト実行
  4. 04メタデータスナップショットの取得と検証
  5. 05書き込み不可時の変更内容の明示

活用シーン

  1. 01Linearのバグ課題や機能課題の作成
  2. 02対象チーム、プロジェクト、ラベルの選定
  3. 03Linearの書き込み権限がない場合の変更準備

MCP 対応

Linear MCPツールでチーム、プロジェクト、ラベルを取得し、書き込みツールが利用可能な場合は課題を作成または更新します。

インストール

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

$npx skills add https://github.com/lkshrk/linear-ai --skill linear-create-issue

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
issue-intake.md
openai.yaml
docs/
agent-required-passes.md
issue-intake.md
scripts/
detect_runner.ts
intake_issue.ts
linear_metadata.ts
templates/
linear-bug-issue.md
linear-feature-issue.md

詳細

Linear Create Issue

ワークフローのソースとしてリポジトリのルートを使用します。以下を読み、指示に従ってください。

  • agents/issue-intake.md
  • docs/issue-intake.md
  • docs/agent-required-passes.md
  • templates/linear-bug-issue.md
  • templates/linear-feature-issue.md

最終確定する前に、利用可能な Linear のチーム、プロジェクト、ラベルを照会してください。最新の Linear データを使って、対象チーム、対象プロジェクト、該当する Linear ラベル／タグ、タイプラベル、LLM ラベルを質問または提案してください。古いタグ一覧やハードコードされたタグ一覧は使用しないでください。Component ラベルは必須にせず、最新の Linear ラベル全体から候補となるラベルを提案し、最終確定する前にタグを追加するか確認してください。

Linear MCP Contract

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

  • list_teams - 対象チームを選択する前に、利用可能な Linear チームを確認します。
  • list_projects - 対象プロジェクトを選択する前に、利用可能な Linear プロジェクトを確認します。
  • list_issue_labels - ラベルを提案する前に、利用可能な Linear ラベルを確認します。
  • save_issue - 書き込みが可能な場合に Linear の課題を作成または更新し、ラベル／優先度を適用します。

最新データを用いた受付の手順：

  1. list_teams、list_projects、list_issue_labels を実行します。
  2. これらの最新の結果から、対象チーム、対象プロジェクト、該当する Linear ラベルを提案します。
  3. ユーザーがすでに明示的に拒否していない限り、タグを追加するか確認します。
  4. その回答を受け取った後にのみ、最終的なラベルセットを指定して save_issue を呼び出します。

対象環境で利用できるローカル JavaScript ランナーを使用します。以下で検出してください。

bun scripts/detect_runner.ts

そのランナーを使って TypeScript ヘルパーを実行します。たとえば、bun scripts/intake_issue.ts ...、pnpm exec tsx scripts/intake_issue.ts ...、または npm exec tsx -- scripts/intake_issue.ts ... のように実行します。

Linear MCP のメタデータを読み取った後、決定論的なチェックを行う前に、未加工の結果をローカルのスナップショット形式に取り込みます。

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

npm／pnpm／yarn／node 環境では、同等の tsx コマンドを使用します。--teams、--projects、--labels の各ファイルには、list_teams、list_projects、list_issue_labels の最新の出力を含める必要があります。

取り込んだメタデータのスナップショットを検証するには、scripts/linear_metadata.ts validate ... を使用します。課題のフィールドが構造化 YAML にすでに存在し、メタデータのスナップショットを利用できる場合に限り、scripts/intake_issue.ts --metadata <metadata.json> <input.yaml> を使用します。それ以外の場合は、エージェントのプロンプトに直接従い、利用可能であれば Linear MCP ツールを使用してください。

Linear MCP の書き込みツールを利用できない場合、課題を作成または更新したと主張しないでください。人間が適用すべき正確な対象チーム、ラベル、優先度、課題本文を含む REQUIRED_LINEAR_MUTATIONS を出力してください。

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

課題の受付が完了したら、変更内容、Linear 課題の URL または REQUIRED_LINEAR_MUTATIONS、選択したチーム／プロジェクトと提案したラベル／タグ、現在の Linear ラベル／ステータス、推奨される次のステップを報告してください。

この受付ステップに追加することがあるか尋ねてください。ある場合は現在のステップを続け、課題の下書きまたは Linear の課題を更新してください。ない場合は、次のワークフローステップ（通常は llm-refine が含まれている場合の linear-refine）への移行を提案してください。

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

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

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

課題本文が Linear に登録できる状態になり、最終メタデータが明確になったら停止してください。最終メタデータには、対象チーム、該当する場合は対象プロジェクト、提案された該当ラベル／タグ、適用／削除するラベル、指定されている場合は優先度、ユーザーがタグの追加を希望するかどうか、llm-refine が必要かどうかを含めます。

コメント

Markdown 対応