---
name: standup
description: |
  "Use when the user wants to generate a daily standup report or end-of-day summary (YDY / TDT / BOS / 口頭同步). Single entry point for all standup and end-of-day workflows. Trigger: 'standup', '站會', 'daily', '寫 standup', '下班', '收工', 'EOD', 'wrap up', '今天做了什麼'."

  要產出每日站會報告或下班摘要。例如「站會」「daily」「下班」「收工」
  「EOD」「今天做了什麼」。

  不用於：一張單走到哪（走 driving-work-to-done）、工時補登（走該公司自己的 worklog skill）。
metadata:
  author: Polaris
  version: 4.0.0
scope: universal
tools:
  - name: jq
    provision: framework
    why: 解析 API 回應的 JSON
    install: mise:aqua:jqlang/jq
---

# 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` 的〈狀態不是意圖〉，這裡不抄
  第二份。

## 送到哪裡去

**這支不認得任何一個特定的地方，它讀一個宣告。** 那個宣告住在使用它的人自己的設定裡
（公司的 `workspace-config.yaml` 或個人設定），不寫死在這份散文裡。四種結果，行為互不
相同，而且每一種都要說出來：

| 讀到什麼 | 怎麼做 |
|---|---|
| 宣告齊全 | 送到那裡。**送出前把逐字全文交給人、等一句同意**；送出去之後要改，改動的全文再交一次 |
| 宣告在，但缺欄位 | 說出缺哪一欄，不送。內容照常產出 |
| 沒有宣告 | 把內容講出來，結束。**不猜、不沿用上一個目的地** |
| 量不到（設定檔讀不到、工具不在） | 說出量不到，不當成「沒有宣告」 |

**第二種與第三種不得收斂成同一句「找不到」**——半條宣告比沒有宣告糟，它看起來像有人
設定過。

### 宣告了一個平台，就交給接手的那一支

有些團隊另外要一個平台（看板、表單），而那個平台的形狀與送出規矩由另一支 skill 帶著。
**那一支是誰，也從宣告讀**：設定裡 `standup.platform` 那一格多寫一行 `handled_by`，值是
那支 skill 的名字。

| 讀到什麼 | 怎麼做 |
|---|---|
| `standup.platform` 有 `handled_by` | 四塊組完、本機檔寫完，就去走那一支，把四塊交給它填平台。**填到送出鍵前面停下**，送出由它自己的規矩決定 |
| 有 `standup.platform`，沒有 `handled_by` | 說出「平台宣告了，但沒說誰接手」，平台那一步不做 |
| 沒有 `standup.platform` | 照舊，四塊與本機檔就是全部 |

**交棒不是可以省略的後續。** 少了這一步，「寫站會」只會留下一份稿，平台那一半要靠派工的
人每天手寫「再走某一支」才補得上——那就是沒有程序。這一支不知道那一支怎麼填、也不該
知道；它只負責把人帶到那一支的門口。

**目的地要什麼形狀，由那一步自己去轉，不回頭改這一支的形狀。** 一個平台的表單欄位長什麼
樣是那個平台的事；把它抄進這裡，這支就只會產出那個平台的樣子。

## 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

1. 讀 workspace config，取得 JIRA、GitHub、projects、teams。
2. 計算 `YDY_DATE`、`PRESENT_DATE`、`TDT_PLAN_DATE`；使用者指定日期時以使用者為準。
3. 收集昨日 sources：git commits、JIRA updates（含窗內留言）、分支上的事（被 merge 的 PR、
   收到的 review comment、CI 狀態）、Calendar meetings。視窗綁在查詢那一層，不是事後過濾。
4. Merge and deduplicate 昨日，並做 plan vs actual comparison——比對來源是
   `{base_dir}/standups/` 底下今天以前最新的那一份，而且**每次都說出拿哪一份比的**。
   **比的是內容不是號碼**，而且空的TDT不算一個計畫——規則在 `standup-planning-flow.md`。
   同一張單描述與留言衝突時留言勝出，且把落差說出來。
5. 收集今日 candidates：JIRA open sprint、open PR status，**以及今天要上線的那幾張**
   ——那一個來源有自己的問法，見〈今天要上線的，向 tracker 問〉。
   **別人請我 review 的 PR 不是候選**（使用者 2026-09-16 拍板：站會要收斂的是自己的工作）。
   我自己的 PR 在等別人看仍然收——那是我的工作，下一步是去請人看，見下面第 6 步那一條。
6. 收集卡關：JIRA discuss status、前幾天持續 blocker、使用者口述。每一項過
   `standup-planning-flow.md` 的准入判準——「我現在還有沒有下一步動作可做」加上那張措辭表；
   自己動得了的是待辦不是卡關。**「等 review」預設不是卡關**，判準與三種被退回的形狀寫在
   同一份的〈「等 review」預設不是卡關〉那一節。**延續過來的那一類還要先問一次它今天的來源**，
   寫在〈第二個來源要帶今天的根據〉那一節。
   兩次 standup 之間才發現的卡關寫回本地那份檔案，見〈兩次 standup 之間發現的卡關，落在哪〉。
7. 依 `standup-template.md` 組裝成四塊（YDY／TDT／BOS／口頭同步），分組掛在區塊底下，
   呈現給使用者確認，附上〈發現 N 處與現況不符〉。
   **epic 的 assignee 不是自己時，寫的是自己名下那幾張子單**，不寫成整張 epic 由自己
   推進——判定與標本在 `standup-data-collection-flow.md` 的〈這張 epic 是我的，還是我只有
   底下的單〉。
8. 寫 local markdown，**不等任何人確認**。那一份不是備份，是本體，也是明天的比對來源；
   它不離開這台機器，所以沒有東西需要人先看過。要等確認的只有第 10 步送到外部的那一步。
9. 對 local markdown 跑 language gate。
10. 讀目的地宣告，照〈送到哪裡去〉那張表走。
11. `standup.platform` 宣告了 `handled_by` 的話，走那一支把四塊填進平台，停在送出前。
    見〈宣告了一個平台，就交給接手的那一支〉。

## 今天要上線的，向 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

- **本地那一份以外，只寫目的地宣告指名的那一個地方。** 不代人改任何一張單或 PR。
- 本地檔要通過 `scripts/validate-language-policy.sh` 才算產出完成。

## Completion

輸出 standup date、四塊各有幾項、local file path、那份檔案的逐字全文、目的地讀到的是四種
結果的哪一種、任何 skipped sources 與原因。