devlog-tracker 0.33.0 → 0.33.2

package/README.md

@@ -2,7 +2,7 @@
 
 *English | [繁體中文](README.zh-TW.md)*
 
-**Version** 0.33.0
+**Version** 0.33.2
 
 Maintains a `.devlog/devlog.md` in your project, turning each conversation round's requests, decisions, and outcomes into a permanent record. A conversation disappears the moment you `/clear` or switch sessions; this file fills that gap so work can pause and resume. Nothing is touched until you explicitly run `/devlog-tracker:start` — installing the plugin alone doesn't create or modify any files.
 
@@ -116,7 +116,7 @@ The table below uses the plugin's `/devlog-tracker:*` namespace; `npx init --cla
 | `/devlog-tracker:pause` | Pauses enforced recording; history files are untouched, and you can `start` again later. |
 | `/devlog-tracker:compact` | A script moves older `DONE` rounds into `devlog.archive.md` (Checkpoints and unfinished rounds stay in the main file). |
 | `/devlog-tracker:keep` | Scans the current branch's main file (to reorganize every devlog at once, use `keep-all`), groups it by topic, lists suggestions at once, then — after confirmation — moves each section out into its own `devlog.<name>.md` (leaving a `## Kept index` pointer line with a one-sentence topic description in the main file); can also extract a single section or merge everything into one history file. Not the same as compact. See [`docs/design/keep.md`](docs/design/keep.md). |
-| `/devlog-tracker:keep-all` | Reorganizes **every** devlog, not just the current branch's: the current main file, every other branch's `devlog.<branch>.md`, `devlog.archive.md`, and all files earlier `keep`/`keep-all` runs produced. Claude regroups their Rounds by topic across files (one topic spread over main, a feature branch and the archive ends up in one file), lists every proposed file at once, and after confirmation one script run writes them all or nothing. Existing kept files are broken up and rebuilt; each branch's unfinished tail (Rounds after its last `DONE`) and the open Round never move; branch files are never deleted. Every touched file is backed up to `.devlog/.keep-all-backup/<timestamp>/` first. Needs Node ≥18. See [`docs/design/keep-all.md`](docs/design/keep-all.md). |
+| `/devlog-tracker:keep-all` | Reorganizes **every** devlog, not just the current branch's: the current main file, every other branch's `devlog.<branch>.md`, `devlog.archive.md`, and all files earlier `keep`/`keep-all` runs produced. Claude regroups their Rounds by topic across files (one topic spread over main, a feature branch and the archive ends up in one file), lists every proposed file at once, and after confirmation one script run writes them all or nothing. Existing kept files are broken up and rebuilt; each branch's unfinished tail (Rounds after its last `DONE`) and the open Round never move; a branch file left empty is deleted (except for a still-active branch, the current file and `devlog.md`). Every touched file is backed up to `.devlog/.keep-all-backup/<timestamp>/` first. Needs Node ≥18. See [`docs/design/keep-all.md`](docs/design/keep-all.md). |
 | `/devlog-tracker:overview` | Reads all kept `devlog.<name>.md` files and merges them into a cross-topic overview, plus a list of candidate rules that look like they belong in `CLAUDE.md`. Read-only — no workspace check, no confirmation, no writes. See the Kept index section of [`docs/design/keep.md`](docs/design/keep.md). |
 | `/devlog-tracker:promote` | Picks rule candidates from kept files, lessons files and Checkpoint `### 決策` sections, lists them numbered, and — only for the ones you choose — appends them to a managed `<!-- devlog-tracker:rules:begin/end -->` block in `CLAUDE.md` (or `AGENTS.md` when `CLAUDE.md` is just `@AGENTS.md`, or on Codex-only projects). Append-only, exact duplicates skipped; `init` never rewrites this block. |
 | `/devlog-tracker:search <keyword>` | Case-insensitive string search across `devlog.md`/`devlog.archive.md`/kept `devlog.<name>.md`/`devlog.lessons.<topic>.md`; Claude answers in its own words from the hits (with file/heading/line as evidence). Read-only — no workspace check, no confirmation, no writes. |

package/README.zh-TW.md

@@ -2,7 +2,7 @@
 
 *[English](README.md) | 繁體中文*
 
