linear-issue-workflowlisted

# linear-issue-workflow (v3.4.0+) Linear の workspace > team > project > **issue** 階層において、 issue は「**具体的な作業単位**」。 1 issue = 1 PEV task に相当。 project は親、 issue は子。 この skill は AI agent が issue を **読む / 書く / 更新する** ときの規約と template を提供する。 PEV pipeline 経由の sync (= inbound / outbound / issue-first) は `pev-linear-sync` 側、 親 project の理解は `linear-project-workflow` 側。 ## When to Use - AI agent が Linear Issue を **新規作成** する時 (= pev-linear-sync Direction 1.5 issue-first から呼ばれる) - 既存 Linear Issue を **読んで spec に変換** する時 (= pev-linear-sync inbound から呼ばれる) - 既存 Linear Issue を **更新** する時 (= 進捗報告 / status 遷移 / 関連 issue link) - AI agent が「issue の命名規則 / template が分からない」 と困った時 ## Linear data model ```text Workspace (組織) └── Team (Engineering, Design, ...) └── Project (機能・ユーザーストーリー単位、 Why/What 容器) ← linear-project-workflow └── Issue (作業単位、 1 PEV task に相当) ← この skill ``` PEV 対応: | Linear Layer | PEV 要素 | 担当 skill | |---|---|---| | Workspace | 認証スコープ (`.linear-config.yml` の `workspace`) | (config) | | Team | 規約レイヤー、 status name 解決元 | (config) | | Project | PEV の Goal + Why + 上位 AC | `linear-project-workflow` | | **Issue** | **PEV の 1 task (細粒度 AC + 作業ステップ)** | **`linear-issue-workflow`** (この skill) | ## 命名規則 (title) Issue title は **具体的な作業内容を動詞で表現する** (= How、 「どうする」)。 project title が「Who wants What, Why」 (= 目的) なのに対し、 issue は「**何をする / どうする**」 を端的に書く。 良い例: - 「validateEmail を RFC 5322 サブセット準拠に拡張する」 - 「ステージング deploy button に確認 dialog を追加する」 - 「重複申込の検出ロジックを `cancelSubmission