plugins/log
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
51 Commits 5 Branches 0 Tags
037feb1b180b8237a8592e1702187543b2bec2b4
Commit Graph
51 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
admin 037feb1b18 Merge pull request 'release: 發布 jsc-log 相依版本宣告' (#21) from develop into master 
Reviewed-on: #21
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-28 06:52:03 +00:00
admin a617c599bb Merge pull request 'feat/plugin-dependencies/main' (#20) from feat/plugin-dependencies/main into develop 
Reviewed-on: #20
 2026-08-28 04:05:04 +00:00
admin 1e1ff8c9db Merge pull request 'feat/plugin-dependencies/declare-requires' (#19) from feat/plugin-dependencies/declare-requires into feat/plugin-dependencies/main 
Reviewed-on: #19
 2026-08-28 04:03:07 +00:00
jiantw83 bc8763c1b7 feat(manifest): 宣告 log 技能相依版本 2026-08-28 11:59:16 +08:00
admin 5ae9d869db Merge pull request 'release: v0.1.1 develop 到 master' (#18) from develop into master 
Reviewed-on: #18
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-27 04:14:22 +00:00
jiantw83 d01368248e Merge pull request 'feat(log): 每完成一個任務就寫一筆日誌，暫存改三段式寫入' (#17) from feat/sdlc-flow-rules/main into develop 2026-08-27 03:39:38 +00:00
admin c513f6a4e9 Merge pull request 'feat(log): 每完成一個任務就寫一筆日誌，暫存改三段式' (#16) from feat/sdlc-flow-rules/worklog-per-task into feat/sdlc-flow-rules/main 
Reviewed-on: #16
 2026-08-27 03:26:14 +00:00
jiantw83 52b35a2d6b chore(manifest): 三份 manifest 版本升到 0.1.1 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.0 改為 0.1.1。

Why：本次改了日誌粒度並新增三個暫存子命令，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。

How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。

Who：`jsc-log` 外掛的套件描述檔。
 2026-08-27 11:20:29 +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 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
jiantw83 416fb916cb feat(worklog-pending): 暫存改三段式的 merge、commit、abort 
What：`tools/worklog-pending.sh` 新增 `merge {hash} {本次條目檔}`、`commit {hash} {併入清單}`、`abort {hash} {併入清單}` 三個子命令。`merge` 合成「暫存內容在前、本次條目在後」的檔案並印出 `MERGED=`、`CLAIM=`、`PENDING=`；`commit` 只刪併入清單上那幾個檔；`abort` 暫存一個都不刪，只丟掉合併檔與清單。原本的 `clear` 保留，改為清掉全部暫存。

Why：暫存只能在 wiki 寫入成功之後才清，但原本只有一個 `clear`，呼叫端要嘛先清再寫（寫失敗就兩邊都沒有），要嘛寫完清全部（把 `merge` 之後才存進來的內容一起刪掉）。兩種都會弄丟工作紀錄。

How：`merge` 只讀不刪，刪檔一律等 `commit`，也就是等 wiki 回報成功。只刪清單上的檔案，是為了保住 `merge` 之後、`commit` 之前另一個工作階段新存進來的內容。`commit` 只認 `merge` 產出的清單，而且清單上的路徑必須落在該 hash 的暫存目錄底下，不然當用法錯誤擋下來——這道護欄擋的是拿別處的清單來刪檔。`merge` 在沒有暫存時仍然回 `0`，合併檔至少有本次條目，呼叫端不必分兩條路走。

Who：`jsc-log:worklog` 寫日誌那一步，以及用 `stage-report.sh --pending-file` 暫存過內容的 SDLC 階段。
 2026-08-27 11:20:28 +08:00
admin 123e5a83ef Merge pull request 'release: develop 併入 master（report）' (#15) from develop into master 
Reviewed-on: #15
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-26 03:00:00 +00:00
admin 74aada742c Merge pull request 'feat/log-period-report-skill' (#14) from feat/log-period-report-skill into develop 
Reviewed-on: #14
 2026-08-26 02:51:27 +00: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
admin 76bddf1630 Merge pull request 'log 0.0.9 發佈：工作日誌待寫入暫存' (#13) from develop into master 
Reviewed-on: #13
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-26 01:33:44 +00:00
admin b1baaf1546 Merge pull request 'feat(log): 工作日誌支援待寫入暫存' (#12) from feat/worklog-pending into develop 
Reviewed-on: #12
 2026-08-26 01:29:38 +00: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
admin 317af748ca Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#11) from fix/skillset-audit-compliance-and-guard-fixes into develop 
Reviewed-on: #11
 2026-08-25 07:15:05 +00:00
jiantw83andClaude Opus 5 42e98f11de chore(log): 三份 manifest 同步升版並同步 marketplace 正本 
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>
 2026-08-25 14:58:54 +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 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
admin 5e13d8d48f Merge pull request '發佈 jsc-log 0.0.6：跨頁型連結改用絕對網址' (#10) from develop into master 
Reviewed-on: #10
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-25 00:32:07 +00:00
admin 6f28e1ae84 Merge pull request 'fix(wiki 連結): 方向修正與跨存取庫改用絕對網址（升版 0.0.6）' (#9) from fix/wiki-link-direction-and-scope into develop 
Reviewed-on: #9
 2026-08-24 11:00:30 +00:00
jiantw83andClaude Opus 5 5d12ad6f43 chore(plugin 版本): 三份 manifest 升版至 0.0.6 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:54:19 +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
admin e7659bcfaf Merge pull request '發佈 jsc-log 0.0.5：marketplace 正本移至 plugins/meta' (#8) from develop into master 
Reviewed-on: #8
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 10:18:58 +00:00
admin fea8702d91 Merge pull request 'chore(marketplace 正本): 正本移至 plugins/meta（升版 0.0.5）' (#7) from chore/marketplace-canon-to-meta into develop 
Reviewed-on: #7
 2026-08-24 10:13:20 +00:00
jiantw83andClaude Opus 5 c2f1508b17 chore(plugin 版本): 三份 manifest 升版至 0.0.5 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +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
admin ec7d17e0cd Merge pull request '發佈 jsc-log 0.0.4：新增 learn 技能與 LEARN 頁、worklog hash 重構' (#6) from develop into master 
Reviewed-on: #6
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 08:27:22 +00:00
admin bbce74836b Merge pull request 'fix/marketplace-sync-worklog-hash-refactor' (#5) from fix/marketplace-sync-worklog-hash-refactor into develop 
Reviewed-on: #5
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 07:58:59 +00: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 d8769ec76a fix(marketplace): 同步 marketplace.json 至 plugins/jsc 標準格式 
什麼：為 .agents/plugins/marketplace.json 補上 description、owner 欄位，並為所有 plugin 項目補上各自的 description；同時修正 .claude-plugin/marketplace.json 中 jsc-meta 描述的標點（斜線改為頓號）。

為什麼：兩份 marketplace.json 與 plugins/jsc 的標準格式不同步，缺少的欄位會讓其他 CLI（antigravity 等）讀到的 marketplace metadata 不完整。

如何：對照 plugins/jsc 的 canonical marketplace.json，逐一補齊頂層 description、owner 物件，以及每個 plugin 的 description 欄位；統一標點用字。

誰：jsc-meta:skill-check 例行合規稽核。
 2026-08-24 14:47:08 +08:00
admin afa51e22d0 Merge pull request 'feat/learn-skill' (#4) from feat/learn-skill into develop 
Reviewed-on: #4
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 03:47:58 +00:00
jiantw83andClaude Fable 5 bc4f2c6f25 chore(manifest): 三份 plugin 資訊清單版本升至 0.0.3 並更新描述 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本由 0.0.2 升至 0.0.3，描述加入教訓紀錄（LEARN_{HASH} wiki 頁）。
Why：本次新增 learn 技能屬功能擴充，三份資訊清單須同步升版並反映新功能，安裝端才能辨識更新。
How：三份檔案的 version 與 description 欄位一致修改，維持各 CLI 入口內容同步。
Who：jsc-log plugin 的資訊清單（learn 教訓紀錄功能）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:37:13 +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
jiantw83andClaude Fable 5 fac3285ca7 feat(learn): 新增技能教訓紀錄與查閱技能及 LEARN wiki 頁範本 
What：新增 skills/learn/SKILL.md（record／consult 兩種模式）與 templates/learn-page.md、templates/learn-contents.md 兩份 wiki 頁範本。
Why：參考 oh-my-pi 的 learn 工具，讓技能執行後能把教訓沉澱下來、執行前能先查閱套用，避免同樣的問題重複發生。
How：教訓以六欄表格（日期、技能、CLI、情境、教訓、下次做法）逐列附加到 LEARN_{HASH}，並同步更新 LEARN_CONTENTS 目錄；HASH 依共用 8 碼 wiki hash 規則（含 H 前綴退回），wiki 位置依 JSC_WIKI_REPO_LEARN → JSC_WIKI_REPO 解析，讀寫皆透過 jsc-gitea:wiki。
Who：jsc-log domain 的 learn 技能（教訓紀錄與查閱功能）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:36:45 +08:00
admin 307d5100ee Merge pull request 'fix/worklog-target-helper' (#3) from develop into master 
Reviewed-on: #3
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-21 16:55:43 +00:00
jiantw83 f81da60d02 fix(worklog): 下放 LOG 目標頁計算並統一 hash 2026-08-21 16:53:17 +00:00
admin 8bdb82a5e1 Merge pull request 'feat(log): 匯入 jsc-log 技能組並統一 marketplace 為 jsc' (#2) from develop into master 
Reviewed-on: #2
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-21 06:41:52 +00:00
jiantw83andClaude Fable 5 e70ee90efe chore(log): 加入統一 jsc marketplace 副本（與正本一致，任一 repo 可作註冊入口） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:48 +08: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 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 5a1aab76e9 docs(log): AGENTS 語言規則改指向 jsc-meta 的 references/ste100.md 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:13:27 +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 c243e188b8 chore(log): 版本號改為 0.0.1 並移除個別 marketplace（統一為 jsc） 
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
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
jiantw83andClaude Fable 5 5afb39d3ed chore(log): 修正範本 manifest 與移除 hello 範例符合 log 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:18 +08:00