-**版本** 0.33.0
+**版本** 0.33.2
 
 在專案中維護一份 `.devlog/devlog.md`，把每一輪對話的請求、決策與結果寫成永久紀錄。對話一 `/clear` 或換 session 就沒了；這份檔案取代那個缺口，讓工作可以中斷再接。沒下過 `/devlog-tracker:start` 時，裝著也不會動任何檔案。
 
@@ -116,7 +116,7 @@ $devlog-start           # npx init --codex
 | `/devlog-tracker:pause` | 暫停強制記錄，歷史檔不動，之後可再 `start`。 |
 | `/devlog-tracker:compact` | 腳本把較舊的 `DONE` 輪次搬到 `devlog.archive.md`（Checkpoint 與未完成輪留在主檔）。 |
 | `/devlog-tracker:keep` | 掃目前分支的主檔分主題（要一次整理所有 devlog 用 `keep-all`），一次列出建議，確認後把各段各自搬走成 `devlog.<name>.md`（並在主檔留一個 `## Kept 索引` 指標行，含一句主題描述）；也可抽出一段或合併成全部歷史一檔。不是 compact。細節見 [`docs/design/keep.md`](docs/design/keep.md)。 |
-| `/devlog-tracker:keep-all` | 整理**所有** devlog，不只目前分支：目前的主檔、其他分支的 `devlog.<branch>.md`、`devlog.archive.md`，以及先前 `keep`／`keep-all` 產生的所有具名檔。Claude 跨檔依主題重新分段（同一個主題散在 main、feature 分支與 archive 的片段會合回同一檔），一次列出所有建議檔案，確認後由一支腳本整批寫入，全有或全無。既有的具名檔會被拆開重組；各分支未完成的尾巴（最後一個 `DONE` 之後的 Round）與開著的那一輪不會被搬，分支檔也不會被刪。動手前會先把所有會動到的檔備份到 `.devlog/.keep-all-backup/<時間戳>/`。需要 Node ≥18。細節見 [`docs/design/keep-all.md`](docs/design/keep-all.md)。 |
+| `/devlog-tracker:keep-all` | 整理**所有** devlog，不只目前分支：目前的主檔、其他分支的 `devlog.<branch>.md`、`devlog.archive.md`，以及先前 `keep`／`keep-all` 產生的所有具名檔。Claude 跨檔依主題重新分段（同一個主題散在 main、feature 分支與 archive 的片段會合回同一檔），一次列出所有建議檔案，確認後由一支腳本整批寫入，全有或全無。既有的具名檔會被拆開重組；各分支未完成的尾巴（最後一個 `DONE` 之後的 Round）與開著的那一輪不會被搬，搬空的分支檔會被刪除（仍在開發的分支、目前主檔與 `devlog.md` 除外）。動手前會先把所有會動到的檔備份到 `.devlog/.keep-all-backup/<時間戳>/`。需要 Node ≥18。細節見 [`docs/design/keep-all.md`](docs/design/keep-all.md)。 |
 | `/devlog-tracker:overview` | 讀完所有已 keep 的 `devlog.<name>.md`，整合成跨主題總覽，並列出看起來該進 `CLAUDE.md` 的規範候選。純讀取，不核對工作區、不等確認、不寫檔。細節見 [`docs/design/keep.md`](docs/design/keep.md) Kept index。 |
 | `/devlog-tracker:promote` | 從已 keep 的檔、lessons 檔與 Checkpoint 的 `### 決策` 挑出規範候選並編號列出；只有你選定的才追加到 `CLAUDE.md`（`CLAUDE.md` 只有 `@AGENTS.md` 或只裝 Codex 時改寫 `AGENTS.md`）的 `<!-- devlog-tracker:rules:begin/end -->` 受管區塊。只追加、一字不差的重複會跳過；`init` 不會覆寫這個區塊。 |
 | `/devlog-tracker:search <關鍵字>` | 在 `devlog.md`／`devlog.archive.md`／已 keep 的 `devlog.<name>.md`／`devlog.lessons.<topic>.md` 裡做不分大小寫的字串搜尋；Claude 讀完命中後用自己的話回答（必要時附檔名／標題／行號）。純讀取，不核對工作區、不等確認、不寫檔。 |

