fix/skillset-audit-compliance-and-guard-fixes #11

2026-08-25T07:03:49Z

jiantw83 commented

2026-08-25 07:03:49 +00:00

摘要

需求描述：jsc-meta:skill-check 例行稽核（2026-08-25）。本 repo 修正 worklog 把程式碼存取庫當成 wiki 存取庫傳給 wiki-url 的跨 repo 錯誤、用目錄頁範本建立條目頁的 bug，以及 token 統計漏算快取輸入。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`skills/worklog/SKILL.md`	補上 `JSC_WIKI_REPO_LOG` 到 `JSC_WIKI_REPO` 的解析規則與不得跨類型代用；PLAN、ANALYZE 連結改為先以 `gitea.sh wiki-repo {類型}` 解析主機存取庫再傳給 `wiki-url`；補 `wiki-repo` exit 3 與 `wiki-url` exit 4 的「無」退路；建立缺少的 `LOG_{HASH}` 改用條目頁範本；工時與 token 傳同一個 session id；工作狀態改走 `jsc-ask:ask`；步驟改編號並補完成條件
`tools/token-usage.sh`	新增。各 CLI 的 token 取法下放腳本；可接 session id；輸入總和補上 `cache_creation_input_tokens` 與 `cache_read_input_tokens`
`skills/learn/SKILL.md`	hash 演算法敘述收成呼叫 `jsc-gitea/tools/hash-id`
`skills/stats/SKILL.md`	兩個回報步驟補完成條件
`templates/log-entry.md`	補上與技能一致的「無」退路說明
`README.md`	工具表新增 `token-usage.sh` 與 session id 參數
三份 manifest、兩份 marketplace	同步升版至 0.0.8，marketplace 與正本對齊

設計重點

wiki-url 的第一個參數是 wiki 主機存取庫，不是程式碼存取庫。原本第 1 列把 {owner}/{repo} 定義成 git remote 取得的程式碼 repo，第 3、4 列又把同一個值傳進去——PLAN 與 ANALYZE 在不同 wiki 時必然查錯，而那兩列自己的說明文字正好承認了這個跨 repo 情境。
input_tokens 只算未命中快取的部分。原先只加總這個欄位，輸入被漏掉絕大部分，同一個 session 修正前是 510 對 734945；補上兩個快取欄位後為 50124067 對 738238。

測試結果

對照 /root/plugins/gitea/tools/gitea.sh 引用行確認 wiki-repo exit 3、wiki-url exit 4 的實際行為。
token-usage.sh 實測：不帶 session id 讀到全域最新的 transcript（實際上是一份 sub agent 紀錄），帶 session id 讀到該 session 自己的；未知 session id 會警告後退回；未知 CLI 名 exit 2；讀不到來源回 N/A 且 exit 0。
sh -n 全部通過；ste100-lint.sh exit 0。
stats 與 learn 在首輪稽核即全項通過，本次僅動到上述兩處。

前置 Push Request

無

## 摘要 - 需求描述：jsc-meta:skill-check 例行稽核（2026-08-25）。本 repo 修正 `worklog` 把程式碼存取庫當成 wiki 存取庫傳給 `wiki-url` 的跨 repo 錯誤、用目錄頁範本建立條目頁的 bug，以及 token 統計漏算快取輸入。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `skills/worklog/SKILL.md` | 補上 `JSC_WIKI_REPO_LOG` 到 `JSC_WIKI_REPO` 的解析規則與不得跨類型代用；PLAN、ANALYZE 連結改為先以 `gitea.sh wiki-repo {類型}` 解析主機存取庫再傳給 `wiki-url`；補 `wiki-repo` exit 3 與 `wiki-url` exit 4 的「無」退路；建立缺少的 `LOG_{HASH}` 改用條目頁範本；工時與 token 傳同一個 session id；工作狀態改走 `jsc-ask:ask`；步驟改編號並補完成條件 | | `tools/token-usage.sh` | 新增。各 CLI 的 token 取法下放腳本；可接 session id；輸入總和補上 `cache_creation_input_tokens` 與 `cache_read_input_tokens` | | `skills/learn/SKILL.md` | hash 演算法敘述收成呼叫 `jsc-gitea/tools/hash-id` | | `skills/stats/SKILL.md` | 兩個回報步驟補完成條件 | | `templates/log-entry.md` | 補上與技能一致的「無」退路說明 | | `README.md` | 工具表新增 `token-usage.sh` 與 session id 參數 | | 三份 manifest、兩份 marketplace | 同步升版至 0.0.8，marketplace 與正本對齊 | ## 設計重點 - `wiki-url` 的第一個參數是 wiki 主機存取庫，不是程式碼存取庫。原本第 1 列把 `{owner}/{repo}` 定義成 `git remote` 取得的程式碼 repo，第 3、4 列又把同一個值傳進去——PLAN 與 ANALYZE 在不同 wiki 時必然查錯，而那兩列自己的說明文字正好承認了這個跨 repo 情境。 - `input_tokens` 只算未命中快取的部分。原先只加總這個欄位，輸入被漏掉絕大部分，同一個 session 修正前是 510 對 734945；補上兩個快取欄位後為 50124067 對 738238。 ## 測試結果 - 對照 `/root/plugins/gitea/tools/gitea.sh` 引用行確認 `wiki-repo` exit 3、`wiki-url` exit 4 的實際行為。 - `token-usage.sh` 實測：不帶 session id 讀到全域最新的 transcript（實際上是一份 sub agent 紀錄），帶 session id 讀到該 session 自己的；未知 session id 會警告後退回；未知 CLI 名 exit 2；讀不到來源回 `N/A` 且 exit 0。 - `sh -n` 全部通過；`ste100-lint.sh` exit 0。 - `stats` 與 `learn` 在首輪稽核即全項通過，本次僅動到上述兩處。 ## 前置 Push Request - 無

jiantw83 added 3 commits 2026-08-25 07:03:50 +00:00

fix(log): 補齊稽核缺失並修掉護欄失效 d4bf31421d

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>

docs(log): 同步文件與參考資料 80f05ea1e3

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>

chore(log): 三份 manifest 同步升版並同步 marketplace 正本 42e98f11de

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>

admin merged commit 317af748ca into develop

2026-08-25 07:15:05 +00:00

admin deleted branch fix/skillset-audit-compliance-and-guard-fixes

2026-08-25 07:15:05 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/log#11