plugins/log
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
76 Commits 5 Branches 0 Tags
4c7b63d43a67529676590356d3e72df801f5790b
Commit Graph
15 Commits
Author SHA1 Message Date
jiantw83 fbfe424c39 feat(worklog): 日誌目錄頁改成一個日誌頁一個大標題區塊 
日誌目錄頁的版面從 markdown 表格換成「大標題加條列」：一個日誌頁一個大標題
區塊，標題就是那個日誌頁的實際頁名，週五日期、條目數這些欄位改成標題底下的
一層條列。範本與 worklog 技能的寫入敘述、完成條件、退出碼說明一起跟上。

表格的欄位組合是整頁共用的，一頁上卻有很多存取庫各自的紀錄，每一輪只重寫
自己那一列。欄位一增減，舊列的格數與表頭就對不上，而目錄頁不能整頁覆蓋——
覆蓋等於刪掉別人的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只動到自己
那一個區塊。

比對鍵從裸雜湊那一格改成大標題本身，標題寫成日誌頁的實際頁名。頁名只由
存取庫的擁有者與名稱決定，換主機位址、把日誌頁移到別的存取庫，或頁名編碼
有差，都動不到它；含網址的那一條連結照樣留著給人點，但不當鍵——拿它當鍵，
上面任一件事一變，這一輪的文字就跟上一輪不一樣，比不到既有那一筆就走附加，
同一個日誌頁多出第二個區塊，舊區塊從此再也更新不到。欄號那個參數只在舊
表格頁轉檔時用得到，頁面已經是條列就完全忽略它。

範圍是工作日誌的目錄頁與 worklog 技能。
 2026-09-02 17:22:33 +08:00
jiantw83 aeb3f467e2 feat(狀態回報): 收尾寫一筆 skill-end 事件 
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
 2026-09-02 16:01:15 +08:00
jiantw83 e762cf986e fix(工作日誌暫存): 收編舊名目錄，並掃出定址不到的孤兒 
雜湊規則從 8 碼改成完整 40 碼那一刻，還沒寫進 wiki 的暫存留在舊名底下。
現行程式拿 40 碼去查，查不到那些目錄，裡面的條目就再也寫不出去。

沒人發現是因為兩種狀態長得一樣：「真的沒有待寫」與「待寫卡在舊名底下」
對呼叫端都是成功。技能於是照常回報完成，日誌卻一筆都沒有。

兩道處置。推得出對映的（舊名等於 H 加新名前 7 碼）由 list、cat、merge
一併收編，clear 與 commit 也連舊目錄一起清——commit 不放行的話，已經寫進
wiki 的暫存清不掉，下一輪會整批重複寫一次。推不出對映的交給新的 orphans
子命令掃出來回報，要有人看到才處理得掉。
 2026-09-02 15:27:03 +08:00
jiantw83 2c085d68ef feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
 2026-09-02 14:27:18 +08:00
jiantw83 aee17e45c7 feat(wiki): 三個目錄頁改走專用存取庫，比對鍵改用裸 HASH 
What：LOG_CONTENTS、LEARN_CONTENTS、REPORT_CONTENTS 改由 wiki-repo CONTENTS
解析並透過 wiki-contents.sh upsert 寫入，內容頁仍各走自己的型別。LOG 與 REPORT
的目錄頁新增一欄裸 HASH 當比對鍵。

Why：比對鍵原本是含網址的儲存格，換主機、換存取庫或 URL 編碼有差就比對不到，
upsert 會走附加分支，同一頁多出第二列而舊列永遠不再更新。REPORT 更脆：存取庫一換，
雜湊與網址同時變，四個期間的列會一次全部重複。

How：worklog-pending.sh 的 valid_hash 放寬成 40 碼、8 碼與 H 加 7 碼三種形狀。
放寬的是長度不是字元集——先剝字元再比長度的順序保留，路徑穿越與換行注入照樣擋下。
年報不得沿用日誌存取庫那條規則收斂到內容頁，目錄頁同住一庫是另一回事。

Who：jsc-log
 2026-09-02 11:02:21 +08:00
jiantw83 7d803245a5 fix(overwrite): 只有頁面真的不存在才建新頁 
- What：worklog、learn、report 三支技能共六處讀取分流改寫，只有結束碼 4 才建新頁；
  結束碼 7 與 8 一律中止，一個字都不寫。三份目錄頁樣板補上寫入語意，明寫禁止整頁覆蓋、
  不得改動別人的列。usage-stats.sh 的參數護欄改成明確回傳結束碼 2。