package/commands/keep-all.md

@@ -45,6 +45,7 @@ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑>" bash "${PLUGIN_ROOT}/core/scr
      <來源檔> Round <編號…>（#<id…>）、<來源檔> Round <編號…>（#<id…>，分支 <origin> <state>）
   2. ...
 會被重整並刪除的既有 keep 檔：<檔名，逗號分隔，或「無」>
+會被搬空並刪除的分支檔：<檔名，逗號分隔，或「無」>
 可搬但偏瑣碎、留在原檔：<來源檔與 Round，或「無」>
 不能搬、保持原樣：<各分支未完成尾巴與開著的 Round，或「無」>
 
@@ -57,6 +58,8 @@ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑>" bash "${PLUGIN_ROOT}/core/scr
 
 同一則回覆可以合併多條修改；`N` 一律對應原始編號。使用者用文字要求把某些 Round 換段，照做後重新列一次再等。然後停止，使用者回覆前不要寫任何檔。
 
+「會被搬空並刪除的分支檔」＝所有 Round 都分進某段、`state` 不是 `active`、且不是 `devlog.md` 的 `kind=branch` 來源（腳本會照這個規則刪）。
+
 - 取消 → 不改檔，結束。
 - `移除第 N 段`：該段若含 `kind=kept` 的 Round，拒絕並說明只能 `併入`；其餘 Round 留在原檔。
 - `第 N 段併入第 M 段`：合併 id，沿用第 M 段的檔名與描述。
@@ -77,7 +80,7 @@ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑>" bash "${PLUGIN_ROOT}/core/scr
   --apply "<專案根目錄絕對路徑>/.devlog/.keep-all-plan.tsv" --fingerprint <fp> --count <n>
 ```
 
-`<fp>`／`<n>` 用步驟 1 的值。不要自己搬檔、刪檔或改索引——腳本是唯一的實作：驗證計畫、把所有會動到的檔備份到 `.devlog/.keep-all-backup/<時間戳>/`、組好新檔、改寫來源、刪除被整理掉的 kept 檔與清空的 archive、重建 `## Kept 索引`（新索引行寫在目前分支的主檔）。分支檔與目前主檔即使搬空也不會被刪。
+`<fp>`／`<n>` 用步驟 1 的值。不要自己搬檔、刪檔或改索引——腳本是唯一的實作：驗證計畫、把所有會動到的檔備份到 `.devlog/.keep-all-backup/<時間戳>/`、組好新檔、改寫來源、刪除被整理掉的 kept 檔、清空的 archive 與搬空的分支檔、重建 `## Kept 索引`（新索引行寫在目前分支的主檔）。搬空的分支檔只在該分支不是 `active` 時才刪；目前主檔與 `devlog.md` 一律不刪。
 
 - exit 1：原樣顯示 stderr，不要自行重試或手動補做。驗證錯誤時不會寫任何檔；fingerprint 不符代表掃描後檔案被改過，回到步驟 1 重新掃描。
 - 成功後刪除 `.devlog/.keep-all-plan.tsv`。

package/core/scripts/keep-all.js

