plugins/sdlc
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
132 Commits 9 Branches 0 Tags
develop
Commit Graph
132 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
admin b6aa8e09a2 Merge pull request '修正 wp-gate.sh check-deps 的 awk 欄位切析錯誤，讓相依關卡能正確攔下未合併相依的工作包' (#62) from fix/wp-gate-check-deps-field-index into develop 
Reviewed-on: #62
 2026-09-08 02:12:26 +00:00
jiantw83andClaude Sonnet 5 59c198fb06 fix(sdlc): 修正 wp-gate check-deps 相依欄位解析錯位問題 
原本 awk -F'|' 固定用第 6 欄當相依欄，但表格每列開頭多一個空欄，實際相依欄是第 7 欄，
導致每個候選工作包都被誤判成無相依可直接挑選，相依關卡形同虛設。同時 PR／狀態欄改用
從結尾往回數，避免層 0 多一欄「工作證」時與層 1 到 4 的表格欄位對不齊；並在切欄前先
處理儲存格內跳脫的字面 |，避免該列後續欄位整批錯位。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-08 10:07:33 +08:00
admin 24f4d5e4a7 Merge pull request '五個階段目錄頁範本改成大標題加條列，四支技能的讀寫敘述同步' (#60) from feat/contents-list/main into develop 
Reviewed-on: #60
 2026-09-02 10:00:55 +00:00
jiantw83 3230d7c49d chore(manifest): 三份 plugin 資訊檔的版本號提升一階 
What
- `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的版本號同步提升一個修訂號。

Why
- 本輪改了五個範本與四支技能的內文，安裝端要靠版本號才判得出手上的快取是舊的。
- 三份資訊檔的版本號必須一致，任一份沒跟上，不同 CLI 會各自認到不同版本。

How
- 三份檔案只動版本號那一個欄位，其餘內容不變。

Who
- 各支 CLI 的安裝與更新流程，以及版本守門檢查。
 2026-09-02 17:21:10 +08:00
jiantw83 b7b1d8bb01 docs(skills): 四支階段技能的目錄頁讀取與寫入敘述同步條列版面 
What
- `skills/plan`、`skills/analyze`、`skills/implement`、`skills/maintain`：目錄頁的讀取敘述改成從 H2 區塊取值，寫入敘述從「單列 upsert」改成單一 H2 區塊 upsert，鍵補上內容頁頁名這個引數，並註明第四個引數是區塊檔。
- `skills/maintain`：讀寫的鍵改成該存取庫的 `{owner}/{repo}`，因為這個型別沒有內容頁。
- `references/behaviors.md`：四支技能的關鍵步驟、外部呼叫與可驗證跡象同步，跡象從「留下那一列」改成留下那一個 H2 區塊。
- `references/consensus.md`：查已答問題那一條補上問答目錄頁也是條列式版面、要從區塊取值而不是表格列。
- `references/stage-report.md`：目錄頁也算寫入那一段補上「改動一個區塊也算寫過那一頁」，並統一用 `CONTENTS` 這個型別餵進去。
- `README.md`：四支技能的流程敘述與 wiki 規則段同步，並補上五個目錄頁的版面規則、鍵的落點與各頁鍵欄的正確序號。

Why
- 範本已經改成條列版面，技能內文還寫著「那一列」，執行時就會照舊敘述組出表格列，跟工具的單一區塊 upsert 對不上。
- 讀取端的敘述沒跟著改，技能會拿表格的解析方式去讀一頁條列，既有紀錄一筆都認不出來。
- 呼叫少帶鍵這個引數，工具無從判斷要換掉哪一個區塊，同一筆會被當成新的附加上去。
- 行為清單是稽核與驗證的比對基準，敘述沒跟上，稽核會拿舊描述判合規。

How
- 四支技能的呼叫一律寫成 `wiki-contents.sh upsert {TYPE} {鍵欄} "{鍵}" {區塊檔} [{範本}]`，各頁的鍵欄序號照線上那一頁實際的欄位排法寫定。
- 完成條件與可驗證跡象改用區塊的說法，連結範例改成 `- {欄位名}：[{頁名}]({連結})` 的形態。
- 只改敘述與說明，不動任何腳本；轉檔與 upsert 的實作在別的存取庫。

Who
- 本存取庫四支階段技能，以及讀這幾份說明檔決定共識判定與階段回報寫法的流程。
- 稽核與驗證流程改拿新的行為清單比對。
 2026-09-02 17:21:10 +08:00
jiantw83 19d918f499 docs(templates): 五個目錄頁範本改成大標題加條列 
What
- `templates/plan-contents.md`、`templates/analyze-contents.md`、`templates/repo-contents.md`、`templates/deliver-contents.md`、`templates/maintain-contents.md` 的版面從 markdown 表格改成一筆一個 H2 區塊，欄位改成標題底下的一層條列。
- 四個有內容頁的型別，H2 標題寫成該筆對應內容頁的實際頁名；`MAINTAIN` 沒有內容頁，標題改用該存取庫的 `{owner}/{repo}`。
- 各範本的引言補上版面段，並把寫入語意從「單列 upsert」改寫成單一區塊 upsert，末端的示範資料改成一個完整的 H2 區塊。
- 引言裡寫明鍵欄的語意與各頁的正確序號，並點出填錯的靜默後果。

Why
- 目錄頁是全部使用者共用的索引。表格一寬就得橫向捲、欄位一多就對不上表頭，而且併行寫入時只要有人少打一根豎線，整張表就散掉，別人那一筆跟著看不見。
- 條列式一筆一個區塊，寫入端只換自己那一塊，壞掉也只壞自己那一塊。
- `MAINTAIN` 整個型別只有目錄頁，硬套內容頁頁名當標題會指向一個不存在的頁；存取庫名不會漂移，當鍵一樣穩。
- 鍵欄填錯時工具不會報錯，既有那一筆會被當成新的附加到頁尾，同一筆變兩個區塊，舊區塊從此再也更新不到，所以範本要把序號寫死。

How
- 一頁固定三段：H1 頁名、`>` 引言、然後每一筆一個 H2 區塊；欄位格式 `- {欄位名}：{值}`，全形冒號，順序照原本的欄位從左到右，鍵那一欄照樣留一條。
- 寫入示例統一成 `wiki-contents.sh upsert {TYPE} {鍵欄} "{鍵}" {區塊檔} [{本範本}]`，並註明第四個引數是整個 H2 區塊的 markdown，不是列檔。
- 頁上不留任何 markdown 表格；內容頁範本不在本輪範圍，維持圖表優先。

Who
- 影響照這五個範本寫目錄頁的四支階段技能。
- 舊表格頁的自動轉檔與單一區塊 upsert 的實作不在本存取庫，本存取庫只提供範本與敘述。
 2026-09-02 17:21:10 +08:00
admin 5ee9f50fb6 Merge pull request '收尾寫一筆 skill-end 事件，執行狀態才回報得到助理' (#59) from feat/status-report into develop 
Reviewed-on: #59
 2026-09-02 08:04:15 +00:00
jiantw83 109a53466c chore(plugin 版本): 三份 manifest 升版至 0.3.1 2026-09-02 16:01:18 +08:00
jiantw83 f38d1f3087 feat(狀態回報): 收尾寫一筆 skill-end 事件 
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
 2026-09-02 16:01:18 +08:00
admin 0191e7ba8e Merge pull request '連結一律寫成 [文字](絕對網址)，並在寫入前驗證連得到' (#58) from feat/link-verification/main into develop 
Reviewed-on: #58
 2026-09-02 06:46:24 +00:00
jiantw83 4697bf433f chore(plugin 版本): 三份 manifest 升版至 0.3.0 2026-09-02 14:27:18 +08:00
jiantw83 f4e489ceb4 feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
 2026-09-02 14:27:18 +08:00
admin fc4e4a00e2 Merge pull request 'feat(wiki): 五個目錄頁改走專用存取庫，補齊 wiki-url 退出碼分流' (#56) from feat/wiki-contents-repo/main into develop 
Reviewed-on: #56
 2026-09-02 03:28:09 +00:00
jiantw83 9e71474bfb feat(wiki): 五個目錄頁改走專用存取庫，補齊 wiki-url 退出碼分流 
What：PLAN、ANALYZE、DELIVER、MAINTAIN、REPO 五個目錄頁改由 wiki-repo CONTENTS
解析並透過 wiki-contents.sh upsert 寫入，內容頁仍各走自己的型別。MAINTAIN 只有
目錄頁，整個型別都在專用存取庫。

Why：目錄頁與內容頁不再同庫，跨庫沒有 wiki 連結語法可用，一律改 wiki-url 的絕對
網址。原本四處取網址都沒有退出碼分流，5 被讀成空字串就寫出空連結，7 被讀成 4 就
把活著的頁當成沒寫成。

How：plan 與 analyze 會上階段鎖，而寫入閘門只看鎖不看路徑，所以流程要產的列檔與
暫存檔會被自己的閘門擋掉。兩支的限制段明寫這些檔一律用 heredoc 或 mktemp 產出。
wp-gate.sh 讀的是分析內容頁，維持走 ANALYZE，原地註明不得改成 CONTENTS。

Who：jsc-sdlc
 2026-09-02 11:02:34 +08:00
admin d7b3684bb4 Merge pull request '放行 jsc-assist 的 marketplace 條目到預設分支' (#54) from chore/marketplace-assist-registry/main into develop 
Reviewed-on: #54
 2026-09-01 04:55:40 +00:00
admin fa92fc010c Merge pull request 'chore/marketplace-assist-registry/sync-copies' (#53) from chore/marketplace-assist-registry/sync-copies into chore/marketplace-assist-registry/main 
Reviewed-on: #53
 2026-09-01 04:53:56 +00:00
jiantw83 41982760d4 chore(marketplace): 把 jsc-assist 登錄進統一 marketplace 
What：
- 兩份 marketplace 檔各加一個 jsc-assist 條目，來源網址指向 assist 存放庫。

Why：
- 準則要求每個 domain 存放庫都帶同一份 marketplace 檔，任何一個存放庫都能當註冊入口。副本之間只要有一份沒跟上，稽核就會報出不一致。
- 正本少了這個條目，各 CLI 的安裝指令就找不到 jsc-assist，這個 domain 等於發佈不出去。

How：
- 條目由 meta 的 sync-marketplace.sh 產生，同時寫進正本與每個 domain 存放庫的副本，寫完逐檔比對位元組。這一支存放庫的兩份副本就是那一輪的產物。
- 條目依名稱排序，縮排與非 ASCII 描述的處理都交給同一支腳本，不手改 JSON。
- 這一批是從最新的預設分支重新產生的。前一輪的分支基底早於監控頁型別那批改動，直接合併會把那些改動回退掉，所以整批重做而不是解衝突。

Who：
助理 domain 落地的註冊步驟在這個存放庫的同步。
 2026-09-01 12:50:04 +08:00
jiantw83 d4b1878967 Merge pull request '收攏 maintain 技能的 frontmatter 語法修正' (#50) from feat/cli-hook-rewire/main into develop 2026-09-01 00:58:44 +00:00
jiantw83 591263a2af Merge pull request '修正 maintain 技能 SKILL.md frontmatter 的 YAML 純量語法' (#49) from feat/cli-hook-rewire/quote-description into feat/cli-hook-rewire/main 2026-09-01 00:56:13 +00:00
jiantw83 c7d9777d04 fix(frontmatter): 修正 maintain 技能 SKILL.md frontmatter 的 YAML 純量語法錯誤 
What：
- 修正 skills/maintain/SKILL.md frontmatter 裡 description 欄位的 YAML 語法錯誤。
- 整串 description 加上單引號，內部撇號改寫成兩個單引號，內容文字一個字都沒變。
- 同步更新 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三個 manifest 版本號，從 0.2.7 進到 0.2.8。

Why：
- description 內含「冒號加空白」，屬於未加引號的 YAML plain scalar，違反 YAML 語法規定。
- Antigravity 解析 frontmatter 時當場中斷，整支技能被靜默丟棄，沒有任何錯誤訊息；磁碟上 34 支技能，Antigravity 只認得 28 支。
- 準則要求 description 用英文撰寫，不能把「: 」改成全形冒號迴避語法問題，只能加引號修正。

How：
- 整串 description 值加上單引號，內部撇號寫成兩個單引號跳脫，其餘字元不動。
- 用 git show HEAD: 取出改前的原始值，把改後的單引號純量還原後做字串相等比對，確認逐字相同、字元數一致。
- 執行 ste100-lint.sh、check-behaviors.sh、lint-frontmatter.sh 三支檢查腳本，退出碼皆為 0；git diff --numstat 顯示只動了 frontmatter 那一行。

Who：
- 本次修到 sdlc 技能組的 maintain 技能，屬 SDLC 維運階段、定期維護已交付專案的功能。
 2026-08-31 19:04:17 +08:00
jiantw83 e0e857b84a Merge pull request '收攏 sdlc 四支技能的行為清單，功能主幹併回 develop' (#47) from feat/skill-behaviors-and-version-block/main into develop 2026-08-31 08:10:41 +00:00
jiantw83 58a23769f0 Merge pull request '列出 analyze、implement、maintain、plan 四支技能的行為清單' (#46) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main 2026-08-31 08:09:28 +00:00
jiantw83 7127d7d932 chore(version): 三份 manifest 同步升版到 0.2.7 
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。
 2026-08-31 13:49:26 +08:00
jiantw83 4b482aefc5 docs(behaviors): 新增四支技能的行為清單 
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。
- 日後異動這四支技能的維護者，要同步更新這一頁。
 2026-08-31 13:49:26 +08:00
admin 3713fde61e Merge pull request 'fix/skill-check-compliance-and-flow' (#44) from fix/skill-check-compliance-and-flow into develop 
Reviewed-on: #44
 2026-08-31 03:33:43 +00:00
jiantw83 dfe4ed03ca chore(deps): 補上維護階段實際用到的相依外掛 
維護階段的候選方法直接呼叫 jsc-pkg 更新套件，相依清單卻沒有列它。裝了本外掛不一定裝得到，跑到那一步才失敗。

- 三份外掛描述檔都補上 jsc-pkg。
- 提高 jsc-hooks 的版本下限。本次流程倚賴的寫入閘門與留言掃描要新版才有。
- 同步調高本外掛版本。
 2026-08-31 11:10:30 +08:00
jiantw83 0bb00d2fb9 docs(sdlc): 說明同步實際流程 
說明跟腳本、技能的實際行為對不上，讀的人會照舊做法走。

- 工作包閘門腳本的檔頭補上上鎖的工作包參數。不帶就沒有歸屬，歸屬比對對誰都放行。
- 腳本用法數量改成正確的五個。
- 四段技能摘要改寫成現在的流程：閘門與停止條件先跑、互不相依的動作併發、寫入閘門只有 claude 擋得住、認可前的留言掃描是其餘四支 CLI 唯一來得及的一道。
 2026-08-31 11:10:30 +08:00
jiantw83 015ceb66d2 perf(sdlc): 停止條件與閘門移到最前面 
過去先問來源分支、先產生工作證、先建 worktree，等跑到閘門才發現沒有可挑的項目。前面的決策樹、wiki 寫入、抓取遠端與改名全部白做。

- 實作先讀分析頁、先結清已開 PR 的留言，再逐一過相依閘門，只有通過的候選才進選項。來源分支與工作證都移到領到工作包之後。
- 分析先併行讀計畫與分析目錄，沒有可分析的計畫就直接停。分支隨計畫而變，所以等目標定了才問。
- 互不相依的呼叫改成併發：已開 PR 的狀態批次預取、每個候選的相依查詢同時發、多個存取庫的 worktree 一起建、兩道收尾稽核並列跑。
- 領取登錄不成功就不得開工。沒有登錄，存取庫就沒有歸屬紀錄，之後每一支 PR 都會被當成無人認領而放行。上鎖失敗同樣要停，否則下一個工作階段會在 PR 還沒合併時就被放行。
- 來源分支改成單鍵確認。放棄的是每輪都要使用者明講「來源分支同時是 PR 目標」這道確認；分析頁沒記錄、遠端找不到分支這兩種例外仍走完整決策樹。
- 把仍寫成中文的驗收計畫步驟改回英文，與其他步驟一致。
 2026-08-31 11:10:30 +08:00
jiantw83 39a7e17b85 feat(contents): 目錄頁改為先讀回再附加 
目錄頁的每一列都屬於別人的計畫、工作包或存取庫。過去照範本整頁覆寫，別人的列會直接消失，而且寫入不做合併，也沒有備份。

- 五份目錄範本都寫明寫入語意：先讀回整頁，已有的列就更新，沒有才附加。
- 規劃與維護技能加上讀取結束碼分支表。只有「頁面真的不存在」才准照範本建頁；金鑰失效或 API 失敗一律停下來回報，不得當成沒有頁面。
- wiki 讀或寫失敗就停止該階段，並指出是哪一頁、哪一個動作失敗，避免把沒存成功的頁面報成已存。
- 補上寫入閘門只有 claude 擋得住的事實，其餘四支 CLI 只能靠內文約束。
- 記下工作包閘門對規劃階段降為提醒後放棄的在製品上限。
- 維護階段先整批對齊各專案再逐一交給 sub agent，專案之間互不相依。
 2026-08-31 11:10:30 +08:00
jiantw83 de7962a8c1 fix(gate): 閘門說明與實際行為對齊 
兩份參考文件跟實際判定互相矛盾。照著做會漏掉收尾，或是擋錯階段。

- 模型閘門非零退出時，該回合仍要跑階段回報。提前停下來也要留紀錄，不然使用者看不到停在哪裡。
- 工作包閘門只擋分析與維護：規劃只印提醒就放行，實作一律放行。實作是結清那支 PR 的唯一路徑，擋了閘門就自己鎖死。
- 順帶把指向實作技能的步驟引用改成新的順序。
 2026-08-31 11:10:30 +08:00
admin 0d8fa4c7e2 Merge pull request 'feat(analyze): 依使用者故事產生 TDD 驗收計畫' (#42) from feat/analysis/tdd-test-plan into develop 
Reviewed-on: #42
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-28 08:14:35 +00:00
jiantw83 19d873d19a fix(analyze): 讓測試計畫符合 TDD 循環 2026-08-28 16:10:20 +08:00
jiantw83 7804247dd9 feat(analyze): 依使用者故事產生驗收計畫 2026-08-28 16:07:45 +08:00
admin bd06a73269 Merge pull request 'feat(analyze): 明確產生 TDD 測試計畫' (#41) from feat/analysis/tdd-test-plan into develop 
Reviewed-on: #41
 2026-08-28 08:07:22 +00:00
jiantw83 309fe905a9 feat(analyze): 明確產生 TDD 測試計畫 2026-08-28 16:03:00 +08:00
admin 65b080a697 Merge pull request 'feat/plugin-dependencies/main' (#39) from feat/plugin-dependencies/main into develop 
Reviewed-on: #39
 2026-08-28 04:05:19 +00:00
admin 4341cb0780 Merge pull request 'feat/plugin-dependencies/declare-requires' (#38) from feat/plugin-dependencies/declare-requires into feat/plugin-dependencies/main 
Reviewed-on: #38
 2026-08-28 04:03:21 +00:00
jiantw83 b45958ed25 feat(manifest): 宣告 sdlc 技能相依版本 2026-08-28 11:59:16 +08:00
admin 9b64282f72 Merge pull request 'feat/change-requests/main' (#36) from feat/change-requests/main into develop 
Reviewed-on: #36
 2026-08-28 01:51:09 +00:00
admin 2803eb1326 Merge pull request 'feat/change-requests/sdlc-pr-flow-and-wp-gate' (#35) from feat/change-requests/sdlc-pr-flow-and-wp-gate into feat/change-requests/main 
Reviewed-on: #35
 2026-08-28 01:46:51 +00:00
jiantw83 8381f334a1 fix(implement): 明確指定分析頁檢查工作包相依 2026-08-28 09:30:08 +08:00
admin 7d8a8d527d Merge pull request 'feat(sdlc): implement 收尾改成程式碼審查與 API 文件稽核兩關並列' (#33) from feat/api-doc-audit/main into develop 
Reviewed-on: #33
 2026-08-27 08:54:32 +00:00
admin ac3c4e3aa2 Merge pull request 'feat(sdlc): implement 收尾新增 API 文件稽核，與程式碼審查並列' (#32) from feat/api-doc-audit/implement-api-doc-gate into feat/api-doc-audit/main 
Reviewed-on: #32
 2026-08-27 07:45:22 +00:00
jiantw83 39c087b31f chore(manifest): 三份 manifest 同步升版至 0.2.0 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份
manifest 的 version 由 0.1.9 改為 0.2.0。

Why：implement 的收尾多了一關 API 文件稽核，是使用者看得到的流程異動，次版號
要跟著進。版本沒跟著升，各 CLI 端的外掛版本護欄就分不出新舊，已安裝的使用者
也收不到更新。

How：三份 manifest 只改 version 欄位，其餘欄位維持原樣，三處版本號保持一致。

Who：jsc-sdlc 外掛的安裝與更新流程。
 2026-08-27 15:41:38 +08:00
jiantw83 981cda6adf docs(sdlc): README 同步兩關收尾稽核與 jsc-review 的分工 
What：README.md 的 implement 摘要，把原本一句「程式碼審查」換成兩關並列的收尾
稽核，寫明偵測、呼叫、跳過三條路徑與各自的退出碼；相關 domain 一節的 jsc-review
說明同步改成兩關，並註明專案支不支援 Swagger 由 swagger-detect.sh 判定、稽核
項目只寫在該技能。

Why：README 是使用者查一支技能做什麼的入口。技能正文改了流程，README 還停在
只有程式碼審查那版，讀的人會以為 API 文件稽核不存在，或以為那是另一支技能自己
的事。

How：只改 implement 摘要那一段的收尾環節，以及相關 domain 的那一行，其餘流程
敘述維持原樣。稽核項目在這裡一樣不重複列，指向 jsc-review:api-doc，避免同一份
判準散在三個檔案裡。

Who：jsc-sdlc 的存取庫說明文件。
 2026-08-27 15:41:38 +08:00
jiantw83 9b48d16422 feat(implement): 收尾改成程式碼審查與 API 文件稽核兩關並列 
What：skills/implement/SKILL.md 第 10 步改寫。原本只呼叫 code-review，現在拆成
並列的兩關：10.1 程式碼審查維持原判準，10.2 新增 API 文件稽核——先跑
jsc-review/tools/swagger-detect.sh，退出碼 0 就呼叫 jsc-review:api-doc，1 就
明確跳過並回報，2 就修好參數或路徑重跑。技能的 description 同步改寫。

Why：支援 Swagger 的專案，控制器文件沒補全就等於工作包沒做完。兩關並列而不是
一關套一關，是因為程式碼審查過了不代表 API 文件補齊了，反過來也一樣，任何一關
沒過工作包都不算完成。跳過一定要講出來：沒回報的跳過跟忘記做分不出來。退出碼
2 是偵測不出結果，既不算通過也不算跳過，硬當跳過會讓真的支援 Swagger 的專案
漏掉稽核。

How：改寫刻意只動第 10 步內部，用 10.1、10.2 子項編號，1 到 14 的頂層編號一個
都不動——references/deliver-formats.md 指的「步驟 7」、references/branch.md 指的
「步驟 4 與步驟 11」都還指得到原來的位置。稽核項目不抄一份過來，只寫「看
jsc-review:api-doc」，判準改動時不必兩邊同步。兩關的失敗都是修，不是放行：每一
輪修正都以 sub agent 在同一個 worktree 內進行，修完再稽核一次。

Who：jsc-sdlc 的 implement 技能，工作包的收尾稽核。
 2026-08-27 15:41:38 +08:00
jiantw83 30c66dd1fd Merge pull request 'feat(sdlc): 工作包隔離、留言先取共識、盯 PR 到合併與每任務一筆日誌' (#30) from feat/sdlc-flow-rules/main into develop 2026-08-27 03:39:41 +00:00
admin ce8f2eb9af Merge pull request 'feat(sdlc): 工作包隔離、留言取得共識後再修、盯 PR 到合併與每任務一筆日誌' (#29) from feat/sdlc-flow-rules/implement-worklog-and-pr-watch into feat/sdlc-flow-rules/main 
Reviewed-on: #29
 2026-08-27 03:26:33 +00:00
jiantw83 fd433d5152 chore(manifest): 三份 manifest 版本升到 0.1.9 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.8 改為 0.1.9。

Why：本次為 `wp-gate.sh` 新增兩個子命令，並改了 `implement` 與 `maintain` 兩支技能的步驟，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。

How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。

Who：`jsc-sdlc` 外掛的套件描述檔。
 2026-08-27 11:20:30 +08:00
jiantw83 77e7504982 docs(sdlc): 參考文件與 README 同步階梯、工作包隔離與日誌粒度 
What：`references/branch.md` 新增「分支階梯與 base 推導」一節（只寫拿到 `jsc-git/tools/base-branch.sh --derive` 回應之後要做什麼）與「工作包隔離」一節（歸屬依據、狀態檔欄位、誰寫誰讀、查無歸屬放行、逃生門），閘門分工那一表補上 `claim`、`lock`、`owns`。`references/stage-report.md` 改寫暫存那一節，講明本節只適用於「還沒完成任何任務就停下」的階段。README 的工具表、`implement` 與 `maintain` 兩段說明、參考文件表與相依技能清單同步更新。

Why：階梯表與歸屬狀態檔的正本各有其處——階梯在 `jsc-meta` 的 `references/guidelines.md`，狀態檔格式在 `jsc-hooks`。抄第二份就會有兩份互相打架的規則，但完全不提又會讓實作階段不知道拿到 `7` 或「已建立功能主幹」時該做什麼。

How：兩節都只寫本階段要做的事，並把唯一來源用連結指出去。`branch.md` 的階梯那一節寫成一張「腳本回應 → 這個階段要做的事」對照表，`7` 明寫成「中止並問使用者，不退回 `develop`」。`stage-report.md` 補一句「暫存不等於已寫入」，因為日誌改成一個任務一筆之後，做完事情的階段本來就有日誌可連。

Who：讀 `jsc-sdlc` 參考文件與 README 的人，以及跑實作與維護兩階段的工作階段。
 2026-08-27 11:20:30 +08:00