發佈 jsc-log 0.0.4：新增 learn 技能與 LEARN 頁、worklog hash 重構 #6

2026-08-24T08:23:34Z

jiantw83 commented

2026-08-24 08:23:34 +00:00

本 PR 內容

把 develop 累積的變更發佈到 master。

項目	值
master 現行版本	0.0.2
發佈後版本	0.0.4
領先 commit 數	7

Commit 清單

bbce748 Merge pull request 'fix/marketplace-sync-worklog-hash-refactor' (#5) from fix/marketplace-sync-worklog-hash-refactor into develop
b1a0418 refactor(worklog): worklog-target.sh 改為接收已算好的 hash
d8769ec fix(marketplace): 同步 marketplace.json 至 plugins/jsc 標準格式
afa51e2 Merge pull request 'feat/learn-skill' (#4) from feat/learn-skill into develop
bc4f2c6 chore(manifest): 三份 plugin 資訊清單版本升至 0.0.3 並更新描述
1b0d459 docs(readme): 說明文件補上 learn 技能與 LEARN 頁資訊
fac3285 feat(learn): 新增技能教訓紀錄與查閱技能及 LEARN wiki 頁範本

注意事項

版本自 0.0.2 升至 0.0.4，符合單調遞增。
master 另有 2 個 develop 沒有的 commit（多為先前的合併節點）；Gitea 會在頁面標示是否可自動合併，若有衝突請先在 develop 解掉。

## 本 PR 內容把 `develop` 累積的變更發佈到 `master`。 | 項目 | 值 | | --- | --- | | master 現行版本 | 0.0.2 | | 發佈後版本 | 0.0.4 | | 領先 commit 數 | 7 | ## Commit 清單 - bbce748 Merge pull request 'fix/marketplace-sync-worklog-hash-refactor' (#5) from fix/marketplace-sync-worklog-hash-refactor into develop - b1a0418 refactor(worklog): worklog-target.sh 改為接收已算好的 hash - d8769ec fix(marketplace): 同步 marketplace.json 至 plugins/jsc 標準格式 - afa51e2 Merge pull request 'feat/learn-skill' (#4) from feat/learn-skill into develop - bc4f2c6 chore(manifest): 三份 plugin 資訊清單版本升至 0.0.3 並更新描述 - 1b0d459 docs(readme): 說明文件補上 learn 技能與 LEARN 頁資訊 - fac3285 feat(learn): 新增技能教訓紀錄與查閱技能及 LEARN wiki 頁範本 ## 注意事項 - 版本自 0.0.2 升至 0.0.4，符合單調遞增。 - `master` 另有 2 個 `develop` 沒有的 commit（多為先前的合併節點）；Gitea 會在頁面標示是否可自動合併，若有衝突請先在 `develop` 解掉。

jiantw83 added 7 commits 2026-08-24 08:23:34 +00:00

feat(learn): 新增技能教訓紀錄與查閱技能及 LEARN wiki 頁範本 fac3285ca7

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>

docs(readme): 說明文件補上 learn 技能與 LEARN 頁資訊 1b0d4595c1

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>

chore(manifest): 三份 plugin 資訊清單版本升至 0.0.3 並更新描述 bc4f2c6f25

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>

Merge pull request 'feat/learn-skill' (#4 ) from feat/learn-skill into develop afa51e22d0

Reviewed-on: #4
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

fix(marketplace): 同步 marketplace.json 至 plugins/jsc 標準格式 d8769ec76a

什麼：為 .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 例行合規稽核。

refactor(worklog): worklog-target.sh 改為接收已算好的 hash b1a0418211

什麼：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 技能）。

Merge pull request 'fix/marketplace-sync-worklog-hash-refactor' (#5 ) from fix/marketplace-sync-worklog-hash-refactor into develop bbce74836b

Reviewed-on: #5
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

admin approved these changes 2026-08-24 08:27:19 +00:00

admin merged commit ec7d17e0cd into master

2026-08-24 08:27:22 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/log#6