plugins/log
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat/learn-skill #4

Merged
admin merged 3 commits from feat/learn-skill into develop 2026-08-24 03:47:59 +00:00
Conversation 1 Commits 3 Files Changed 8
+73 -9
jiantw83 commented 2026-08-24 03:37:57 +00:00
Member
Copy Link
Copy Source

PR 描述

摘要

  • 需求描述：參考 oh-my-pi 的 learn 工具，新增 jsc-log:learn 技能：技能執行後把教訓記到 wiki LEARN_{HASH} 並更新 LEARN_CONTENTS，技能執行前可查閱同兩頁並套用「下次做法」；wiki 位置依 JSC_WIKI_REPO_LEARN → JSC_WIKI_REPO 解析。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
skills/learn/SKILL.md 新增 learn 技能，含 record（記錄教訓）與 consult（執行前查閱）兩種模式
templates/learn-page.md 新增教訓紀錄頁 LEARN_{HASH} 範本（六欄表格，逐列附加）
templates/learn-contents.md 新增教訓目錄 LEARN_CONTENTS 範本（每存取庫一列）
README.md 補上 learn 技能介紹、範本表新增兩列、環境變數加入 JSC_WIKI_REPO_LEARN 解析順序
AGENTS.md domain 描述同步加入教訓紀錄與 LEARN_{HASH}
plugin.json 版本升至 0.0.3，描述加入教訓紀錄
.claude-plugin/plugin.json 版本升至 0.0.3，描述加入教訓紀錄
.codex-plugin/plugin.json 版本升至 0.0.3，描述加入教訓紀錄

設計重點

  • 教訓以六欄表格（日期、技能、CLI、情境、教訓、下次做法）逐列附加到 LEARN_{HASH}，不覆蓋舊列，執行前先查閱套用。
  • HASH 依共用 8 碼 wiki hash 規則產生（SHA-1 前 8 碼大寫；首碼為 0-9、A、B、C 時改用 H 加原前 7 碼）。
  • wiki 位置依 JSC_WIKI_REPO_LEARN → JSC_WIKI_REPO 解析，先讀 shell 繼承的環境變數，缺值才依 jsc-ask:ask 規則詢問；所有 wiki 讀寫透過 jsc-gitea:wiki。
  • 三份 plugin 資訊清單（claude／codex／根目錄）版本與描述同步，維持各 CLI 入口一致。

測試結果

  • 三份 manifest JSON 驗證通過（plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json）。
  • ste100-lint 通過。
  • UTF-8 檢查通過。

前置 Push Request

  • plugins/gitea 的 feat/learn-page-type、plugins/meta 的 docs/learn-wiki-page-type（PR 編號建立後由主流程掛上依賴）。
# PR 描述 ## 摘要 - 需求描述：參考 oh-my-pi 的 learn 工具，新增 `jsc-log:learn` 技能：技能執行後把教訓記到 wiki `LEARN_{HASH}` 並更新 `LEARN_CONTENTS`，技能執行前可查閱同兩頁並套用「下次做法」；wiki 位置依 `JSC_WIKI_REPO_LEARN` → `JSC_WIKI_REPO` 解析。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | skills/learn/SKILL.md | 新增 learn 技能，含 record（記錄教訓）與 consult（執行前查閱）兩種模式 | | templates/learn-page.md | 新增教訓紀錄頁 `LEARN_{HASH}` 範本（六欄表格，逐列附加） | | templates/learn-contents.md | 新增教訓目錄 `LEARN_CONTENTS` 範本（每存取庫一列） | | README.md | 補上 learn 技能介紹、範本表新增兩列、環境變數加入 `JSC_WIKI_REPO_LEARN` 解析順序 | | AGENTS.md | domain 描述同步加入教訓紀錄與 `LEARN_{HASH}` | | plugin.json | 版本升至 0.0.3，描述加入教訓紀錄 | | .claude-plugin/plugin.json | 版本升至 0.0.3，描述加入教訓紀錄 | | .codex-plugin/plugin.json | 版本升至 0.0.3，描述加入教訓紀錄 | ## 設計重點 - 教訓以六欄表格（日期、技能、CLI、情境、教訓、下次做法）逐列附加到 `LEARN_{HASH}`，不覆蓋舊列，執行前先查閱套用。 - `HASH` 依共用 8 碼 wiki hash 規則產生（SHA-1 前 8 碼大寫；首碼為 `0-9`、`A`、`B`、`C` 時改用 `H` 加原前 7 碼）。 - wiki 位置依 `JSC_WIKI_REPO_LEARN` → `JSC_WIKI_REPO` 解析，先讀 shell 繼承的環境變數，缺值才依 `jsc-ask:ask` 規則詢問；所有 wiki 讀寫透過 `jsc-gitea:wiki`。 - 三份 plugin 資訊清單（claude／codex／根目錄）版本與描述同步，維持各 CLI 入口一致。 ## 測試結果 - 三份 manifest JSON 驗證通過（plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json）。 - ste100-lint 通過。 - UTF-8 檢查通過。 ## 前置 Push Request - plugins/gitea 的 feat/learn-page-type、plugins/meta 的 docs/learn-wiki-page-type（PR 編號建立後由主流程掛上依賴）。
jiantw83 added 3 commits 2026-08-24 03:37:57 +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>
jiantw83 added a new dependency 2026-08-24 03:38:36 +00:00
plugins/gitea#6 - feat/learn-page-type
jiantw83 added a new dependency 2026-08-24 03:38:37 +00:00
plugins/meta#7 - docs/learn-wiki-page-type
admin approved these changes 2026-08-24 03:47:55 +00:00
admin merged commit afa51e22d0 into develop 2026-08-24 03:47:59 +00:00
admin deleted branch feat/learn-skill 2026-08-24 03:47:59 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Depends on
#6 feat/learn-page-type
plugins/gitea
#7 docs/learn-wiki-page-type
plugins/meta
Reference: plugins/log#4