docs(sdlc): 參考文件與 README 同步階梯、工作包隔離與日誌粒度

What:`references/branch.md` 新增「分支階梯與 base 推導」一節(只寫拿到 `jsc-git/tools/base-branch.sh --derive` 回應之後要做什麼)與「工作包隔離」一節(歸屬依據、狀態檔欄位、誰寫誰讀、查無歸屬放行、逃生門),閘門分工那一表補上 `claim`、`lock`、`owns`。`references/stage-report.md` 改寫暫存那一節,講明本節只適用於「還沒完成任何任務就停下」的階段。README 的工具表、`implement` 與 `maintain` 兩段說明、參考文件表與相依技能清單同步更新。

Why:階梯表與歸屬狀態檔的正本各有其處——階梯在 `jsc-meta` 的 `references/guidelines.md`,狀態檔格式在 `jsc-hooks`。抄第二份就會有兩份互相打架的規則,但完全不提又會讓實作階段不知道拿到 `7` 或「已建立功能主幹」時該做什麼。

How:兩節都只寫本階段要做的事,並把唯一來源用連結指出去。`branch.md` 的階梯那一節寫成一張「腳本回應 → 這個階段要做的事」對照表,`7` 明寫成「中止並問使用者,不退回 `develop`」。`stage-report.md` 補一句「暫存不等於已寫入」,因為日誌改成一個任務一筆之後,做完事情的階段本來就有日誌可連。

Who:讀 `jsc-sdlc` 參考文件與 README 的人,以及跑實作與維護兩階段的工作階段。
This commit is contained in:
2026-08-27 11:20:30 +08:00
parent 733b1a1a69
commit 77e7504982
3 changed files with 37 additions and 10 deletions
+4 -1
View File
@@ -30,7 +30,10 @@
## 沒寫工作日誌就暫存
階段跑完卻沒有工作日誌,內容只留在對話裡,換一個工作階段就沒了。所以:
每完成一個任務就要寫一筆工作日誌(一個工作包、一輪 PR 留言修正、一個獨立的修正提交各算一個),
所以做完事情的階段收尾時本來就有日誌可連。本節講的是**還沒完成任何任務就停下**的那種階段。
暫存不等於已寫入。內容只留在對話裡,換一個工作階段就沒了,所以:
1. 把這個階段要記的日誌內容寫成一個檔案。
2. 收尾時一起餵進去:`--pending-file {檔案} --log-hash {LOG_{HASH} 的 HASH}`。