devlog-tracker 0.33.1 → 0.33.2

package/README.md

@@ -2,7 +2,7 @@
 
 *English | [繁體中文](README.zh-TW.md)*
 
-**Version** 0.33.1
+**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.
 

package/README.zh-TW.md

@@ -2,7 +2,7 @@
 
 *[English](README.md) | 繁體中文*
 
-**版本** 0.33.1
+**版本** 0.33.2
 
 在專案中維護一份 `.devlog/devlog.md`，把每一輪對話的請求、決策與結果寫成永久紀錄。對話一 `/clear` 或換 session 就沒了；這份檔案取代那個缺口，讓工作可以中斷再接。沒下過 `/devlog-tracker:start` 時，裝著也不會動任何檔案。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devlog-tracker",
-  "version": "0.33.1",
+  "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`）的輪次

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`。
 
 ## 已知限制：分辨不出「這是自動續接還是真人插話」