情況報告
情況報告是給不在現場的人看的。 為他們寫。
情況報告不是活動日記。它是壓縮、可採取行動的現狀快照。三個問題：完成什麼、卡住什麼、下一步做什麼。任何不能回答這三個問題的內容都不該出現在情況報告中。
使用時機
- 從工作日誌、提交記錄或工單狀態整合每日站立會議
- 為利害關係人提供衝刺總結
- 事件期間或之後的現狀報告
- 切換上下文或將工作交接給其他代理或人員時的交接摘要
- 當利害關係人問「我們目前進度如何？」而誠實的回答是「有點複雜」時
程序
-
收集當前工作狀態 — 從可用來源讀取：
- 開啟與近期關閉的議題 / 工單
- 近期提交（站立會議用過去 24-48 小時；衝刺總結用上一個衝刺）
- 專案狀態與路線圖文件（例如
docs/operating-model/PROJECT-OPERATING-PROFILE.md、docs/ROADMAP.md，或依專案結構的等效文件） - 任何阻礙標記、風險登記條目或升級通知
-
將項目分類 至三個桶：
- 完成 — 已完成且可驗證關閉（測試通過、工單關閉、已部署）
- 受阻 — 因特定未解決依賴而無法進展的工作（精確指出阻礙者）
- 下一步 — 將優先處理的最高優先級項目（按優先順序排列）
-
撰寫情況報告 — 結構：
## 情況報告 — <日期> [<範圍：衝刺 / 事件 / 交接>] **完成** - <項目> — <一句話說明交付內容及其證據> **受阻** - <項目> — 受阻於 <特定依賴 / 負責人 / 已知時程> **下一步** - <項目> — <優先順序，最重要的先列出> **風險 / 標記**（可選 — 僅在有重大影響時） - <風險> — <未解決時的影響> — <負責人> -
應用壓縮測試 — 對每一行：如果刪除它，對讀者需要採取行動沒有影響，就刪除它。
-
精確命名阻礙者 — 「受阻於後端」不是有效的阻礙項目。「受阻於
/v2/orders的 API 合約 — 等待 @負責人，時程未知」才是。 -
不要對進度發表評論 — 「進展良好」是雜訊。「交付了 X，解鎖了 Y」才是訊號。
產出
- 以上格式的狀況報告
- 可選：一段高層摘要，提供給需要更少細節的利害關係人
防護機制
- 不報告活動。「處理了身份驗證模組」不是狀況報告條目。「身份驗證模組：JWT 驗證完成，負載下 Token 刷新失敗 — 調查中」才是。
- 受阻就是受阻。 如果某件事進展緩慢但實際上沒有受阻，它應屬於「下一步」並附上備註，而非「受阻」。
- 完成就是完成。「95% 完成」不是完成。如果它無法驗證為完整，就是「下一步」。
- 長度不代表品質。 一個五行的狀況報告若能回答三個問題，勝過一個二十行但答非所問的報告。