列出 analyze、implement、maintain、plan 四支技能的行為清單 #46

2026-08-31T05:49:33Z

jiantw83 commented

2026-08-31 05:49:33 +00:00

摘要

需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。日後任何技能異動，都要在同一個 PR 內同步更新這份清單。清單格式由 /root/plugins/meta/tools/check-behaviors.sh 在程式層檢查。本 PR 交付 jsc-sdlc 這個存取庫的清單，涵蓋 analyze、implement、maintain、plan 四支技能。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增檔案，放進既有的 `references/` 目錄。記錄四支技能的行為基準，供技能驗證比對。四節各一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。
`.claude-plugin/plugin.json`	本次有外部可見的異動，版本從 0.2.6 升到 0.2.7。
`.codex-plugin/plugin.json`	同上，三份 manifest 版本必須一致，一起升到 0.2.7。
`plugin.json`	同上，三份 manifest 版本必須一致，一起升到 0.2.7。

設計重點

清單放在各自的存取庫，不集中在 meta。技能改動與清單落在同一個 PR，才不會漂移，也不用跨存取庫開兩條 PR 互卡。
五個欄位固定不變，格式交給 check-behaviors.sh 在程式層擋，不靠人工目視。
「可驗證跡象」只寫看得到的產物：wiki 頁、目錄頁的列、分支、PR、狀態檔、目錄。這樣驗證的人可以直接去對。
稽核時修正三列狀態檔路徑。analyze、plan、maintain 的階段鎖狀態檔原本寫成 $JSC_HOME/wp/，實際位置是 $JSC_HOME/sessions/{工作階段 id}.stage。$JSC_HOME/wp/ 放的是 implement 的工作包領取檔與 PR 鎖檔，兩者不可混寫。
references/ 是既有目錄，本次沒有新建目錄。behaviors.md 與其他七份參考文件同層。
三份 manifest 一起升版，避免不同 CLI 讀到不同版號。

測試結果

sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/sdlc：退出碼 0，輸出「行為清單檢查通過：/root/plugins/sdlc/references/behaviors.md 對上 4 支技能，五個欄位齊全」。
git -C /root/plugins/sdlc diff：退出碼 0，差異只有三份 manifest 的 version 欄位由 0.2.6 改成 0.2.7，沒有其他欄位變動。
git -C /root/plugins/sdlc status --porcelain：三份 manifest 標為 M，references/behaviors.md 標為 ??，沒有其他待提交檔案。
本次只改文件與版號，沒有可執行的程式碼異動，因此沒有另外跑單元測試。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。日後任何技能異動，都要在同一個 PR 內同步更新這份清單。清單格式由 `/root/plugins/meta/tools/check-behaviors.sh` 在程式層檢查。本 PR 交付 jsc-sdlc 這個存取庫的清單，涵蓋 analyze、implement、maintain、plan 四支技能。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增檔案，放進既有的 `references/` 目錄。記錄四支技能的行為基準，供技能驗證比對。四節各一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。 | | `.claude-plugin/plugin.json` | 本次有外部可見的異動，版本從 0.2.6 升到 0.2.7。 | | `.codex-plugin/plugin.json` | 同上，三份 manifest 版本必須一致，一起升到 0.2.7。 | | `plugin.json` | 同上，三份 manifest 版本必須一致，一起升到 0.2.7。 | ## 設計重點 - 清單放在各自的存取庫，不集中在 meta。技能改動與清單落在同一個 PR，才不會漂移，也不用跨存取庫開兩條 PR 互卡。 - 五個欄位固定不變，格式交給 `check-behaviors.sh` 在程式層擋，不靠人工目視。 - 「可驗證跡象」只寫看得到的產物：wiki 頁、目錄頁的列、分支、PR、狀態檔、目錄。這樣驗證的人可以直接去對。 - 稽核時修正三列狀態檔路徑。analyze、plan、maintain 的階段鎖狀態檔原本寫成 `$JSC_HOME/wp/`，實際位置是 `$JSC_HOME/sessions/{工作階段 id}.stage`。`$JSC_HOME/wp/` 放的是 implement 的工作包領取檔與 PR 鎖檔，兩者不可混寫。 - `references/` 是既有目錄，本次沒有新建目錄。`behaviors.md` 與其他七份參考文件同層。 - 三份 manifest 一起升版，避免不同 CLI 讀到不同版號。 ## 測試結果 - `sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/sdlc`：退出碼 0，輸出「行為清單檢查通過：/root/plugins/sdlc/references/behaviors.md 對上 4 支技能，五個欄位齊全」。 - `git -C /root/plugins/sdlc diff`：退出碼 0，差異只有三份 manifest 的 `version` 欄位由 0.2.6 改成 0.2.7，沒有其他欄位變動。 - `git -C /root/plugins/sdlc status --porcelain`：三份 manifest 標為 `M`，`references/behaviors.md` 標為 `??`，沒有其他待提交檔案。 - 本次只改文件與版號，沒有可執行的程式碼異動，因此沒有另外跑單元測試。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:49:33 +00:00

docs(behaviors): 新增四支技能的行為清單 4b482aefc5

What：
- 在既有的 `references/` 目錄下新增 `references/behaviors.md`。
- 分成 analyze、implement、maintain、plan 四節，對上 `skills/` 下的四支技能。
- 每節一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。

Why：
- 技能驗證需要一份共同的參考基準。
- 基準留在文件裡，驗證就不必靠人腦記憶技能該有的行為。
- 清單放在技能自己的存取庫，技能改動與清單才會落在同一個 PR。
- 同一個 PR 就不會漂移，也不用跨存取庫開兩條 PR 互卡。

How：
- 逐支技能讀 SKILL.md，抽出行為填進五列表。
- 稽核時修正三列：analyze、plan、maintain 的階段鎖狀態檔原本寫成 `$JSC_HOME/wp/`。
- 三列改成實際路徑 `$JSC_HOME/sessions/{工作階段 id}.stage`。
- `$JSC_HOME/wp/` 只留給 implement 的工作包領取檔與 PR 鎖檔。
- 用 `sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/sdlc` 驗格式，退出碼 0。

Who：
- 使用 jsc-sdlc 四支技能的開發者。
- 執行技能驗證的 jsc-meta:skill-check。
- 日後異動這四支技能的維護者，要同步更新這一頁。

chore(version): 三份 manifest 同步升版到 0.2.7 7127d7d932

What：
- `.claude-plugin/plugin.json` 版本從 0.2.6 改成 0.2.7。
- `.codex-plugin/plugin.json` 版本從 0.2.6 改成 0.2.7。
- `plugin.json` 版本從 0.2.6 改成 0.2.7。

Why：
- 本次新增行為清單，屬於外部可見的異動，要升一版。
- 三份 manifest 服務不同的 CLI，版本必須一致。
- 版本一致，版本守衛才判得出這台機器該不該更新。

How：
- 只動三份檔案的 `version` 欄位，其他欄位一個位元組都沒改。
- 版號依既有規則進位一個修訂號。

Who：
- 安裝或更新 jsc-sdlc 外掛的使用者。
- 比對外掛版本的 jsc-hooks 版本守衛與 jsc-cli:deploy。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 列出 analyze、implement、maintain、plan 四支技能的行為清單

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

jiantw83 referenced this pull request

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

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

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

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

jiantw83 merged commit 58a23769f0 into feat/skill-behaviors-and-version-block/main

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

Sign in to join this conversation.