linear-dev-accelerator

Linear 開発アクセラレーター

Linear のプロジェクト管理と MCP サーバーの連携を活用して、ソフトウェア開発を加速する包括的なスキルです。このスキルにより、プロジェクトをすばやくセットアップし、課題を効率的に管理し、Web アプリケーションやモバイルアプリケーションの開発ワークフローを効率化できます。

このスキルを使用するタイミング

次のような場合に、このスキルを使用してください。

• 新しいソフトウェア開発プロジェクトを開始し、Linear のプロジェクト管理をセットアップする必要がある場合
• フロントエンド、バックエンド、またはフルスタックアプリケーションの課題、タスク、機能を管理する場合
• 適切な進捗管理のもとで、開発作業をスプリント／サイクルに整理する場合
• ソフトウェアプロジェクトで開発チームと協力する場合
• 開発中のプロジェクト管理タスクを自動化する場合
• バグ、機能、技術的負債を体系的に追跡する場合
• 構造化されたプロジェクト管理ワークフローでアプリケーションを構築する場合
• PR ベースの開発のために Linear と GitHub を連携する場合

基本概念

Linear のプロジェクト管理の理念

Linear は、ソフトウェアチームのスピード、明確さ、集中を重視しています。

• 課題を最優先：作業の単位はすべて、豊富なメタデータを持つ課題として扱います
• スプリント計画のためのサイクル：集中して作業を進めるための期間限定の反復です
• プロダクト計画のためのプロジェクト：より上位の取り組みやロードマップを管理します
• 組織化のためのチーム：異なる機能やプロダクトのためのワークスペースです
• プロセスのためのワークフロー：開発プロセスに合ったカスタムステータスを設定します

Linear の主なエンティティ

1. チーム：組織単位です（例：フロントエンド、バックエンド、モバイル）
2. 課題：個々のタスク、バグ、機能、改善項目です
3. プロジェクト：大規模な取り組みに関連する課題をまとめたものです
4. サイクル：期間限定の反復です（スプリントに類似）
5. ラベル：分類と絞り込みに使用する仕組みです
6. ステータス：課題の状態です（バックログ、未着手、進行中、レビュー中、完了、キャンセル）
7. コメント：課題に関する共同作業や議論に使用します
8. ドキュメント：課題と連携した長文形式のドキュメントです

MCP サーバーツールのリファレンス

課題管理

list_issues

ワークスペース内の課題を一覧表示し、絞り込みます。

一般的なパラメーター：

team: Team name or ID
assignee: User ID, name, email, or "me" for your issues
state: Status name or ID (e.g., "In Progress", "Done")
label: Label name or ID for filtering
project: Project name or ID
query: Search in title/description
limit: Number of results (max 250, default 50)
orderBy: "createdAt" or "updatedAt" (default)
includeArchived: Include archived issues (default: true)

例：

# Get my current issues
assignee: "me"
state: "In Progress"
limit: 10

# Find bugs in a specific project
label: "bug"
project: "Mobile App"
state: "Todo"

# Search for authentication-related issues
query: "authentication"
team: "Backend"

create_issue

すべてのメタデータを含む新しい課題を作成します。

必須パラメーター：

title: Issue title (clear and concise)
team: Team name or ID

任意のパラメーター：

description: Markdown description with details
assignee: User ID, name, email, or "me"
state: State type, name, or ID
priority: 0=None, 1=Urgent, 2=High, 3=Normal, 4=Low
labels: Array of label names or IDs
project: Project name or ID
cycle: Cycle name, number, or ID
parentId: Parent issue ID for sub-issues
dueDate: ISO format date
links: Array of {url, title} objects

例：

title: "Implement user authentication"
team: "Backend"
description: |
  ## Overview
  Add JWT-based authentication to the API

  ## Tasks
  - [ ] Design auth flow
  - [ ] Implement JWT tokens
  - [ ] Add refresh token logic
  - [ ] Write tests

  ## Acceptance Criteria
  - Secure token generation
  - Token expiration handling
  - Proper error responses
assignee: "me"
priority: 2  # High
labels: ["feature", "authentication", "backend"]
project: "API v2.0"

