 jiantw83
|
18d12bbbe2
|
docs(behaviors): 說明文件與行為清單跟上目錄頁的條列版面
存取庫說明與技能行為清單裡講到目錄頁的段落一律改口：一筆一個大標題區塊、
標題就是內容頁頁名也就是鍵、欄位是標題底下的一層條列，頁上不留表格。
三個目錄頁的範本與三支技能的敘述都換了版面，說明文件卻還寫著「一列」與
「表格」。文件與範本各說一套，照文件手工補紀錄的人會補出一列表格，那一列
在條列頁上讀不成一筆紀錄，而且下一輪工具重寫時也不會被當成既有那一筆換掉。
只改敘述，行為與呼叫參數都不動；欄位語意與寫入語意的正本仍在各自的範本
引言裡，這裡只指向它，不重述細節。
範圍是說明文件與技能行為清單裡的目錄頁敘述。
|
2026-09-02 17:22:33 +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
|
04f28d4505
|
docs(log): 補上工具結束碼宣告與新流程說明
- What：README 的工具表補進彙總腳本，並改寫 worklog 與 report 兩節；
tools/token-usage.sh 的檔頭改寫成完整的結束碼宣告。
- Why：README 還停在舊流程，讀的人會以為報表數字仍由技能自己數，也不知道週五已經有腳本可用。
token-usage.sh 原本只寫「護欄回傳 2」，沒說來源讀不到時印 N/A 也算成功，
接手的人容易把那個情況當成故障，白追一輪。
- How：工具表加一列，寫出彙總腳本的輸出欄位與「無資料不估算」；
worklog 一節寫出四項來源併行取得、週五由腳本算；
report 一節寫出三線併行、彙總改走腳本，以及教訓頁另解自己的 wiki 存取庫。
相依清單補上 jsc-ask 一列，說明它負責問期間與任務狀態。
- Who：整個 log 技能組的說明文件。
|
2026-08-31 11:07:16 +08:00 |
|
|
jiantw83
|
7eb93af733
|
docs(log): README 同步日誌粒度與三段式暫存
What：README 的 `worklog` 技能說明改寫成「每完成一個任務就寫一筆」並列出三種任務，工具表的 `worklog-pending.sh` 一列補上 `merge`、`commit`、`abort` 三個子命令與各自的時機。
Why：粒度與暫存流程都變了，README 是對外說明。說明沒跟上，使用者會照舊以為一個階段寫一筆、清暫存用 `clear`。
How：技能說明拆成兩段，第一段講粒度、第二段講十項資訊與寫入流程；工具表那一列把「寫進 wiki 成功之後才清」這句留著，因為三段式要守的正是這一條。
Who：讀 `jsc-log` 說明的人，以及要接 `worklog-pending.sh` 的 `jsc-sdlc`。
|
2026-08-27 11:20:29 +08:00 |
|
|
jiantw83
|
e6fafd4132
|
feat(report): 新增工作日誌總結技能
What: 新增 jsc-log:report，把工作日誌總結成年報、月報、週報或日報，寫進 wiki REPORT_{HASH}。另加 tools/report-range.sh 算期間、tools/report-template.sh 解析範本，以及四份報表範本與報表目錄範本。
Why: worklog 只記單筆工作，累積起來沒有工具看得出一週或一個月做了什麼、什麼在卡。要總結只能自己翻頁面加總。
How: 期間換算交給系統的 date，不自己算閏年與週界；週次採 ISO-8601。範本解析採工作目錄優先，.jsc/templates/report-{period}.md 蓋過技能自帶的那份，專案要換格式不必改技能。資料讀 LOG_CONTENTS 列出的所有日誌頁，取工作日期落在期間內的條目，只加總條目真的寫了的數字。
Who: 工作日誌的期間總結。
|
2026-08-26 10:47:07 +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
|
80f05ea1e3
|
docs(log): 同步文件與參考資料
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>
|
2026-08-25 14:58:54 +08:00 |
|
|
jiantw83andClaude Opus 5
|
5e11d7cf4c
|
docs(README): 安裝入口改為 plugins/meta 並補上遷移說明
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-08-24 18:00:35 +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 |
|
|
jiantw83andClaude Fable 5
|
1b0d4595c1
|
docs(readme): 說明文件補上 learn 技能與 LEARN 頁資訊
What：README.md 補上 learn 技能介紹、範本表新增 learn-page.md 與 learn-contents.md 兩列、環境變數一節加入 JSC_WIKI_REPO_LEARN 解析順序；AGENTS.md 的 domain 描述同步加入教訓紀錄與 LEARN_{HASH}。
Why：新技能加入後，安裝者與 AI 助理讀到的文件必須與實際技能清單一致，否則無從得知教訓紀錄功能的存在與 wiki 位置解析規則。
How：沿用既有文件結構，於技能清單、範本表、環境變數與 domain 簡介處逐段補述，並註明先讀 shell 繼承的環境變數、缺值才詢問。
Who：jsc-log domain 的說明文件（learn 教訓紀錄功能）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-24 11:36:59 +08:00 |
|
|
jiantw83
|
f81da60d02
|
fix(worklog): 下放 LOG 目標頁計算並統一 hash
|
2026-08-21 16:53:17 +00:00 |
|
|
jiantw83andClaude Fable 5
|
65f6bd3e07
|
style(log): 中文並列改頓號
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
|
e8b4b73a67
|
docs(log): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 14:03:37 +08:00 |
|
|
jiantw83andClaude Fable 5
|
3e027c11be
|
docs(log): 以統一格式改寫繁體中文 README 與 AGENTS
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 13:08:43 +08:00 |
|
|
jiantw83
|
e8a3d36503
|
Initial commit
|
2026-08-21 04:43:45 +00:00 |
|