Standup — 每日站立會議報告產生器
把一個人手上的一切收起來,統整成他自己讀得懂的四塊:YDY(昨天做了什麼)、TDT(今天要 做什麼)、BOS(被什麼卡住)、口頭同步。來源是 git、JIRA、行事曆、PR 狀態、他自己講的話。
它收一切。 工作、日常、會議、沒有單號的東西都收,不分是哪一家公司的、也不分是不是 這套工具自己的進度。要不要給別人看某一段,是拿它去報告的那個人的事,不是收集這一步的事。
送到哪由宣告決定。 有宣告就送到那裡,送出前把逐字全文交給人、等一句同意;沒有宣告就 把內容講出來,結束。細節在〈送到哪裡去〉。
Contract
standup 是 daily standup 與 EOD summary 的單一入口。它不自己做排序判斷,也不捏造資料
來源沒有的活動。它可以轉述 PR / JIRA / planning / blocker 現況,但不得自行把這些訊號升格成
workflow authority。這條有兩個方向,兩個都要擋:
- 不得升格成完成宣告——「PR 狀態良好」不等於
mergeable_ready,release page / standup 內容也不等於 release eligibility 或 release completed。 - 不得升格成待辦——狀態名、單上的現況表、一個答不了問題的查詢回空,都不構成「還有什麼
要做」。判準與三個實例在
standup-data-collection-flow.md的〈狀態不是意圖〉,這裡不抄 第二份。
這條原本只寫了第一個方向,而 2026-08-12 的四次校正有兩次是第二個方向。
收集不過濾。 這裡曾經有一段寫著「它不報產生它的那套工具自己的進度」,理由是 2026-08-14 那份對同事講了一整排跟他們無關的號碼與版本。那一段修錯了地方:問題不在 收集,在於全部倒給了同事。收集一切是給這個人自己整理用的;要給誰看哪一段,由拿它去填 某個平台、某個頁面的那一步過濾。
送到哪裡去
這支不認得任何一個特定的地方,它讀一個宣告。 那個宣告住在使用它的人自己的設定裡
(公司的 workspace-config.yaml 或個人設定),不寫死在這份散文裡。四種結果,行為互不
相同,而且每一種都要說出來:
| 讀到什麼 | 怎麼做 |
|---|---|
| 宣告齊全 | 送到那裡。送出前把逐字全文交給人、等一句同意;送出去之後要改,改動的全文再交一次 |
| 宣告在,但缺欄位 | 說出缺哪一欄,不送。內容照常產出 |
| 沒有宣告 | 把內容講出來,結束。不猜、不沿用上一個目的地 |
| 量不到(設定檔讀不到、工具不在) | 說出量不到,不當成「沒有宣告」 |
第二種與第三種不得收斂成同一句「找不到」——半條宣告比沒有宣告糟,它看起來像有人 設定過。
目的地要什麼形狀,由那一步自己去轉,不回頭改這一支的形狀。 一個平台的表單欄位長什麼 樣是那個平台的事;把它抄進這裡,這支就只會產出那個平台的樣子。這件事發生過:2026-06 的 產出是四區塊,2026-08-13 為了對齊某個平台的表單改成一張 epic 三格,於是「每一塊收什麼」 反而沒有人寫——填的人只能照 PR 的機械狀態填。
Reference Loading
| Situation | Load |
|---|---|
| Any run | standup-data-collection-flow.md, workspace-config.yaml |
| TDT / planning | standup-planning-flow.md, standup-template.md, session-timeline.md when useful |
| Formatting | standup-format-flow.md, standup-template.md, scripts/validate-language-policy.sh |
standup-template.md 在兩列都出現,是因為它管兩件事:形狀是排版時要的,而〈怎麼寫:
產出物精簡,證據不精簡〉那五條管的是內容——每一塊的長度與語氣在第 3–6 步就決定了,
等到排版才載它,那五條從來沒有在該生效的時候在手上。
Flow
- 讀 workspace config,取得 JIRA、GitHub、projects、teams。
- 計算
YDY_DATE、PRESENT_DATE、TDT_PLAN_DATE;使用者指定日期時以使用者為準。 - 收集昨日 sources:git commits、JIRA updates(含窗內留言)、分支上的事(被 merge 的 PR、 收到的 review comment、CI 狀態)、Calendar meetings。視窗綁在查詢那一層,不是事後過濾。
- Merge and deduplicate 昨日,並做 plan vs actual comparison——比對來源是
{base_dir}/standups/底下今天以前最新的那一份,而且每次都說出拿哪一份比的。 比的是內容不是號碼,而且空的TDT不算一個計畫——規則在standup-planning-flow.md。 同一張單描述與留言衝突時留言勝出,且把落差說出來。 - 收集今日 candidates:JIRA open sprint、open PR status、review-requested PR, 以及今天要上線的那幾張——那一個來源有自己的問法,見〈今天要上線的,向 tracker 問〉。
- 收集卡關:JIRA discuss status、前幾天持續 blocker、使用者口述。每一項過
standup-planning-flow.md的准入判準——「我現在還有沒有下一步動作可做」加上那張措辭表; 自己動得了的是待辦不是卡關。「等 review」預設不是卡關,判準與三種被退回的形狀寫在 同一份的〈「等 review」預設不是卡關〉那一節。延續過來的那一類還要先問一次它今天的來源, 寫在〈第二個來源要帶今天的根據〉那一節。 兩次 standup 之間才發現的卡關寫回本地那份檔案,見〈兩次 standup 之間發現的卡關,落在哪〉。 - 依
standup-template.md組裝成四塊(YDY/TDT/BOS/口頭同步),分組掛在區塊底下, 呈現給使用者確認,附上〈發現 N 處與現況不符〉。 epic 的 assignee 不是自己時,寫的是自己名下那幾張子單,不寫成整張 epic 由自己 推進——判定與標本在standup-data-collection-flow.md的〈這張 epic 是我的,還是我只有 底下的單〉。 - 使用者確認後,寫 local markdown。那一份不是備份,是本體,也是明天的比對來源。
- 對 local markdown 跑 language gate。
- 讀目的地宣告,照〈送到哪裡去〉那張表走。送出前把那份逐字全文列出來等一句同意; 沒有宣告就列出來,結束。
今天要上線的,向 tracker 問
TDT 的候選裡有一組特別容易整批消失:今天要上線的那幾張。它們通常已經做完、停在某個 等上線的狀態,所以最近沒有人動它、也沒有人在任何地方提起它。
這一組不從昨天那份 standup 推,也不從別人整理的筆記推。 那兩種來源只涵蓋「有人提起過 的那幾張」,而漏掉的方向恆往「事情比較少」倒——輸出看起來完全正常,沒有人會抱怨。 2026-09-10 量到的:當天有 13 筆上線日是當天,照昨天那份推出來的 TDT 只涵蓋 6 筆。
做法是反過來問 tracker,以今天的日期為條件,三個條件:由這個人負責、還沒完成、上線 日期是今天。
assignee = <這個人> AND statusCategory != Done AND <上線日期欄位> in (<今天>)
欄位叫什麼、日期寫成什麼格式,由那個 workspace 的設定說了算,這裡不寫死任何一家的欄位 id 或專案代號。
上線日期若是選項型欄位,用集合比較不要用等號。 等號在那種欄位上會安靜漏列——回來的 清單少了幾筆,跟「今天真的只有這幾筆」長得一模一樣。
問回來的每一張都要進 TDT,只寫它今天上線。 不要在今日格裡寫「上線後拿什麼驗」—— 要驗什麼是上線之後才知道的事,寫進去只是把一份還沒發生的計劃寫成待辦。
問不到就說出來,不要沿用昨天那份。 tracker 打不通、欄位沒宣告,都要說出量不到; 那跟「今天沒有東西要上線」是兩件事。
Data Rules
- Git commits 排除 merge commits。
- Calendar 不猜 Google Meet link;MCP 沒回傳就不列。
- Ticket 連結使用
[KEY title](URL)markdown,不使用平台專屬的 smartlink custom tags。 - Friday standup title 使用 Friday
PRESENT_DATE;TDT的 work target 才是 next Monday。 - Meeting items 不參與 plan vs actual planned/additional/loss 判斷。
Write Rules
- Local markdown 確認後無條件寫入——明天的 plan vs actual 讀它。
- 本地那一份以外,只寫目的地宣告指名的那一個地方。 不代人改任何一張單或 PR。
- 本地檔要通過
scripts/validate-language-policy.sh才算產出完成。 - standup 內對 PR / release / planning 的描述只能轉述來源系統或 shared state;不得在 standup prose 中自行宣告「已完成 / 可 release / 可 merge」。
Completion
輸出 standup date、四塊各有幾項、local file path、那份檔案的逐字全文、目的地讀到的是四種 結果的哪一種、任何 skipped sources 與原因。