update_issue

既存の課題を更新します。

必須： id（課題 ID）

更新可能なフィールド：

title, description, assignee, state, priority, labels,
project, cycle, parentId, dueDate, estimate, links

例：

id: "issue-uuid-here"
state: "In Progress"
assignee: "me"
labels: ["feature", "in-development"]

get_issue

添付ファイルや Git ブランチを含む、課題の詳細情報を取得します。

パラメーター：

id: Issue ID

戻り値： 添付ファイル、Git ブランチ名、関連データを含む課題の詳細情報

プロジェクト管理

list_projects

プロジェクトを一覧表示し、絞り込みます。

パラメーター：

team: Team name or ID
state: State name or ID
member: User ID, name, email, or "me"
initiative: Initiative name or ID
query: Search project names
limit: Number of results (max 250, default 50)
orderBy: "createdAt" or "updatedAt"
includeArchived: Include archived (default: false)

create_project

新しいプロジェクトを作成します。

必須パラメーター：

name: Project name
team: Team name or ID

任意のパラメーター：

description: Full Markdown description
summary: Concise plaintext summary (max 255 chars)
lead: Project lead (User ID, name, email, or "me")
state: Project state
priority: 0-4 (None, Urgent, High, Medium, Low)
startDate: ISO format date
targetDate: ISO format date
labels: Array of label names or IDs

例：

name: "Mobile App v2.0"
team: "Mobile"
summary: "Complete redesign of mobile app with new features"
description: |
  # Mobile App v2.0

  ## Goals
  - Modern UI/UX redesign
  - Offline-first architecture
  - Push notifications
  - Real-time sync

  ## Timeline
  Q1 2025 - Design & Planning
  Q2 2025 - Development
  Q3 2025 - Testing & Launch
lead: "me"
priority: 2
startDate: "2025-01-15"
targetDate: "2025-09-30"
labels: ["mobile", "redesign", "major-release"]

update_project

既存のプロジェクトの詳細を更新します。

必須： id（プロジェクト ID）

更新可能： 名前、説明、概要、リード、状態、優先度、開始日、目標日、ラベル

get_project

プロジェクトの詳細情報を取得します。

パラメーター：

query: Project ID or name

ラベルと分類

list_issue_labels

利用可能なラベルを一覧表示します。

パラメーター：

team: Team name or ID (optional, for team-specific labels)
name: Filter by label name
limit: Number of results (max 250)
orderBy: "createdAt" or "updatedAt"

create_issue_label

分類用の新しいラベルを作成します。

必須：

name: Label name

任意：

color: Hex color code (e.g., "#10B981")
description: Label description
teamId: Team UUID (omit for workspace label)
isGroup: true for label groups (default: false)
parentId: Parent label UUID for hierarchical labels

例：

name: "frontend"
color: "#3B82F6"
description: "Frontend-related tasks and features"
teamId: "team-uuid-here"

ワークフローとステータス管理

list_issue_statuses

チームで利用可能なステータスを一覧表示します。

パラメーター：

team: Team name or ID (required)

戻り値： id、type、name を含むステータスの配列

• タイプ：backlog、unstarted、started、completed、canceled

get_issue_status

ステータスの詳細情報を取得します。

パラメーター：

id: Status ID
name: Status name
team: Team name or ID (required)

コラボレーション

list_comments

課題のコメントを一覧表示します。

パラメーター：

issueId: Issue ID (required)

create_comment

課題にコメントを追加します。

パラメーター：

issueId: Issue ID (required)
body: Markdown comment content (required)
parentId: Parent comment ID for replies (optional)

例：

issueId: "issue-uuid-here"
body: |
  Great progress! A few notes:

  - Consider edge case for expired tokens
  - Add integration test for refresh flow
  - Document the auth header format

チームとユーザーの管理

list_teams

ワークスペース内のすべてのチームを一覧表示します。

パラメーター：

query: Search query (optional)
limit: Number of results (max 250)
includeArchived: Include archived teams (default: false)

get_team

チームの詳細情報を取得します。

パラメーター：

