← 返回 Linear 完全指南
Linear 完全指南 · Lesson 2.3

Issue 解剖學

Issue 是 Linear 的最小工作單位。這一課不是只列欄位名稱,而是告訴你每個欄位怎麼寫,才會真的幫助執行。

一張好 issue 應該回答什麼?

常見欄位

  • Title
  • Description
  • Assignee
  • Priority
  • Labels
  • Project / Cycle
  • Estimate
  • State

真正重點

  • 不要只填欄位,要讓下一個接手的人看得懂
  • 標題要具體
  • 描述要有背景與完成標準
  • 狀態要反映現況,不要亂掛

標題(Title)怎麼寫

壞標題通常像:改一下登入修 bug優化首頁。它們的共同問題是太模糊。

比較好的寫法是:修正登入頁在 Safari 無法送出表單首頁 Hero 區塊改為新版價值主張文案

好標題要讓人一眼看出對象、動作、範圍。

描述(Description)怎麼寫

至少要有三件事:

  1. 背景:為什麼有這張票
  2. 需求:具體要做什麼
  3. 驗收:完成後怎樣算 done

如果缺這些,issue 很容易只剩一句口號,最後靠口頭補資訊。

Assignee、Priority、Labels

Issue 在 Project 底下,還是 Cycle 底下?

比較準確的說法是:Issue 是最小工作單位,它可以同時跟 Project 和 Cycle 發生關係

所以同一張 issue 很常同時有這兩個屬性。例如:

意思就是:

所以不要把 project 跟 cycle 想成二選一。對一張 issue 來說,project 管的是目標歸屬,cycle 管的是執行時機

那 Cycle 跟 Project 的關係是什麼?

Project 比較偏長一點,代表一段時間內要完成的目標;Cycle 比較短,代表這 1–2 週團隊打算完成哪一批工作。

它們不是上下層互相包含的單一關係,而是兩個不同維度:

所以 Cycle 不會在某一個 Project 底下,Project 也不是 Cycle 的上層父節點。

比較貼近實際的理解是:

如果硬要形容它們的關係,比較像是多對多,但這個多對多不是 project 直接連 cycle,而是透過 issue 連起來。

所以很常見的情況是:

例如 Onboarding 2026 Q2 這個 project,底下可能有 20 張 issues:

反過來看,Cycle 18 裡也可能同時包含:

所以你可以把它想成:

Project / Cycle / Estimate / Time Estimate / State

這幾個欄位分別回答不同問題:

不要拿單一欄位硬扛所有資訊。像是把 state 當優先序、把 label 當 project,最後都會很亂。

Time Estimate 什麼時候會填?

不是每個團隊都一定會填 time estimate。很多產品團隊只用 Estimate 來放 S / M / L 或 points,並不追求每張票的精準工時。

如果團隊真的需要看比較實際的時間預估,常見會在這幾個時候填:

比較常見的做法是:

一句話記:Estimate 比較像「多大顆」;Time Estimate 比較像「大概要多久」。不是所有團隊都需要兩個都用,但如果兩種資訊都想保留,分開會最清楚。

這一課的收尾

Issue 品質幾乎決定了 Linear 的體驗。工具本身不會自動讓團隊更清楚;是你們有沒有把 issue 寫成真正能執行、能交接、能追蹤的工作單位。