breaking-down-linear-issues

Files (1)

• SKILL.md

SKILL.md (first lines)

# Linearに大きなタスクを分割してIssueを作成する

ユーザーが大きなタスクをLinearにIssueとして登録したい場合、タスクを分割して複数のIssueを作成してください。分割する際は**新しいプロジェクトを作成し**、そのプロジェクト内にフラットなIssueを作成します。Issue間の関係は、**階層構造ではなく`blockedBy`リレーション**で表現します。

作成したIssueはLinearを経由してLLM Agentにアサインされます。

プロンプトに特定の意図（例：「3つのIssueに分割して」「Aを先にやってからBを作成して」など）が加えられている場合は、その意図をタスク分解と依存関係の設定に反映しつつ、以下の手順を順に実行してください。

## 制約

<important>

- タスクを分割する際は、新しいLinearプロジェクトを作成する。
- 各Issueは独立した同等のフラットな単位として作成する。sub-issueや親子関係は作らない。
- Issue間の依存関係は、必ず `blockedBy` リレーションで表現する。
- ユーザーが承認するまで、プロジェクト・Issueの作成を実行しない。
- 以下の手順を一つずつ順番に実行する。

</important>

## 実行手順

<procedure>

以下の手順で、大きなタスクを分割してLinearにIssueを作成してください。

1. **入力の整理**

   ユーザーから以下の情報を確認する。情報が不足している場合は、ユーザーに確認を取る。

   - タスクの概要（タイトル・目的）
   - 作成するプロジェクト名
   - Linearのチーム（Team）
   - プロジェクト概要に記載すべき内容（背景、スコープ、制約、達成条件、関連リンクなど）
   - 分割したい作業単位
   - 各作業の依存関係（どのIssueがどのIssueにブロックされるか）

2. **タスクの分解**

   ユーザーから得た情報に基づき、タスクを意味のある単位に分割する。

   - 各Issueは独立して完了可能な単位にすること
   - 1つのIssueは、diffが500〜1000行程度になるようなPRに対応するサイズにすること
   - 分割したIssue間の依存関係を明確にすること

3. **作成内容の確認**

   ユーザーに以下を提示し、承認を得てから作成を実行する。

   - 作成するプロジェクト名とプロジェクト概要（背景、スコープ、制約、達成条件、関連リンク）
   - 作成するIssueの一覧（タイトルと説明）
   - 各Issue間の依存関係（`blockedBy` で表現）
   - 所属チーム

4. **プロジェクトの作成**

   承認を得たら、Linear MCP serverを使ってプロジェクトを作成する。

   ```bash
   # Linear MCP server を使って project を作成する例（mcp_call_tool で実行）
   # Linear project create のスキーマに従って引数を指定する
   ```

   - プロジェクト名、所属チーム、プロジェクト概要を設定する
   - プロジェクト概要には個別Issueの詳細を書かず、背景・スコープ・制約・達成条件・関連リンクなどを記載する
   - 作成後にプロジェクトIDを記録する

5. **Issueの作成**

   作成したプロジェクト内に、Linear MCP serverを使ってIssueを作成する。各Issueは単独で見てもself-containedで分かる形にし、以下を含める。

   - タイトル
   - 目的（なぜやるか）
   - 背景
   - 作業内容
   - 受け入れ条件
   - 制約
   - 関連リンク
   - 該当ファイルや行
   - プロジェクトのリンク
   - 依存関係の確認手順
     - 作業前にプロジェクト内のIssueを確認する
     - 自身の `blockedBy` に設定されているIssue（前段のタスク）を読み、どのような内容かを把握する
     - 自身を `blockedBy` に設定しているIssue（後段のタスク）を読み、後段で何を行うためには今回のタスクで何が必要かを把握する
     - 前段・後段のタスク内容を踏まえて、今回のタスクの作業内容と受け入れ条件を調整する

   ```bash
   # Linear MCP server を使って issue を作成する例（mcp_call_tool で実行）
   # Linear issue create のスキーマに従って引数を指定する
   ```

   - 各Issueを個別に作成する
   - 作成するIssueに作成したプロジェクトを紐付ける
   - 作成後に各IssueのID（identifierまたはUUID）を記録する

6. **blockedByリレーションの設定**

   作成したIssue間で依存関係がある場合は、**必ず`blockedBy`リレーション**で設定する。

   - 前提となるIssueを、後続のIssueの `blockedBy` に設定する
   - `blockedBy` の方向に注意する

7. **結果の報告**

   ユーザーに以下を報告する。

   - 作成したプロジェクトの名前とURL
   - 作成したIssueのタイトルとURL
   - 設定した`blockedBy`の一覧
   - 次に行うべき作業（あれば）

</procedure>

## 依存関係の表現

<decision-criteria name="dependency-expression">

| 状況 | 表現方法 | 理由 |
|------|----------|------|

From syou6162/agent-skills, MIT.

More from syou6162/agent-skills