query: Team UUID, key, or name

list_users

ワークスペース内のユーザーを一覧表示します。

パラメーター：

query: Filter by name or email (optional)

get_user

ユーザーの詳細情報を取得します。

パラメーター：

query: User ID, name, email, or "me"

サイクル（スプリント計画）

list_cycles

チームのサイクルを取得します。

パラメーター：

teamId: Team ID (required)
type: "current", "previous", "next", or omit for all

ドキュメント

list_documents

Linear のドキュメントを一覧表示します。

パラメーター：

query: Search query
creatorId: Creator user ID
projectId: Project ID
initiativeId: Initiative ID
limit: Number of results (max 250)
orderBy: "createdAt" or "updatedAt"
includeArchived: Include archived (default: false)

get_document

ID またはスラッグでドキュメントを取得します。

パラメーター：

id: Document ID or slug

開発ワークフローのパターン

パターン 1：新機能の開発

シナリオ： Web アプリケーション向けの新機能を開発する

1. Create feature issue
   - Use create_issue with:
     - Clear title: "Add dark mode toggle"
     - Detailed description with tasks and acceptance criteria
     - Assign to yourself or team member
     - Add labels: ["feature", "frontend", "ui"]
     - Link to project: "Q1 Features"
     - Set priority based on urgency

2. Break down into sub-tasks (if complex)
   - Create child issues with parentId
   - Each sub-task is a manageable unit of work
   - Example sub-tasks:
     - "Design dark mode color scheme"
     - "Implement theme context in React"
     - "Add toggle button component"
     - "Persist theme preference"

3. Track progress
   - Update issue state as you work:
     - Todo → In Progress → In Review → Done
   - Add comments with updates and blockers
   - Link PR when ready for review

4. Complete and review
   - Update state to "In Review"
   - Add links to PR, deployed preview
   - Mark as Done when merged and deployed

パターン 2：バグのトリアージと修正

シナリオ： バグ報告に効率的に対応する

1. Create bug issue
   - title: Clear description of the bug
   - description: Steps to reproduce, expected/actual behavior
   - labels: ["bug", "priority:high"] if critical
   - assignee: Developer responsible for that area
   - Add links to error logs, screenshots

2. Investigation
   - Update to "In Progress"
   - Add comments with findings
   - Link to related issues if discovered
   - Update priority if needed

3. Fix implementation
   - Reference issue in commit messages
   - Link PR to issue
   - Add comment explaining fix approach

4. Verification and closure
   - State: "In Review" during QA
   - State: "Done" after verification
   - Add comment confirming fix is deployed

パターン 3：スプリント／サイクル計画

シナリオ： 2 週間の開発サイクルを計画する

1. Review backlog
   - list_issues with state: "Backlog"
   - Filter by priority and labels
   - Identify issues ready for development

2. Create or select cycle
   - list_cycles to see current cycle
   - Organize selected issues into cycle

3. Assign and prioritize
   - Distribute issues across team
   - Set priorities: Urgent (1) → High (2) → Normal (3)
   - Balance workload across team members

4. Daily tracking
   - list_issues with assignee: "me", state: "In Progress"
   - Update issue states as work progresses
   - Add comments for standup updates
   - Move blocked issues back to Todo

5. Cycle review
   - List completed issues in cycle
   - Review metrics (velocity, completion rate)
   - Move incomplete issues to next cycle or backlog

パターン 4：新しいアプリケーションのプロジェクト設定

シナリオ： 新しいモバイルアプリプロジェクトを開始する

1. Create project
   - name: "Mobile App - iOS & Android"
   - description: Full project scope, goals, timeline
   - Set lead, dates, labels
   - Link to design docs, PRD

2. Set up project structure
   - Create initial issues for setup:
     - "Setup React Native project"
     - "Configure CI/CD pipeline"
     - "Design component architecture"
     - "Setup state management"
   - Assign to team members
   - Add to project

3. Create epics (major features)
   - Authentication system
   - User profile management
   - Core app functionality
   - Push notifications
   - Each epic is a parent issue with sub-issues