@@ -267,6 +267,7 @@ function apply(c, planText, expected, count) {
   const prefixes = new Map(segs.map(seg => [seg, []]));
   const rewritten = new Map(); // file -> new text | null (delete)
   const movedFromCurrent = new Set();
+  const touchedFiles = new Set();
 
   for (const src of s.sources) {
     const { lines, blocks, firstBlock } = src.parsed;
@@ -310,6 +311,7 @@ function apply(c, planText, expected, count) {
       continue;
     }
     if (!touched) continue;
+    touchedFiles.add(src.file);
     const text = joinPieces([lines.slice(0, firstBlock), ...stay]);
     const left = stay.length && parseBlocks(text).blocks.some(b => b.round !== null);
     rewritten.set(src.file, src.kind === 'archive' && !left && trimBlank(lines.slice(0, firstBlock)).length === 0 ? null : text);
@@ -331,6 +333,15 @@ function apply(c, planText, expected, count) {
     const updated = rewriteIndex(base, staleIndex, src.kind === 'current' ? newIndex : []);
     if (updated !== base) rewritten.set(src.file, updated);
   }
+  // A branch file keep-all emptied (only its origin marker left) is
+  // deleted, unless the branch is still active: checking it out again
+  // would migrate main's unfinished tail into a fresh file.
+  for (const src of s.sources) {
+    const t = rewritten.get(src.file);
+    if (src.kind !== 'branch' || src.file === 'devlog.md' || src.state === 'active' || typeof t !== 'string') continue;
+    if (!touchedFiles.has(src.file)) continue;
+    if (t.split('\n').every(l => l.trim() === '' || ORIGIN.test(l))) rewritten.set(src.file, null);
+  }
   if (!s.sources.some(x => x.kind === 'current')) {
     const head = c.origin ? `<!-- devlog-origin: ${c.origin} -->\n` : '';
     rewritten.set(c.current, rewriteIndex(head, staleIndex, newIndex));

package/core/scripts/keep-all.test.js

@@ -135,6 +135,26 @@ test('apply moves a cross-file topic into one file in time order and consumes ke
   assert.ok(fs.existsSync(path.join(backup, 'devlog.md')));
 });
 
+test('apply deletes a branch file it emptied, but not an active branch or devlog.md', () => {
+  const d = setup({
+    'devlog.feat-main.md': '<!-- devlog-origin: branch=feat/main -->\n\n' + round(1, '2026-09-05T10:00:00+0800', 'IN_PROGRESS'),
+    'devlog.md': '# proj\n\n' + round(1, '2026-09-01T10:00:00+0800', 'DONE'),
+    'devlog.old.md': '<!-- devlog-origin: branch=old -->\n\n' + round(1, '2026-09-02T10:00:00+0800', 'DONE'),
+    'devlog.keep-me.md': '<!-- devlog-origin: branch=keep-me -->\n\n' + round(1, '2026-09-03T10:00:00+0800', 'DONE') +
+      '\n' + round(2, '2026-09-03T11:00:00+0800', 'DONE'),
+  });
+  const c = ctx(d, { current: 'devlog.feat-main.md', open: '1' });
+  const s = scan(c);
+  const ids = [...idsOf(s, 'devlog.md', [1]), ...idsOf(s, 'devlog.old.md', [1]), ...idsOf(s, 'devlog.keep-me.md', [1])];
+  const out = apply(c, `alpha\t\t${ids.join(',')}\n`, s.fingerprint, s.rounds.length);
+  assert.ok(!exists(d, 'devlog.old.md'), 'emptied branch file deleted');
+  assert.match(out, /^DELETED=.*devlog\.old\.md$/m);
+  assert.ok(exists(d, 'devlog.keep-me.md'), 'branch file with rounds left stays');
+  assert.ok(exists(d, 'devlog.md'), 'devlog.md is never deleted');
+  const backup = out.match(/^BACKUP=(.*)$/m)[1];
+  assert.ok(fs.existsSync(path.join(backup, 'devlog.old.md')), 'deleted branch file is backed up');
+});
+
 test('apply may reuse the name of a kept file it consumes', () => {
   const d = world();
   const c = ctx(d);

package/core/scripts/tests/test-keep-all.sh

@@ -44,7 +44,7 @@ APPLY="$(bash "$SCRIPT_DIR/keep-all.sh" --apply "$TMP/plan.tsv" --fingerprint "$
 if [ $? -eq 0 ]; then echo "PASS: apply exits 0"; else echo "FAIL: apply exits 0"; FAIL=1; fi
 [ -f "$R/.devlog/devlog.old-branches.md" ] && grep -q "^KEPT=.*devlog.old-branches.md ROUNDS=2" <<<"$APPLY" \
   && echo "PASS: named file written" || { echo "FAIL: named file written"; FAIL=1; }
-check "branch files keep their marker and are not deleted" '[ "$(head -n 1 "$R/.devlog/devlog.feat-merged.md")" = "<!-- devlog-origin: branch=feat/merged -->" ]'
+check "emptied merged/gone branch files deleted" '[ ! -e "$R/.devlog/devlog.feat-merged.md" ] && [ ! -e "$R/.devlog/devlog.feat-deleted.md" ] && grep -q "^DELETED=.*devlog.feat-merged.md" <<<"$APPLY"'
 check "index written to the current branch file" 'grep -q "devlog.old-branches.md\`：keep-all，2 輪" "$R/.devlog/devlog.feat-live.md"'
 check "lock released" '[ ! -e "$R/.devlog/.lock" ] && [ ! -d "$R/.devlog/.lock.d" ]'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devlog-tracker",
-  "version": "0.33.0",
+  "version": "0.33.2",
   "description": "npx installer for devlog-tracker's Claude Code, Cursor and Codex adapters.",
   "bin": {
     "devlog-tracker": "bin/devlog-tracker.js"

package/skills/devlog-tracker/SKILL.md

@@ -139,14 +139,6 @@ Claude Code 目前沒有正式、穩定的方式讓 hook 知道「這一輪有
   算不出來）都明確接住、失敗就直接放行。這些腳本的職責是「檢查」，不該因為自己的臭蟲
   就意外把使用者的 session 卡死。
 
-更新（Span Mode 之後）：agentflow 的 Stop hook 會依「這一輪是不是還在進行中」
-放寬檢查強度，這裡原本認為 Claude Code 原生的「一個使用者訊息 = 一輪」架構沒有
-對應的地方可以搬這個設計過來。後來為了支援 `/loop`／`Workflow` 這類會被自動
-排程反覆喚醒的長任務，加了上面的 Span Mode，算是這個設計的一個窄化版本——只在
-Claude 主動宣告「接下來會有一串自動續接」時才放寬，且用 tick 計數做安全閥，
-不是像 agentflow 那樣泛用地判斷「這輪是否還在進行中」。一般互動式對話仍然是
-完整的「一個訊息 = 一輪」強制模式，沒有變。
-
 ## 自動接續與 `/clear`
 
 這個 plugin 內建一個 SessionStart hook（`claude/hooks.json` + `core/scripts/session-start-devlog.sh`），
@@ -408,7 +400,7 @@ hook 會要求補一段。
 
 ## 壓縮歸檔：`/devlog-tracker:compact`
 
-歸檔不再是自動觸發，而是使用者主動下 `/devlog-tracker:compact` 指令時才做（見 `commands/compact.md`）。
+歸檔只在使用者下 `/devlog-tracker:compact` 時做，不會自動觸發（見 `commands/compact.md`）。
 規則：
 
 - 保留：專案摘要（如果有）、最近 5 輪、所有還沒 `DONE`（`IN_PROGRESS`/`BLOCKED`/`INTERRUPTED`）的輪次
@@ -432,7 +424,7 @@ keep 只整理目前分支的主檔；keep-all 一次整理 `.devlog/` 裡**所
 主檔、其他分支的 `devlog.<branch>.md`、`devlog.archive.md`，以及既有的具名檔。Round 依時間
 拿到全域編號，Claude 跨檔依主題重新分段、一次列出建議，確認後 `core/scripts/keep-all.sh`
 整批執行（全有或全無，先備份到 `.devlog/.keep-all-backup/`）。既有 kept 檔的 Round 必須全部
-重新分配；各分支最後一個 `DONE` 之後的未完成尾巴與開著的那一輪不搬；分支檔搬空也不刪。
+重新分配；各分支最後一個 `DONE` 之後的未完成尾巴與開著的那一輪不搬；搬空的分支檔（分支非 `active`）會刪除，目前主檔與 `devlog.md` 不刪。
 新索引行寫進目前分支主檔的 `## Kept 索引`。需要 Node。步驟見 `commands/keep-all.md`。不要自動觸發。
 
 ## 接續具名保存：`/devlog-tracker:resume <name>`

package/skills/devlog-tracker/references/lessons-mode.md

@@ -24,7 +24,7 @@
 **寫法**：跑（`PLUGIN_ROOT` 同其他指令）：
 
 ```bash
-DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/lessons-append.sh" \
+DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd)>" bash "${PLUGIN_ROOT}/core/scripts/lessons-append.sh" \
   --topic "<主題 kebab-case slug，跟 keep 的 <name> 同一套正規化規則>" \
   --text "<自由散文，一段就好：卡在哪、怎麼解開、下次怎麼避免>"
 ```

package/skills/devlog-tracker/references/reply-fold.md

@@ -52,7 +52,7 @@
 3. 用 Bash 執行：
 
 ```bash
-DEVLOG_PROJECT_DIR="$(pwd)" bash "${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT}}/core/scripts/await-open.sh"
+DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd)>" bash "${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT}}/core/scripts/await-open.sh"
 ```
 
 這會寫入 `.devlog/.awaiting-reply`，記住「下一則訊息大概是在回答這個

package/skills/devlog-tracker/references/round-segments.md

@@ -23,11 +23,19 @@
 ### Summary
 把 XXX 模組拆成 A/B 兩個檔案，測試全過。
 
+### Reply
+告訴使用者拆分完成、測試全過，還沒 commit。
+
 ### Handoff
 #### 決策
 拆成 A/B，理由是三處耦合都集中在同一個檔。
 #### 檔案
-新增 a.ts、b.ts；刪除 xxx.ts。尚未 commit。
+尚未 commit：
+新增：a.ts, b.ts
+刪除：xxx.ts
+#### 工作區
+main @ a1b2c3d
+未提交：xxx.ts, a.ts, b.ts
 #### 現況
 拆分完成，測試全過。
 
@@ -35,7 +43,7 @@
 DONE
 `````
 
-這個範例是 DONE 且沒有後續，所以沒有 `#### 工作區` 與 `#### 下一步`；這兩節只有 IN_PROGRESS／BLOCKED 才寫。
+這個範例是 DONE 且沒有後續，所以沒有 `#### 完成條件` 與 `#### 下一步`；「檔案」有內容，所以 `#### 工作區` 仍要寫（Stop 會核對）。
 
 **什麼時候該寫一個段落**：跟判斷 `Status: IN_PROGRESS` 用的同一套標準——「有意義的
 階段性結果」，不是照時間或工具呼叫次數機械觸發。短的、沒什麼階段可言的一輪，
@@ -52,4 +60,4 @@ dynamic workflow／subagent 的 PreToolUse 若帶非空 `agent_id`，此閥門
 `/devlog-tracker:segment-watch <時間長度>`（例如 `/devlog-tracker:segment-watch 5 分鐘`）
 調整，不用手改 `.devlog/.segment-state` 的 `max_silent_seconds`。
 
-收尾時 Stop hook 仍會要求最後一個 Round 上看得到 `### Summary` 與 `### Handoff`。
+收尾時 Stop hook 仍會要求最後一個 Round 上看得到 `### Summary`、`### Reply` 與 `### Handoff`。

package/skills/devlog-tracker/references/span-mode.md

@@ -41,14 +41,14 @@
 devlog.md 完全不用動。一旦累積到門檻，Stop hook 會退回正常模式，**這一輪就
 會被要求寫東西才能結束**——看到這種擋下來的訊息，代表這個 span 的「安靜額度」
 用完了，寫點輕量的進度（不用完整 Round，一行都可以）就能讓它繼續運作。
-前提是最後一個 Round 裡已經有 `### Summary` 與 `### Handoff`——一行是追加到那個 Round，不是新開一個缺標題的 Round。若這輪是新開的 Round，兩個標題都要有。
+前提是最後一個 Round 裡已經有 `### Summary`、`### Reply` 與 `### Handoff`——一行是追加到那個 Round，不是新開一個缺標題的 Round。若這輪是新開的 Round，三個標題都要有。
 
 ## 怎麼關掉一個 span
 
 整個 Ask 真的做完時：**開一個新的 Round**（不要回頭改寫當初開 span 那個
-Round），User Input 可以寫「（自動續接收尾，接續 Round 12）」；Summary 用 2–4 句
-給人看這段自動化的結論；Handoff 依小節總結整段期間做了什麼（決策／檔案／工作區／現況／
-下一步；`DONE` 省略工作區與下一步）；Status 正常寫 `DONE`／`IN_PROGRESS`／`BLOCKED`；然後刪掉 `.devlog/.span-open`。
+Round），User Input 可以寫「（自動續接收尾，接續 Round 12）」，其餘照 SKILL.md
+「每一輪的紀錄格式」完整收尾（Summary／Reply／Handoff／Status，Handoff 小節的
+必寫與省略規則相同），內容總結整段 span 做了什麼；然後刪掉 `.devlog/.span-open`。
 
 ## 已知限制：分辨不出「這是自動續接還是真人插話」