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

2026-08-25T07:03:52Z

jiantw83 commented

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

摘要

需求描述：jsc-meta:skill-check 例行稽核（2026-08-25）。本 repo 補回一條在文件重整中遺失的分支護欄，補齊 20 個缺完成條件的步驟，並把重複敘述收成單一來源。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/branch.md`	補回「來源分支在遠端找不到就回報並停止」這條停止規則，並在通用後備那節加排除條款，避免與挑基準分支的後備順序混淆；PR 未合併的閘門procedure 收成規則加互參
`references/model-gate.md`	新增。四支技能重複四遍的模型閘門規則收到這裡
`skills/plan/SKILL.md`、`skills/analyze/SKILL.md`、`skills/implement/SKILL.md`、`skills/maintain/SKILL.md`	閘門區塊收成一行呼叫加指引；補齊完成條件；中文章節標題與佔位符改英文；模糊語改成可判定規則；`implement` 補 sub agent 強制語句、修正無法解析的工具路徑、description 收進句數上限
`README.md`	worktree 移除時機改為「PR 合併後才移除」（原本寫「PR 成功後」，與 branch.md 明確相反）；模型閘門段落收成一行加指引
`references/deliver-formats.md`、`templates/*.md`	重複的規則敘述收成單一來源；中文並列改頓號
`templates/error-page.md`、`templates/error-contents.md`	刪除。ERROR 頁與範本歸 jsc-hooks，本 domain 的副本已與原版分歧且無技能引用
三份 manifest、兩份 marketplace	同步升版至 0.1.4，marketplace 與正本對齊

設計重點

漸進揭露搬移內容時，指標指向的地方必須真的有那條規則。這次補回的護欄原本寫在 implement 內文，搬到 references/branch.md 的過程中掉了，而該檔關於後備分支的敘述剛好相反——照著指標讀會得到相反的指引。缺了它，單一工作包會越過自己的功能分支直接進 develop，而且沒有徵兆。
停止條件與後備條件要分開寫。已指定的來源分支找不到是停止條件；還沒指定分支、要挑一條基準才適用後備順序。

測試結果

ste100-lint.sh exit 0。
逐一 grep 驗證每個 references 與 templates 指標都指到真的存在的檔案與內容，不是只確認檔案存在——這次的回歸正是「指標承諾了目標沒有的內容」。
殘留檢查：已無「PR 成功後移除」、無「whenever possible」、無「Try to rename」、無中文注解式標題、無技能引用已刪除的 error 範本。
plan 與 analyze 的「純邏輯、不得寫檔」護欄維持不動。

前置 Push Request

無

## 摘要 - 需求描述：jsc-meta:skill-check 例行稽核（2026-08-25）。本 repo 補回一條在文件重整中遺失的分支護欄，補齊 20 個缺完成條件的步驟，並把重複敘述收成單一來源。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/branch.md` | 補回「來源分支在遠端找不到就回報並停止」這條停止規則，並在通用後備那節加排除條款，避免與挑基準分支的後備順序混淆；PR 未合併的閘門procedure 收成規則加互參 | | `references/model-gate.md` | 新增。四支技能重複四遍的模型閘門規則收到這裡 | | `skills/plan/SKILL.md`、`skills/analyze/SKILL.md`、`skills/implement/SKILL.md`、`skills/maintain/SKILL.md` | 閘門區塊收成一行呼叫加指引；補齊完成條件；中文章節標題與佔位符改英文；模糊語改成可判定規則；`implement` 補 sub agent 強制語句、修正無法解析的工具路徑、description 收進句數上限 | | `README.md` | worktree 移除時機改為「PR 合併後才移除」（原本寫「PR 成功後」，與 branch.md 明確相反）；模型閘門段落收成一行加指引 | | `references/deliver-formats.md`、`templates/*.md` | 重複的規則敘述收成單一來源；中文並列改頓號 | | `templates/error-page.md`、`templates/error-contents.md` | 刪除。ERROR 頁與範本歸 jsc-hooks，本 domain 的副本已與原版分歧且無技能引用 | | 三份 manifest、兩份 marketplace | 同步升版至 0.1.4，marketplace 與正本對齊 | ## 設計重點 - 漸進揭露搬移內容時，指標指向的地方必須真的有那條規則。這次補回的護欄原本寫在 `implement` 內文，搬到 `references/branch.md` 的過程中掉了，而該檔關於後備分支的敘述剛好相反——照著指標讀會得到相反的指引。缺了它，單一工作包會越過自己的功能分支直接進 develop，而且沒有徵兆。 - 停止條件與後備條件要分開寫。已指定的來源分支找不到是停止條件；還沒指定分支、要挑一條基準才適用後備順序。 ## 測試結果 - `ste100-lint.sh` exit 0。 - 逐一 grep 驗證每個 references 與 templates 指標都指到真的存在的檔案與內容，不是只確認檔案存在——這次的回歸正是「指標承諾了目標沒有的內容」。 - 殘留檢查：已無「PR 成功後移除」、無「whenever possible」、無「Try to rename」、無中文注解式標題、無技能引用已刪除的 error 範本。 - `plan` 與 `analyze` 的「純邏輯、不得寫檔」護欄維持不動。 ## 前置 Push Request - 無

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

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

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(sdlc): 同步文件與參考資料 821261ad9d

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(sdlc): 三份 manifest 同步升版並同步 marketplace 正本 4dcf5a7401

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 957948931e into develop

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

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

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

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/sdlc#18