4. Organize into cycles
   - Cycle 1: Project setup & architecture
   - Cycle 2-3: Core features
   - Cycle 4: Polish & testing
   - Assign issues to appropriate cycles

5. Track progress
   - Update project description with status
   - Weekly reviews with get_project
   - Adjust priorities and timeline as needed

パターン 5：GitHub 連携ワークフロー

シナリオ： Linear の課題を GitHub の PR と紐付ける

1. Create issue in Linear
   - Get git branch name from issue: issue.gitBranchName
   - Example: "cetiaiservices/cet-95-create-benchmark-methodology-guide"

2. Create branch using Linear's suggested name
   - Ensures automatic linking
   - Linear tracks PR status automatically

3. Development
   - Commit with Linear issue reference: "CET-95: Add benchmark docs"
   - Linear updates issue automatically when PR created

4. Code review
   - PR opened → Linear sets state to "In Review"
   - Comments on PR can sync to Linear
   - Review feedback tracked in both systems

5. Merge and deploy
   - PR merged → Linear can auto-complete issue
   - Deployment triggers update Linear with links
   - Full traceability from issue → PR → deployment

開発を加速する戦略

戦略 1：課題の一括作成

プロジェクトの開始時に、把握している課題をまとめて作成します。

// Create multiple related issues
const features = [
  "User registration and login",
  "Password reset flow",
  "Email verification",
  "Social auth (Google, GitHub)",
  "Two-factor authentication"
];

// For each feature, create issue with:
- Consistent labeling: ["auth", "feature"]
- Link to parent project: "Authentication System"
- Assign to team members based on expertise
- Set due dates based on project timeline

戦略 2：スマートなフィルタリングで集中する

フィルターを使って認知負荷を軽減します。

// Morning: What do I need to work on today?
assignee: "me"
state: "In Progress"
orderBy: "updatedAt"

// Planning: What's in the backlog for my team?
team: "Frontend"
state: "Backlog"
priority: 2  // High priority items
labels: ["ready-for-dev"]

// Review: What needs my attention?
assignee: "me"
state: "In Review"
orderBy: "createdAt"  // Oldest first

戦略 3：テンプレートを使った課題作成

テンプレートを使って一貫性のある課題を作成します。