- Why：原本把「讀失敗」與「頁面不存在」當成同一件事。金鑰失效時讀取回 7，技能卻讀成
  「這頁還沒有」，於是照樣板建一份新頁蓋回去。整份工作日誌會被這一筆條目取代，
  既有教訓會被清成空表，報表則產出一份說「這段期間沒有工作」的假數字。
  這些內容只活在 wiki 上，蓋掉就救不回來，所以這是本輪最要緊的一項。
- How：每一處讀取都先看結束碼再決定動作，並在技能文件裡列成表格：
  0 接在既有內容後面附加，4 才從樣板建頁，5 缺網址就中止，7 金鑰或權限問題就中止，
  8 其他 API 失敗就中止。目錄頁一律先讀整頁再改那一列。
  stats 也補上分流，參數錯誤不再被讀成「零次」。
- Who：worklog、learn、report、stats 四支技能的 wiki 讀寫與統計輸出。
 2026-08-31 11:07:16 +08:00
jiantw83 5e61528ad0 feat(worklog): 每完成一個任務就寫一筆日誌 
What：`worklog` 技能改成一個任務一筆條目，任務有三種——一個工作包、一輪 PR 留言修正、一個獨立的修正提交，並新增「What counts as one task」一表寫明各自何時結束；寫入步驟改走 `merge`、`commit`、`abort` 三段式，十項資訊裡的花費時間、token 用量、任務狀態、執行細節四項改成只算這一個任務。`templates/log-entry.md` 的頁首說明同步改寫。

Why：原本一個階段只寫一筆，同一個工作包跑五輪留言修正也只留下一筆。花費時間與 token 用量被攤成一個總數，看不出哪一輪花掉多少；連「試了卻沒改到檔案」的那一輪也整段消失，而那段時間正是最該被看見的。

How：下一個任務開始前先把這一筆寫完，五輪就是五筆，各自帶自己的花費時間與 token 用量，一律附加到同一頁 `LOG_{HASH}`，既有條目不動。每筆的標題要寫清楚是哪一個任務（工作包代號、第幾輪、或提交標題），五筆並排才讀得下去。花費時間在任務結束的當下讀，token 用量傳同一個 session id，兩個數字才描述同一件事。

Who：`jsc-sdlc:implement` 與 `jsc-sdlc:maintain` 收尾時呼叫日誌的每一個工作階段。
 2026-08-27 11:20:29 +08:00
jiantw83andClaude Opus 5 42ea0a305b feat(log): 工作日誌支援待寫入暫存 
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>
 2026-08-26 09:19:43 +08:00
jiantw83andClaude Opus 5 d4bf31421d fix(log): 補齊稽核缺失並修掉護欄失效 
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>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 fdf6b2b771 fix(wiki 連結): 跨頁型連結改用絕對網址 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:54:19 +08:00
jiantw83 b1a0418211 refactor(worklog): worklog-target.sh 改為接收已算好的 hash 
什麼：tools/worklog-target.sh 不再自行重算 SHA-1，改為直接接收呼叫端算好的 hash 參數；skills/worklog/SKILL.md、README.md 同步更新呼叫方式與工具說明；plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本號由 0.0.3 升至 0.0.4。

為什麼：原本 worklog-target.sh 重複實作了共享的 SHA-1 wiki-hash 演算法，與 jsc-gitea/tools/hash-id 的邏輯重複，違反單一事實來源原則，也和 learn 技能已採用的正確呼叫模式不一致。

如何：移除腳本內建的 sha1sum/shasum 計算與 hash 前綴修正邏輯，改為直接使用傳入的 hash 參數組出 LOG_{HASH}、LOG_CONTENTS；SKILL.md 改為先呼叫 jsc-gitea/tools/hash-id 算出 HASH 再傳給 worklog-target.sh；輸出行為與結果不變。

誰：jsc-meta:skill-check 例行合規稽核（worklog 技能）。
 2026-08-24 14:47:26 +08:00
jiantw83 f81da60d02 fix(worklog): 下放 LOG 目標頁計算並統一 hash 2026-08-21 16:53:17 +00:00
jiantw83andClaude Fable 5 aca938fb05 docs(log): translate SKILL.md into English per guidelines 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:28:18 +08:00
jiantw83andClaude Fable 5 782604005d style(log): 依 STE100 擬人台灣感規則改寫語感 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:16:43 +08:00
jiantw83andClaude Fable 5 de9e342d77 feat(log): 匯入 jsc-log 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00