log 0.0.9 發佈:工作日誌待寫入暫存 #13

Merged
admin merged 6 commits from develop into master 2026-08-26 01:33:45 +00:00
Member

摘要

  • 需求描述:把 develop 上累積的 jsc-log 變更發佈到 master——工作日誌支援待寫入暫存,以及前一輪稽核修正。
  • 計畫名稱:無
  • 計畫頁:無
  • 分析頁:無

變更內容

檔案 為什麼改
tools/worklog-pending.sh 新工具:待寫入日誌的暫存區,add/list/cat/clear 四個用法
skills/worklog/SKILL.md 寫入前先併入暫存內容,寫成功後才清除
README.md、三份 manifest 文件與版本同步,版本 0.0.9
前一輪稽核(#11) 補齊稽核缺失、修掉護欄失效、文件與參考資料同步

設計重點

  • 暫存放在 $JSC_HOME/worklog-pending/{HASH}/,檔名帶 UTC 時間與 pid,同一秒的兩個工作階段不會互相覆蓋。
  • 清除排在 wiki 寫入成功之後。先清再寫,寫失敗就兩邊都沒有。
  • 沒有暫存不算錯誤:cat 與 list exit 3,呼叫端照常寫自己這次的日誌。

測試結果

  • 合併進 develop 前的驗證:sh -n 通過;add/list/clear 實跑正確,清除後不留殘檔;由 jsc-sdlc/tools/stage-report.sh 觸發的 add 路徑正確印在階段回報裡;ste100-lint.sh log 通過。
  • 本次發佈範圍與 develop 完全相同,沒有額外變更。

前置 Push Request

  • 無
## 摘要 - 需求描述:把 develop 上累積的 jsc-log 變更發佈到 master——工作日誌支援待寫入暫存,以及前一輪稽核修正。 - 計畫名稱:無 - 計畫頁:無 - 分析頁:無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/worklog-pending.sh` | 新工具:待寫入日誌的暫存區,add/list/cat/clear 四個用法 | | `skills/worklog/SKILL.md` | 寫入前先併入暫存內容,寫成功後才清除 | | `README.md`、三份 manifest | 文件與版本同步,版本 0.0.9 | | 前一輪稽核(#11) | 補齊稽核缺失、修掉護欄失效、文件與參考資料同步 | ## 設計重點 - 暫存放在 `$JSC_HOME/worklog-pending/{HASH}/`,檔名帶 UTC 時間與 pid,同一秒的兩個工作階段不會互相覆蓋。 - 清除排在 wiki 寫入成功之後。先清再寫,寫失敗就兩邊都沒有。 - 沒有暫存不算錯誤:`cat` 與 `list` exit 3,呼叫端照常寫自己這次的日誌。 ## 測試結果 - 合併進 develop 前的驗證:`sh -n` 通過;`add`/`list`/`clear` 實跑正確,清除後不留殘檔;由 `jsc-sdlc/tools/stage-report.sh` 觸發的 `add` 路徑正確印在階段回報裡;`ste100-lint.sh log` 通過。 - 本次發佈範圍與 develop 完全相同,沒有額外變更。 ## 前置 Push Request - 無
jiantw83 added 6 commits 2026-08-26 01:32:58 +00:00
What:依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why:稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項;退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How:逐項對照 references/guidelines.md 的審核檢查清單修正,新增的工具都有
documented exit codes,並以真實執行驗證每條路徑。

Who:jsc-meta:skill-check 例行稽核(2026-08-25)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
What:更新 README、AGENTS.md、templates 與 references,讓文件敘述與實際行為一致。

Why:稽核發現多處文件與程式行為分歧,違反「每個意義只有單一真實來源」。

How:以實際程式行為為準改寫敘述,重複的規則收成單一來源並以一行指引指過去。

Who:jsc-meta:skill-check 例行稽核(2026-08-25)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
What:三份 plugin manifest 版本同步 bump,兩份 marketplace 檔與 plugins/meta 正本對齊。

Why:準則要求技能異動必須同步升版;marketplace 副本必須與正本完全一致。

How:以 jsc-meta 的 tools/sync-skill-manifest.sh 升版,marketplace 檔由正本複製。

Who:jsc-meta:skill-check 例行稽核(2026-08-25)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Reviewed-on: #11
What:新增 tools/worklog-pending.sh,worklog 技能改成寫入前先併入暫存內容、寫成功後才清除。

Why:SDLC 階段跑完沒寫工作日誌時,內容如果只留在對話裡,換一個工作階段就補不回來了。

How:暫存放在 $JSC_HOME/worklog-pending/{HASH}/,檔名帶 UTC 時間與 pid,同一秒的兩個工作階段不會互相覆蓋。jsc-sdlc 的階段回報負責存入,worklog 負責併入與清除;清除排在 wiki 寫入成功之後,先清再寫會兩邊都沒有。

Who:用 jsc-sdlc 跑階段、事後要靠工作日誌回頭查的人。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Reviewed-on: #12
jiantw83 added a new dependency 2026-08-26 01:33:21 +00:00
admin approved these changes 2026-08-26 01:33:42 +00:00
admin merged commit 76bddf1630 into master 2026-08-26 01:33:45 +00:00
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Reference: plugins/log#13