// Bug report template
title: "[BUG] {concise description}"
description: |
  ## Bug Description
  {What's wrong?}

  ## Steps to Reproduce
  1. {Step 1}
  2. {Step 2}
  3. {Step 3}

  ## Expected Behavior
  {What should happen}

  ## Actual Behavior
  {What actually happens}

  ## Environment
  - Browser: {browser}
  - OS: {OS}
  - Version: {version}

  ## Additional Context
  {Screenshots, logs, etc.}
labels: ["bug", "needs-triage"]
priority: 3  // Default to normal, adjust after triage

// Feature request template
title: "[FEATURE] {feature name}"
description: |
  ## Feature Description
  {What feature do you want?}

  ## User Story
  As a {user type}
  I want {goal}
  So that {benefit}

  ## Acceptance Criteria
  - [ ] {Criterion 1}
  - [ ] {Criterion 2}
  - [ ] {Criterion 3}

  ## Design Notes
  {Link to designs, wireframes}

  ## Technical Notes
  {Implementation considerations}
labels: ["feature", "needs-refinement"]

戦略 4：ステータス更新の自動化

開発ワークフローの一環として課題を更新します。

// In CI/CD pipeline:
- Tests passing → Add comment with test results
- Deploy to staging → Update with staging URL
- Deploy to production → Mark as Done, add production URL

// In git hooks:
- Pre-commit: Verify issue reference in commit message
- Post-merge: Update Linear issue status
- Tag creation: Link release to completed issues

戦略 5：部門横断の連携

Linear を使ってフロントエンド、バックエンド、モバイルの作業を調整します。

// Create parent issue for full-stack feature
Parent: "User Dashboard Feature"
  ├─ Child: "[Backend] Dashboard API endpoints"
  │   └─ labels: ["backend", "api"]
  ├─ Child: "[Frontend] Dashboard React components"
  │   └─ labels: ["frontend", "react"]
  └─ Child: "[Mobile] Dashboard mobile screens"
      └─ labels: ["mobile", "flutter"]

// Track dependencies
- Backend issue must complete first
- Frontend/Mobile can work in parallel after API ready
- Use "blocked" relation type to track dependencies

ベストプラクティス

課題の作成

1. 明確なタイトル：動詞（Add、Fix、Update、Refactor）で始めます
2. 充実した説明：マークダウン、チェックリスト、コードブロックを使います
3. 適切なラベル付け：一貫性のあるラベル体系を使用します
4. 適切な規模：課題は 1～3 日で完了できる規模にします
5. 受け入れ条件：「完了」の定義を必ず明確にします

プロジェクトの整理

1. 取り組みごとに 1 つのプロジェクト：プロジェクトを作りすぎないようにします
2. 分類にはラベルを使用：プロジェクトより柔軟に分類できます
3. 定期的に整理：完了したプロジェクトをアーカイブします
4. 担当を明確にする：すべてのプロジェクトにリード担当者を設定します
5. ドキュメントをリンク：プロジェクトの説明を最新の状態に保ちます

ワークフローの管理

1. 仕掛かり中の作業を制限：1 人あたり「進行中」の課題は最大 3 件にします
2. ステータスを速やかに更新：課題を最新の状態に保ちます
3. コメントを積極的に活用：決定事項やブロッカーを記録します
4. 関連する課題をリンク：関連付けを通じて背景情報を共有します
5. 課題を最後まで完了：放置された課題を残さないようにします

チームでのコラボレーション

1. 担当を明確に割り当てる：すべての課題に担当者を 1 人設定します
2. @メンションを使う：コメントでメンバーにタグ付けし、見落としを防ぎます
3. 定期的にレビュー：プロジェクト／サイクルのレビューを毎週行います
4. 成果を祝う：マイルストーンや達成事項を記録します
5. 背景情報を共有：PR、ドキュメント、デザインへのリンクを追加します

ラベル体系

推奨されるラベルのカテゴリ：

Type Labels:
- feature, bug, improvement, docs, refactor, test

Priority Labels:
- priority:urgent, priority:high, priority:normal, priority:low

Area Labels:
- frontend, backend, mobile, devops, design, qa

Status Labels:
- blocked, ready-for-dev, needs-review, waiting-on-qa

Technology Labels:
- react, flutter, python, node, postgres, redis

開発ツールとの連携

GitHub 連携

• Linear が提案する Git ブランチ名を使用します
• コミットメッセージで Linear の課題を参照します：「CET-123: Add feature」
• PR は Linear の課題に自動的にリンクされます
• PR のステータスによって Linear の課題のステータスが更新されます
• マージ時に課題を自動的に完了できます

CI/CD 連携

• テスト結果を Linear の課題へのコメントとして投稿します
• デプロイ時に課題を更新します
• 課題のコメントにデプロイ URL をリンクします
• 課題ごとにデプロイのステータスを追跡します

Slack 連携

• 割り当てられた課題の通知を受け取ります
• Slack から Linear を更新します
• チームのチャンネルで課題のリンクを共有します
• 自分の課題を含む毎日のスタンドアップリマインダーを受け取ります

アプリケーションの種類別の一般的なワークフロー

フロントエンドアプリケーションの開発

1. Design → Development workflow:
   - Create issue from design handoff
   - labels: ["frontend", "ui", "design-ready"]
   - Link to Figma/design files
   - Break into component-level issues

2. Component development:
   - Parent: "User Profile Page"
     ├─ "ProfileHeader component"
     ├─ "ProfileStats component"
     ├─ "ProfileSettings component"
     └─ "Profile routing and layout"

3. Integration and testing:
   - Create issues for:
     - Integration testing
     - Accessibility audit
     - Performance optimization
     - Browser compatibility testing

フルスタックアプリケーションの開発

1. Feature planning:
   - Parent issue: "Payment Processing Feature"
   - Children:
     - Database schema design
     - API endpoint implementation
     - Frontend payment form
     - Payment provider integration
     - Error handling and logging
     - Testing (unit, integration, E2E)

2. Parallel development:
   - Backend team: API and database
   - Frontend team: UI components (mocked API)
   - Coordinate through Linear comments
   - Track blockers and dependencies

3. Integration phase:
   - Create integration testing issue
   - Link all related issues
   - Coordinate deployment

モバイルアプリケーションの開発

1. Platform-specific tracking:
   - labels: ["ios", "android", "shared"]
   - Track platform-specific bugs separately
   - Share code issues labeled "shared"

2. Release management:
   - Project per release: "iOS v2.1.0"
   - Issues per feature/fix in release
   - Track App Store/Play Store submissions
   - Link to release notes

3. Testing workflow:
   - Device testing: Track per device type
   - OS version compatibility
   - Performance on different hardware
   - Beta testing feedback

トラブルシューティング

よくある問題

フィルターに課題が表示されない

• アーカイブ済みか確認します：includeArchived: true を設定してください
• チーム名／ID が正しいか確認してください
• ステータスが想定どおりか確認してください

課題を作成できない

• チームパラメーターが指定されていることを確認してください（必須）
• ラベルを使用する場合は、ラベル名が存在することを確認してください
• プロジェクト名／ID が有効か確認してください
• 担当者がワークスペースに存在することを確認してください

課題を更新できない

• 課題 ID が正しいか確認してください（まず get_issue を使用してください）
• 課題を変更する権限があるか確認してください
• ステート名が有効か確認してください（list_issue_statuses を使用してください）
• ラベル名が存在することを確認してください

プロジェクトが読み込まれない

• includeArchived の設定を確認してください
• チームフィルターが正しいか確認してください
• すべてのプロジェクトを表示するため、フィルターを適用せずに試してください

高度な使い方

プロジェクト設定の自動化

プログラムで完全なプロジェクト構造を作成します：

1. Create project
2. Create label set for project
3. Create epic issues (parent issues)
4. Create sub-issues for each epic
5. Assign issues to team members
6. Organize into first cycle
7. Generate project documentation

メトリクスとレポート

開発メトリクスを追跡します：

// Velocity tracking
- Issues completed per cycle
- Average time to complete
- Blockers frequency

// Quality metrics
- Bug rate per feature
- Time to fix bugs
- Reopened issues

// Team metrics
- Issues per team member
- Workload balance
- Completion rates

カスタムワークフロー

プロセスに合ったワークフローを設計します：

// Example: Feature flag workflow
States:
1. Backlog (unstarted)
2. Ready for Dev (unstarted)
3. In Development (started)
4. In Review (started)
5. In QA (started)
6. Deployed with Flag (started)
7. Flag Enabled (started)
8. Monitoring (started)
9. Flag Removed (completed)
10. Done (completed)

クイックリファレンス

基本的なショートカット

My active work:
  assignee: "me", state: "In Progress"

Team backlog:
  team: "{team-name}", state: "Backlog", orderBy: "updatedAt"

High priority issues:
  priority: 2, state: "Todo", orderBy: "createdAt"

Recently updated:
  orderBy: "updatedAt", limit: 20

Bugs needing triage:
  label: "bug", state: "Backlog", orderBy: "createdAt"

課題作成テンプレート

title: "[TYPE] Clear, actionable title"
description: |
  ## Overview
  {What and why}

  ## Tasks
  - [ ] Task 1
  - [ ] Task 2

  ## Acceptance Criteria
  - Criterion 1
  - Criterion 2
team: "{team-name}"
assignee: "me"
labels: ["{type}", "{area}", "{priority}"]
project: "{project-name}"
priority: 3

リソース

• Linear のドキュメント：https://linear.app/docs
• Linear API リファレンス：https://developers.linear.app/docs
• Linear ブログ：https://linear.app/blog
• GitHub 連携ガイド：https://linear.app/docs/github
• Linear キーボードショートカット：linear.app/shortcuts

---

スキルのバージョン：1.0.0 最終更新日：2025年10月 スキルのカテゴリ：プロジェクト管理、開発の加速、チームコラボレーション 対応環境：Linear MCP Server、GitHub、CI/CD パイプライン