feat(sdlc): 四階段收尾一律回報 #21

2026-08-26T01:21:09Z

jiantw83 commented

2026-08-26 01:21:09 +00:00

摘要

需求描述：SDLC 每個階段執行完畢都要回報——模型能力標籤（是否通過）、工作日誌連結（導向條目標題；沒寫日誌就警告使用者檢查並暫存，下次寫日誌一併寫入）、所有寫入的 wiki 連結；實作階段再加工作目錄、來源分支（註明是否為遠端）、工作分支（幾個 commit、是否 push）、目標分支（PR 連結）。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/stage-report.sh`	新工具：四階段共用的收尾回報，資料由腳本現查
`references/stage-report.md`	回報規則的單一來源：三項共通、實作多四項、暫存規則、結束碼
`skills/plan/SKILL.md`	加步驟 8 階段回報
`skills/analyze/SKILL.md`	加步驟 12 階段回報
`skills/implement/SKILL.md`	加步驟 14 階段回報，含工作目錄與三條分支
`skills/maintain/SKILL.md`	加步驟 5 階段回報
`README.md`	工具表、技能說明、參考資料表同步
三份 manifest	版本同步升到 0.1.6

設計重點

判定搬到程式層：模型閘門那一列只轉述 sdlc-gate.sh report，技能不自評標籤；commit 數、推送狀態、來源分支在不在遠端，都由腳本現查，不採信模型自己數的數字。
提前停下來也要回報：閘門擋住、沒有可選工作包、來源分支在遠端找不到——這些情況更需要回報。停在半路卻不回報，看起來跟沒跑過一樣。
警告不是阻擋：缺工作日誌或缺 PR 時結束碼是 1，回報照樣印出來。階段的工作已經做完了，擋下去只會讓使用者拿不到回報。
暫存跨工作階段：沒寫日誌時把內容交給 jsc-log/tools/worklog-pending.sh（見 plugins/log 的 PR），下次寫日誌時一併寫入。

測試結果

sh -n tools/stage-report.sh：通過。
規劃階段回報試跑：閘門未上鎖時如預期印出「查不到閘門狀態」並要求重跑 lock。
實作階段回報試跑：工作目錄、來源分支標示「（遠端）」、工作分支的 commit 數與推送狀態、目標分支缺 PR 的警告全部正確；缺工作日誌時內容確實寫進暫存區，路徑有印在回報裡。
ste100-lint.sh sdlc：通過。

前置 Push Request

plugins/log#12（工作日誌暫存工具；本 PR 的階段回報會呼叫它）

## 摘要 - 需求描述：SDLC 每個階段執行完畢都要回報——模型能力標籤（是否通過）、工作日誌連結（導向條目標題；沒寫日誌就警告使用者檢查並暫存，下次寫日誌一併寫入）、所有寫入的 wiki 連結；實作階段再加工作目錄、來源分支（註明是否為遠端）、工作分支（幾個 commit、是否 push）、目標分支（PR 連結）。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/stage-report.sh` | 新工具：四階段共用的收尾回報，資料由腳本現查 | | `references/stage-report.md` | 回報規則的單一來源：三項共通、實作多四項、暫存規則、結束碼 | | `skills/plan/SKILL.md` | 加步驟 8 階段回報 | | `skills/analyze/SKILL.md` | 加步驟 12 階段回報 | | `skills/implement/SKILL.md` | 加步驟 14 階段回報，含工作目錄與三條分支 | | `skills/maintain/SKILL.md` | 加步驟 5 階段回報 | | `README.md` | 工具表、技能說明、參考資料表同步 | | 三份 manifest | 版本同步升到 0.1.6 | ## 設計重點 - **判定搬到程式層**：模型閘門那一列只轉述 `sdlc-gate.sh report`，技能不自評標籤；commit 數、推送狀態、來源分支在不在遠端，都由腳本現查，不採信模型自己數的數字。 - **提前停下來也要回報**：閘門擋住、沒有可選工作包、來源分支在遠端找不到——這些情況更需要回報。停在半路卻不回報，看起來跟沒跑過一樣。 - **警告不是阻擋**：缺工作日誌或缺 PR 時結束碼是 1，回報照樣印出來。階段的工作已經做完了，擋下去只會讓使用者拿不到回報。 - **暫存跨工作階段**：沒寫日誌時把內容交給 `jsc-log/tools/worklog-pending.sh`（見 plugins/log 的 PR），下次寫日誌時一併寫入。 ## 測試結果 - `sh -n tools/stage-report.sh`：通過。 - 規劃階段回報試跑：閘門未上鎖時如預期印出「查不到閘門狀態」並要求重跑 lock。 - 實作階段回報試跑：工作目錄、來源分支標示「（遠端）」、工作分支的 commit 數與推送狀態、目標分支缺 PR 的警告全部正確；缺工作日誌時內容確實寫進暫存區，路徑有印在回報裡。 - `ste100-lint.sh sdlc`：通過。 ## 前置 Push Request - https://gitea.jsc.idv.tw/plugins/log/pulls/12（工作日誌暫存工具；本 PR 的階段回報會呼叫它）

jiantw83 added 1 commit 2026-08-26 01:21:09 +00:00

feat(sdlc): 四階段收尾一律回報 4a4feaf6ef

What：新增 tools/stage-report.sh 與 references/stage-report.md，四支階段技能各加一步收尾回報：模型能力標籤判定、工作日誌連結、所有寫入的 wiki 連結；實作階段再加工作目錄與來源、工作、目標三條分支。

Why：階段跑完該交代什麼是固定的，寫在內文靠模型自己記，少一項看不出來。沒寫工作日誌更是如此——內容只留在對話裡，換一個工作階段就沒了。

How：彙整搬到程式層。頁名換絕對網址、commit 數與推送狀態由 git 現查、來源分支在不在遠端也由腳本判定；模型閘門那一列只轉述 sdlc-gate.sh report，不自評。沒有工作日誌就警告使用者檢查，並把內容交給 jsc-log 的暫存區，下次寫日誌一併寫入。結束碼 1 是警告不是阻擋，提前停下來也要回報。

Who：跑 SDLC 四階段的人，以及接手看紀錄的人。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

jiantw83 added a new dependency 2026-08-26 01:21:14 +00:00

plugins/log#12 - feat(log): 工作日誌支援待寫入暫存

admin approved these changes 2026-08-26 01:28:56 +00:00

admin merged commit 41bcbf0f1c into develop

2026-08-26 01:30:12 +00:00

admin deleted branch feat/stage-report

2026-08-26 01:30:12 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Depends on

#12 feat(log): 工作日誌支援待寫入暫存

plugins/log

Reference: plugins/sdlc#21