整理 learn、report、stats、worklog 四支技能的行為清單 #24

2026-08-31T05:40:37Z

jiantw83 commented

2026-08-31 05:40:37 +00:00

摘要

需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。日後任何技能異動都要同步更新這份清單。本 PR 交付 jsc-log 這一份。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增。記錄 learn、report、stats、worklog 四支技能的行為基準，每支一張五列表，作為技能驗證的比對正本
`.claude-plugin/plugin.json`	版號由 0.1.3 升到 0.1.4，讓 Claude Code 的版本守衛認得這次內容變更
`.codex-plugin/plugin.json`	同上，Codex 端的 manifest 版號跟著同步
`plugin.json`	同上，根目錄 manifest 版號跟著同步，三邊同號

設計重點

五個欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。欄位固定，程式才判定得了，稽核也不用每次重新約定要看什麼。
節名與 skills/ 底下的目錄名逐字相同，節序照目錄名字典序排。技能新增或刪除時，清單缺一節、多一節都會被抓出來。
格式不靠人看，由 jsc-meta/tools/check-behaviors.sh 檢查六項合約：標題、節對技能、節順序、表格、五個欄位、內容欄非空。
清單放在各自的 repo，不集中到 meta。技能改動與清單在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。
「可驗證跡象」欄只寫得出外部可觀察的結果，例如 wiki 頁多一列、暫存檔清空。驗證時不用讀技能內部實作也能判定。

測試結果

本次只新增參考文件與升版，沒有新增或改動可執行程式碼，因此沒有單元測試可跑。
找腳本：ls /root/.claude/plugins/cache/jsc/jsc-meta/*/tools/check-behaviors.sh 找不到，退出碼 2，訊息為 No such file or directory。腳本實際在工作目錄的正本 /root/plugins/meta/tools/check-behaviors.sh，快取目錄尚未部署到這一版。
格式檢查：sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/log，退出碼 0，輸出 行為清單檢查通過：/root/plugins/log/references/behaviors.md 對上 4 支技能，五個欄位齊全。
人工核對：ls /root/plugins/log/skills/ 列出 learn、report、stats、worklog 四支，與 references/behaviors.md 的四節逐字相符。
版號核對：git diff 顯示三份 manifest 都只改 version 一個欄位，一致由 0.1.3 改為 0.1.4。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。日後任何技能異動都要同步更新這份清單。本 PR 交付 jsc-log 這一份。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增。記錄 learn、report、stats、worklog 四支技能的行為基準，每支一張五列表，作為技能驗證的比對正本 | | `.claude-plugin/plugin.json` | 版號由 0.1.3 升到 0.1.4，讓 Claude Code 的版本守衛認得這次內容變更 | | `.codex-plugin/plugin.json` | 同上，Codex 端的 manifest 版號跟著同步 | | `plugin.json` | 同上，根目錄 manifest 版號跟著同步，三邊同號 | ## 設計重點 - 五個欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。欄位固定，程式才判定得了，稽核也不用每次重新約定要看什麼。 - 節名與 `skills/` 底下的目錄名逐字相同，節序照目錄名字典序排。技能新增或刪除時，清單缺一節、多一節都會被抓出來。 - 格式不靠人看，由 `jsc-meta/tools/check-behaviors.sh` 檢查六項合約：標題、節對技能、節順序、表格、五個欄位、內容欄非空。 - 清單放在各自的 repo，不集中到 meta。技能改動與清單在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。 - 「可驗證跡象」欄只寫得出外部可觀察的結果，例如 wiki 頁多一列、暫存檔清空。驗證時不用讀技能內部實作也能判定。 ## 測試結果 - 本次只新增參考文件與升版，沒有新增或改動可執行程式碼，因此沒有單元測試可跑。 - 找腳本：`ls /root/.claude/plugins/cache/jsc/jsc-meta/*/tools/check-behaviors.sh` 找不到，退出碼 2，訊息為 `No such file or directory`。腳本實際在工作目錄的正本 `/root/plugins/meta/tools/check-behaviors.sh`，快取目錄尚未部署到這一版。 - 格式檢查：`sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/log`，退出碼 0，輸出 `行為清單檢查通過：/root/plugins/log/references/behaviors.md 對上 4 支技能，五個欄位齊全`。 - 人工核對：`ls /root/plugins/log/skills/` 列出 learn、report、stats、worklog 四支，與 `references/behaviors.md` 的四節逐字相符。 - 版號核對：`git diff` 顯示三份 manifest 都只改 `version` 一個欄位，一致由 0.1.3 改為 0.1.4。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:40:37 +00:00

docs(behaviors): 新增 jsc-log 技能行為清單 5070863063

- What：新建 `references/` 目錄，加入 `references/behaviors.md`。內含 learn、report、stats、worklog 四節，每節一張五列表，欄位為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。
- Why：技能驗證原本沒有基準，只能靠人逐份比對 SKILL.md，10 個 domain 每次稽核都要重做，還會漏。把每支技能的行為寫成清單，驗證就有可比對的正本。技能改了行為、清單沒跟著改，兩邊就漂移，所以規定日後任何技能異動都要在同一個 PR 內同步更新這一頁。
- How：逐支讀 `skills/*/SKILL.md`，把流程拆成五個固定欄位。節名與技能目錄名逐字相同，節序照目錄名字典序排。格式不靠人看，由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查六項合約。清單放在本 repo 而不是集中到 meta，這樣技能改動與清單在同一個 PR，不會漂移，也不用跨 repo 開兩條 PR 互卡。
- Who：屬於技能行為清單功能，是 jsc 技能組技能驗證基準的 jsc-log 部分。

chore(manifest): 三份 manifest 版號升到 0.1.4 6cf9884d42

- What：把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 的 `version` 由 0.1.3 改成 0.1.4。
- Why：本次新增技能行為清單，是對外可見的內容變更。版號不動，各 CLI 的版本守衛就認不出這份外掛已更新，使用者端不會拉到新內容。
- How：三份 manifest 只改 `version` 一個欄位，三邊同號。其餘欄位一字不動。
- Who：屬於技能行為清單功能，負責讓這次變更能被部署與版本檢查認得。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 整理 learn、report、stats、worklog 四支技能的行為清單

2026-08-31 06:36:24 +00:00

jiantw83 referenced this pull request

2026-08-31 06:37:14 +00:00

收攏 log 四支技能的行為清單，功能主幹併回 develop #25

jiantw83 added a new dependency 2026-08-31 06:37:34 +00:00

#25 收攏 log 四支技能的行為清單，功能主幹併回 develop

jiantw83 merged commit 8216650b28 into feat/skill-behaviors-and-version-block/main

2026-08-31 08:09:23 +00:00

Sign in to join this conversation.