Skip to content

feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480

Closed

Description

@kiki830621

Problem

Original text:
「這後面會出high,所以代表前面的設計其實不夠完全, 我希望idd過程中部管有沒有走spectra都必須要更新規格吧,所以這編需要深度整合。」
— Source: 維護者,2026-11-10,討論 #478 的 verify 停止條件時。「後面會出 high」指 #405 與 #351:某一輪 verify 沒有 HIGH,之後的輪次又找到 HIGH(表在 #423 的留言)

維護者的要求:IDD 處理的每一張 issue,不論 diagnose 分到 Simple、Plan 還是 Spectra,過程中都要更新規格。做法是跟 Spectra 深度整合。

Type

feature

Expected

  • 每一張 issue 改變或確定下來的行為,都寫進規格,不論走哪個 tier。
  • 規格的寫入跟 Spectra 深度整合。

Claude 的解讀(依本 repo 的開發規則「深度整合優先於自己另寫一套」):用 Spectra 既有的 spec delta 與 archive 機制寫進 openspec/specs/,IDD 不自己另外維護一份規格格式。

Actual

跟 verify 的關係

維護者的推論:沒有 HIGH 的一輪之後又出現 HIGH,代表先前的設計不完整。verify 的停止條件與怎麼接近它,在 #423 討論;這張負責的是讓每一張 issue 都留下規格,使找到過的 HIGH 不再出現。

相關 issue

Impact

idd-diagnose 的分流、idd-implement 與 idd-close 的步驟、Simple tier 的成本(每張多一段規格)、與 Spectra 的依賴關係。

Clarity Surface(idd-clarify run 2026-11-10T05:56:46Z)

Type Source Question for you Status
ambiguity 「都必須要更新規格」 不改變行為的 issue(錯字、純文件)也要寫一條規格嗎,還是記一句「不改變行為」就可以? resolved @ 2026-11-10T06:07:04Z (reason: 維護者 2026-11-10:「或許需要audit」。解讀為「不改變行為」要經過一道 audit 才成立,不能自己宣告;用哪一種 audit 待診斷)
ambiguity 「規格」 規格只要文字的 requirement,還是每一條都要附一個可執行的檢查(測試或判定表)? resolved @ 2026-11-10T06:17:50Z (reason: 維護者 2026-11-10:「每一條都要附可執行的檢查 是不是會更好」。方向:每條 requirement 附可執行的檢查;寫不出檢查的要明寫並受審)
ambiguity 「深度整合」 每張都走完整的 Spectra change,還是另外做一條只寫規格的輕量路徑? resolved @ 2026-11-10T05:56:46Z (reason: 維護者 2026-11-10:簡單的也走 spectra propose 與 apply,只是更快;原話「我在想是不是」)

Current Status

Phase: closed
Last updated: 2026-11-11 by idd-close(PR #490 合併為 2dc56ab,結案,以 4.0.0 發佈;closing summary)
Dashboard: #480 (comment)

Key Decisions

Scope Changes

Blocking

  • (none)

Tasks

  • 1.1 確認 feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 已經在 main,對 main 重新檢查這份 change:把 feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 改過的 idd-pr-hitl-modes 規格、idd-all 與 idd-verify 的 SKILL 跟這份 delta 對一次,有衝突先改 delta,並決定封存檢查接在 close stage 的哪一步。驗證:spectra validate spec-on-every-issue 通過;design 的 Risks「與 feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 的衝突」補上實際的差異。
  • 2.1 declared 子指令讀出宣告行:依 requirement「Every implemented issue leaves a spec change or a declared exemption」的 Example「reading the Spec line」先寫測試(測試檔帶標記 spec-example: spec-on-every-issue / reading the Spec line),確認失敗後再實作。驗證:bash plugins/issue-driven-dev/scripts/tests/spec-change/test.sh 裡 13 列各有一個檢查並通過;參數錯誤是 exit 64。
  • 2.2 archived 子指令回答宣告的 change 在某個 commit 上是否已封存:依 requirement「The change is archived on the branch before verify」的 Example「whether the declared changes are archived at a commit」先寫測試(帶對應標記),在暫存 repo 上建立與封存目錄後檢查。驗證:11 列各有一個檢查並通過;名稱只是另一個封存目錄的前綴時回 refuse;revision 不存在時回 error(exit 2)。
  • 2.3 links 子指令檢查新增與改到的 requirement:依 requirement「Added and modified requirements carry an executable check」的 Example「what the link check reports」先寫測試(帶對應標記)。驗證:15 列各有一個檢查並通過;不給 --base 是 exit 64;沒有改到的 requirement 不會被報。
  • 2.4 preflight 子指令決定能不能開始寫規格:依 requirement「A repository without Spectra stops and a third-party clone proceeds」的 Example「preflight by write access and Spectra state」先寫測試(帶對應標記);linked worktree 用真的 git worktree add 建出來測(design「linked worktree 先停下」),spectra 是否在 PATH 用測試專用的 PATH 控制。驗證:8 列各有一個檢查並通過。
  • 2.5 四個子指令的共同行為(design「機械判定集中在 scripts/spec-change.py」):非 git 目錄、解析不了的規格檔都回 error,不回 ok 或 pass;每個子指令只印一行 JSON。驗證:測試各一例;python3 -m py_compile 通過。
  • 2.6 規格目錄照 Spectra 的規則解析(requirement「The spec directory is resolved the way Spectra resolves it」;design「規格目錄照 Spectra 的規則解析」):依 Example「spec directory by .spectra.yaml」先寫測試(帶對應標記),archived、links、preflight 都改用解析出的目錄。驗證:scripts/tests/spec-change/test.sh 的 7 列各有一個檢查並通過,原有的檢查不變;用真的 spectra 在暫存 repo 建立、封存一個 change,links 與 archived 讀得到 docs/spectra/。
  • 3.1 references/spec-wrapper.md 寫出共用的契約:preflight、建立 change(design「每張 issue 一個 change,名稱是 idd-N-slug」)、輕量形式不做 discuss 與 design(design「Simple 用 spec-driven 的輕量形式,不 fork workflow」)、apply 時 Example 的測試先寫、收尾的順序(design「封存在 branch 上、verify 之前」)。驗證:內容審閱,契約的每一步都對得到一個 spec-change.py 子指令或一個 Spectra 指令,沒有留給執行者自行判斷的總括判準。
  • 3.2 idd-implement 成為 Simple 的 wrapper(requirement「Spec changes go through Spectra behind IDD wrappers」;design「wrapper 是 idd-implement 與 idd-plan,契約放在 references/spec-wrapper.md」):先跑 preflight,照契約 propose、apply、收尾;Implementation Complete 的模板加上標記與 **Spec**: 行(design「宣告寫在 Implementation Complete 留言的 Spec 行」);tree-lock 那一步寫明 linked worktree 會被 preflight 擋下。驗證:在暫存 repo 跑一張 Simple issue,branch 上有封存目錄與 openspec/specs/ 的改動,spec-change.py declared 讀留言得到 change,spec-change.py archived --ref HEAD 印 pass。(2026-11-11 暫存 repo 實跑:無人值守 /idd-all 的 Simple issue,branch 上有封存目錄與新的 docs/spectra/specs/word-count-script/spec.md,declared 讀到 change,archived --ref PR head 印 pass,links 印 ok)
  • [-] 3.3 idd-plan 成為 Plan 的 wrapper:attended 時 propose 之後在 plan mode 請人核准 proposal 與 tasks,核准後把 change 交給 idd-implement 做 apply 與收尾,idd-implement 不再 propose 一次。驗證:在暫存 repo 跑一張 attended 的 Plan issue,核准之前沒有任何程式檔被改,核准之後的結果與 3.2 相同。(依 2026-11-11 使用者決定只用契約測試驗收:spec-wrapper-contract 檢查 idd-plan 經 spectra-propose、核准 proposal 與 tasks、把 change 名稱交給 idd-implement;attended Plan 沒有實跑) — 被 idd-480-fix7 取代(2026-11-11 維護者決定縮小範圍,decision):idd-plan 只核准 Implementation Plan、不 propose,核准後由 idd-implement 以輕量形式 propose;在 plan mode 核准 proposal 本身是 [enhancement] idd-plan: approve the Spectra proposal itself in plan mode, bound to the files that are applied (follow-up from #480) #497
  • 3.4 idd-all 替 Spectra tier 做收尾:apply 之後跑 Spectra 的 verify、封存、commit、links,並貼出帶標記與 **Spec**: 行、沒有 ### Checklist 小節的 Implementation Complete。驗證:authoritative-source-producer 的測試加一例,確認有這種留言時 checklist 的來源仍是 Current Status > Tasks;在暫存 repo 跑一張 Spectra issue,archived --ref HEAD 印 pass。(2026-11-11 暫存 repo 實跑:無人值守 /idd-all 的 issue 判為 Spectra tier,apply 之後封存 idd-29-line-stats-json,Implementation Complete 有標記與 **Spec**: 行、沒有 ### Checklist 小節,archived --ref 該 head 印 pass;authoritative-source-producer 的測試已加這一例)
  • 3.5 兩種豁免的宣告:idd-implement 只在規格列的四種情況宣告 no behaviour change;第三方 clone 宣告 third-party clone,不建立 openspec/。驗證:在暫存 repo 跑一張只改 README 錯字的 issue,沒有 change 目錄,留言宣告 no behaviour change;preflight --can-write no 時 wrapper 照舊實作並宣告 third-party clone。(2026-11-11 暫存 repo 實跑:只改 README 一句的 issue,沒有 change 目錄,留言宣告 no behaviour change 並寫明是 (a);third-party 那一半由 spec-change 的 preflight 測試(--can-write no → third-party)與契約文字涵蓋,沒有在無寫入權的 repo 實跑)
  • [P] 4.1 idd-verify 拿規格對照行為(requirement「Reviewers check behaviour against the specs」):把 **Spec**: 行與範圍內改到的規格檔交給每個 reviewer,跑 links 與 archived,把缺漏列為 Blocking;Regression lens 的提示加上兩條 HIGH 的規則。驗證:在 3.2 的暫存 repo 上拿掉一個 Example 的測試標記後跑 verify,報告有一項 Blocking 指名那個 Example;把留言的宣告換成 no behaviour change 後再跑,報告有一項 HIGH。(2026-11-11 暫存 repo 實跑兩次 verify:拿掉 missing-file Example 的標記並加上規格沒寫的 -h,報告有一項 Blocking 指名該 Example、一項 HIGH 指出 -h 沒有 requirement;宣告改成 no behaviour change,報告有一項 HIGH 指出豁免不成立)
  • [P] 4.2 verify 之後的修正留下規格(requirement「A fix after a verify round goes through the same wrapper」;design「verify 之後的修正走同一個 wrapper」):idd-all 的修正迴圈與 idd-implement 在修正新增或修改 requirement 時建立 idd-<N>-fix<k>,並在新的留言列出這張 issue 的所有 change。驗證:在暫存 repo 讓一輪 verify 回報一項 Blocking,修正後 branch 多一個已封存的 idd-<N>-fix<k>,新留言的 **Spec**: 行有兩個名稱,archived --ref HEAD 印 pass。(2026-11-11 暫存 repo 實跑 idd-implement 那一半:4.1 那輪 verify 報出 Blocking 與 HIGH 之後的修正,branch 多了已封存的 idd-27-fix1(新增 Help flag requirement、改到兩條既有的),缺的標記補回;新留言的 **Spec**: 行列出兩個名稱,archived 印 pass,links 印 ok。idd-all 自動修正那一半也在 3.4 那次 run 實跑到:第 1 輪 verify 之後建出並封存 idd-29-line-stats-json-fix1,新留言列出兩個名稱,archived 印 pass。修正 run 撞到開工檢查把 verify 寫進 ### Blocking 的項目當成外部阻塞,那是 A verify FAIL writes its findings into ### Blocking, which the actionability gate then reads as an external blocker #445,不在這份 change)
  • [P] 4.3 idd-close 在關閉前檢查封存(requirement「Close requires the issue's change to be archived」):依 Example「the close gate reads the default branch」先寫測試(帶對應標記),再把檢查接進 idd-close 的 gate。驗證:5 列各有一個檢查並通過;在暫存 repo 上,合併前跑 close 會停下並指名 change,合併後通過。
  • [P] 5.1 文件與這份 change 一致:rules/sdd-integration.md 的流程與「Close triggers archive」改成 branch 上、verify 之前封存;idd-diagnose 的下一步說明、references/verify-profiles.md、references/usecase-routing.md、README、CHANGELOG(標明 BREAKING、linked worktree 的限制、在暫存 repo 量到的一張 Simple 多花的時間)。驗證:內容審閱,這幾份文件沒有任何一處還寫 Simple 不碰規格,或封存在 close 時做。(量到的時間寫在 CHANGELOG [Unreleased]:一次無人值守 Simple run,5 分鐘中約 3 分鐘花在 propose 與收尾)
  • 5.2 這份 change 自己符合新規則:六個 Example 都有帶標記的測試,其餘 requirement 有 No executable check: 行。驗證:spec-change.py links --base <開始實作的 commit> 印 ok;照新的收尾順序封存後 spec-change.py archived --ref HEAD 印 pass。(封存前在暫存 clone 跑過:links --base 03f5559 印 ok、archived --ref HEAD 印 pass;那次找到並修了分隔線的誤報(7a3fbc1)。正式封存的 commit 之後再跑一次,結果寫在 Implementation Complete)
  • [P] 5.3 開兩張後續的 issue([enhancement] 既有的 requirement 補上 Example 與帶標記的測試 (follow-up from #480) #487 補齊既有 requirement、[enhancement] 主工作樹被佔用時,要寫規格的 issue 改用獨立 clone 隔離 (follow-up from #480) #488 獨立 clone 隔離):補齊既有 requirement 的 Example 與檢查;把隔離用的工作樹改成獨立 clone,讓要寫規格的 issue 在主工作樹被鎖住時也能跑。驗證:兩張 issue 的號碼寫進 feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 的 closing summary。
  • 1.1 ic 子指令選出 Implementation Complete 留言(requirement「One way to choose the Implementation Complete comment」)。驗證:Example「choosing the Implementation Complete comment」八列各一個檢查,寫在 scripts/tests/spec-change/test.sh 並帶標記,先看到它們失敗。
  • 1.2 links 對解析不了的 requirement 標題、head 上 specs/ 沒有追蹤檔案回 error;標記只在標題之後只剩空白或註解結尾時才算(requirement「Added and modified requirements carry an executable check」)。驗證:Example「what the link check reports」新增的三列各一個檢查,先看到它們失敗。
  • 1.3 preflight 的 error 寫進規格(requirement「A repository without Spectra stops and a third-party clone proceeds」)。驗證:Example「preflight by write access and Spectra state」新增的那一列有檢查(非 git 目錄 → error、exit 2)。
  • 2.1 idd-close Step 1.57 以 gh api --paginate 取留言、以 ic 選留言,取不到就停下(requirement「Close requires the issue's change to be archived」)。驗證:scripts/tests/spec-close-gate/test.sh 把 Step 1.57 的 bash 抽出來,用假的 gh 實跑三列:沒有 Implementation Complete → passes、取不到留言 → stops、最新的宣告未封存 → stops;先看到它們失敗。
  • 2.2 idd-verify 以 ic 選留言,No executable check: 的理由交給 reviewer 審(idd-verify 的 requirement「Reviewers check behaviour against the specs」)。驗證:spec-wrapper-contract 檢查規格對照那段呼叫 ic、審查規則寫到 No executable check:。
  • 2.3 idd-all Phase 3b:preflight 在檢查 Spectra 是否安裝之前;propose 的參數帶 Example、標題唯一、測試標記;自動修正處理被否決的 no behaviour change(requirement「Spec changes go through Spectra behind IDD wrappers」、「A fix after a verify round goes through the same wrapper」)。驗證:spec-wrapper-contract 檢查 Phase 3b 裡 preflight 的位置在 command -v spectra 之前、PROPOSE_ARGS 帶 spec-example:、修正規則寫到被否決的豁免。
  • 2.4 契約與文件:讀不到權限就停下,不當成第三方;被否決的豁免照第 3 到 5 步建第一個 change;linked worktree 對每一張 issue 都會停(idd-implement 的 tree-lock 說明、idd-all 的 batch 說明、CHANGELOG)。驗證:spec-wrapper-contract 檢查這三處文字。
  • 3.1 開一張 follow-up issue:legacy 宣告放行(無法分辨舊留言與漏寫)、宣告的 change 沒綁定到 issue、第 1 輪 verify 的 LOW。驗證:issue 號寫進 Implementation Complete。([enhancement] spec-on-every-issue: legacy comments pass every gate, declared changes are not tied to the issue, and round-1 LOW findings (follow-up from #480) #491)
  • 1.1 links:fence 照 CommonMark 判斷(同一種字元、長度不短於開頭、後面只有空白才關),fence 內的 ##### Example: 與 No executable check: 不算;同一個 capability 裡同名的 requirement 回 error(requirement「Added and modified requirements carry an executable check」)。驗證:Example「what the link check reports」新增的四列各一個檢查,先看到失敗。
  • 1.2 preflight:.spectra.yaml 讀不到回 error(exit 2,一行 JSON);spec_dir 以 - 開頭回 error,git ls-tree 加 --;不用 --path-format=absolute(git 2.31 以前沒有)(requirement「A repository without Spectra stops and a third-party clone proceeds」)。驗證:Example「preflight by write access and Spectra state」新增的那一列有檢查,先看到失敗。
  • 1.3 ic:marker 前有空白時也選得到(requirement「One way to choose the Implementation Complete comment」)。驗證:Example「choosing the Implementation Complete comment」新增的那一列有檢查,先看到失敗。
  • 2.1 preflight 呼叫:契約第 1 步與 idd-all Step 3b.0 對沒有輸出、不是 JSON、未知狀態一律停下;兩份從權限到 --can-write 的對應一致(requirement「Spec changes go through Spectra behind IDD wrappers」)。驗證:spec-wrapper-contract 用假的 gh 與不含 spectra 的 PATH 實跑兩份區塊,Example「the preflight call routes by permission and Spectra」六列各一個檢查,兩份結果相同。
  • 2.2 idd-close Step 1.57:gh repo view 或 git fetch 失敗回 error;--retroactive 的對照表把 Step 1.57 列為略過(requirement「Close requires the issue's change to be archived」)。驗證:spec-close-gate 實跑 Step 1.57 區塊,gh repo view 失敗與 fetch 失敗兩種都停下,先看到失敗。
  • 2.3 idd-verify:只在有 git 範圍時組規格對照;資料包在每次產生的 nonce fence 裡,fence 外是審查規則;DA 的後綴只在組了規格對照時加;verify-profiles.md 寫明不變的是 lens 組合與輸入偵測(idd-verify 的 requirement「Reviewers check behaviour against the specs」)。驗證:實跑規格對照那段:SHA 空時 SPEC_BLOCK 為空、DA 後綴不變;資料裡的 nonce 被中和。
  • 2.4 手動的 Spectra 路徑:idd-diagnose 的 hand-off 與 rules/sdd-integration.md 在 /spectra-discuss 之前跑 preflight;checklist 來源的規則寫進 wrapper 那條 requirement;docs/commands.md 不再說 close 之後才封存。驗證:spec-wrapper-contract 檢查這幾處文字。
  • 1.1 declared 與 requirements() 共用 CommonMark 的 fence 判斷,fence 不論縮排都算,換行只認 \n、\r\n、\r;標題前允許 0 到 3 格空白(requirement「Every implemented issue leaves a spec change or a declared exemption」、「Added and modified requirements carry an executable check」)。驗證:Example「reading the Spec line」新增兩列、「what the link check reports」新增兩列,各一個檢查,先看到失敗。
  • 1.2 .spectra.yaml 在 revision 上是目錄或 symlink 回 error;spec_dir 以 : 開頭回 error;git 一律用 literal pathspec;找不到 git 回 error(一行 JSON、exit 2);錯誤訊息裡的值截到 60 字(requirement「The spec directory is resolved the way Spectra resolves it」)。驗證:Example「spec directory by .spectra.yaml」新增兩列,以及找不到 git 的檢查,先看到失敗。
  • 2.1 idd-close Step 1.57:fetch 之後檢查 FETCH_HEAD;用 python 判斷宣告形式;結果表補「沒有輸出、不是 JSON、或狀態不在表上 → 停下」(requirement「Close requires the issue's change to be archived」)。驗證:spec-close-gate 實跑「遠端已撤銷封存、本機追蹤 ref 沒動」一列,先看到失敗。
  • 2.2 idd-verify:SPEC_FILES 只列主規格;改掉過時的說明(「不含別人的散文」、code profile「逐 byte 不變」的範圍);規格的 Example「the spec context the reviewers get」三列由 spec-wrapper-contract 實跑並帶標記(idd-verify 的 requirement「Reviewers check behaviour against the specs」)。驗證:三列各一個檢查。
  • 2.3 契約第 5 步的連結檢查:gh repo view、git fetch、git merge-base 任一失敗或 SPEC_BASE 為空就停下。驗證:spec-wrapper-contract 檢查這段文字。
  • 1.1 所有 git 呼叫帶 -c core.quotePath=false;spec_dir 依引號判斷註解;ic 接住 RecursionError(requirement「Added and modified requirements carry an executable check」、「The spec directory is resolved the way Spectra resolves it」、「One way to choose the Implementation Complete comment」)。驗證:中文 capability、引號內的 #、巢狀太深的 JSON 各一個檢查,先看到失敗。
  • 2.1 idd-implement Step 2.5 只略過 TaskList 的建立,分流表照常看;**Spec plan**: 行的三種形式寫進契約;idd-plan 在 Abort 時把它改成 rejected;契約第 3 步只在最新的 Implementation Plan 寫著 change <名稱> 時沿用既有的 change(requirement「Spec changes go through Spectra behind IDD wrappers」)。驗證:spec-wrapper-contract 檢查這幾處文字,先看到失敗。
  • 2.2 契約第 3、4 步的 bash 用假的 spectra 實跑,Example「contract steps 3 and 4 run as written」四列各一個檢查;preflight 的測試逐列驗「繼續或停下」(PF_RC)。驗證:先看到 unpark 與 PF_RC 的檢查失敗或缺席。
  • 2.3 idd-verify 的 SPEC_FILES 帶 -c core.quotePath=false。驗證:spec-wrapper-contract 檢查這段。
  • 2.4 spectra-verify 在封存前抓到的兩項 critical:spec-change.py plan 讀最新 Implementation Plan 的 **Spec plan**: 行(Example「reading the Spec plan line」九列);契約第 3 步以它判斷開著的 change,idd-implement 在 Step 2 貼任何留言之前就做這個檢查,Plan tier 直接呼叫時在 propose 之前問要不要改走 /idd-plan;idd-plan 寫四種形式,並在被拒絕之後再呈現同一個 change。驗證:spec-change 的 plan 九列與 spec-wrapper-contract 實跑第 3 步那段,先看到失敗。
  • 1.1 plan 認得 proposed (change <名稱>),標題比對限定 ## Implementation Plan 後接行尾、空白或 (;讀 git 路徑一律 NUL 分隔;install-spectra 的訊息寫 brew install --cask spectra-app 與正確網址(requirement「Spec changes go through Spectra behind IDD wrappers」、「Added and modified requirements carry an executable check」、「A repository without Spectra stops and a third-party clone proceeds」)。驗證:Example「reading the Spec plan line」新增兩列、「what the link check reports」新增 quo"te 一列,以及訊息的檢查,先看到失敗。
  • 2.1 契約第 3 步:檢查 spectra list 的結果,印一行判定(propose、go on with <名稱> 或停下並說明怎麼繼續);idd-plan 進 plan mode 前寫 proposed、核准後改 change、Abort 改 rejected;idd-implement 與修正輪在 propose 前寫 plan 行;直接呼叫的 Plan-tier 只在 Step 0.6 問一次。驗證:spec-wrapper-contract 以假的 spectra 與 gh 實跑第 3 步,Example「an open change is checked against the newest plan」七列各一個檢查,先看到失敗;文字檢查涵蓋三個 skill。
  • 2.2 idd-verify 的 SPEC_FILES 用 diff -z;preflight 測試對 idd-all 那份也斷言 PF_RC。驗證:spec-wrapper-contract 的檢查。
  • 2.3 Example「reading the Spec plan line」從 requirement「The spec directory is resolved the way Spectra resolves it」底下搬到 wrapper 那條(fix4 誤接),標題與標記不變。驗證:spec-change.py links 對 branch 印 ok,標題在 capability 裡仍唯一。
  • 2.4 封存前 spectra-verify 的 warning:idd-plan 是開著的 change 唯一的核准路徑,proposed、rejected、沒有 plan 點名、plan 點名別的 change 都由它重新呈現;契約不再說 plan 行一律在 propose 之前;spectra list 印出不是 JSON 時停下;idd-implement 對這些情況都指向 /idd-plan;idd-all 的修正輪先貼 plan 行;Step 2.5 那一格不再給出又取消的指示。驗證:spec-wrapper-contract 新增的檢查先看到失敗,Example「an open change is checked against the newest plan」新增「不是 JSON」一列並以假的 spectra 實跑。
  • 1.1 Step 3.5 的 bash 段(requirement「Plan-tier approval covers the change as it will be applied」):parked 就 unpark,讀 spectra instructions apply --json 的 changeDir,缺 proposal、tasks 或 spec delta 就停下,印出目錄與檔案;Step 4 附上這些檔案的原文;Revised 先改檔案、跑 spectra validate、重跑這一段再重新呈現;Aborted 先 park 回去。驗證:spec-wrapper-contract 以假的 spectra 實跑這一段,Example「the step-3.5 block」五列各一個檢查,加上 Revised、Aborted 與 Step 4 的文字檢查,先看到失敗。
  • 2.1 idd-implement 的說明不再說直接呼叫時「照舊先問」要不要改走 /idd-plan;契約第 3 步在 plan 點名別的 change(proposed 或 rejected)時,stop 訊息寫出兩個名稱。驗證:spec-wrapper-contract 的檢查先看到失敗。
  • 2.2 第 6 輪的 idd-all: direct-commit mode 加 passive warning (dirty tree / on default branch) #2、idd-all Phase 4: ${MAX_ROUND} substitution missing in abort message #4、idd-all Phase 0.5: fork detection 改 fail-closed (gh repo view 失敗時預設 PR mode) #5、idd-all SLUG derivation: BSD/GNU sed alternation (\| not portable) #6、idd-all Phase 0.2: GITHUB_REPO post-derive shape assertion #8、idd-issue Step 2: 強制 sanitize incoming title (length cap / strip control chars) #9、idd-all Examples: 跨 repo invocation 段重複描述,合併 #10 開成一張 follow-up issue。驗證:issue 號寫進 Implementation Complete。([enhancement] spec-on-every-issue: round-6 in-scope MEDIUM/LOW left after #480 (step-3 list shape, change names, IC_RE boundary, fix-round plan line) #496)
  • 1.1 plan 不再認 rejected (change <名稱> left parked),讀成 invalid(requirement「Spec changes go through Spectra behind IDD wrappers」)。驗證:Example「reading the Spec plan line」改過的兩列(Planning notes 那列改用 change、rejected 那列回 invalid exit 1)各一個檢查,先看到失敗。
  • 2.1 idd-plan 不 propose:要寫規格時 plan 行在進 plan mode 前寫 proposed (change idd-<N>-<slug>),核准後改 change <名稱>,已有開著的 change 時寫那個名稱,Step 6 交名稱給 idd-implement;拿掉 Step 3.5、Step 4 附檔案的說明、範本那一行、read_change_files;Revised、Aborted、Revise 說明回到 feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 之前。驗證:spec-wrapper-contract 檢查 idd-plan 沒有 Skill(skill="spectra-propose"、沒有 ### Step 3.5:、Step 6 交出名稱,先看到失敗。
  • 2.2 idd-implement 從 idd-plan 來時用核准的名稱以輕量形式 propose,change 已開著就直接用;Step 0.6 不提 rejected。契約第 3 步拿掉 rejected 那一支、「idd-plan 會先建好」與五種寫法的說法;Example「an open change is checked against the newest plan」拿掉 rejected 那一列。rules/sdd-integration.md、idd-diagnose 的 route 表、CHANGELOG 改成核准 Implementation Plan、propose 在 idd-implement。驗證:spec-wrapper-contract 的檢查先看到失敗;fix4 到 fix6 對 rejected、Step 3.5 的檢查改成相反的斷言或拿掉。
  • 2.3 第 6 輪 follow-up 留言(comment 6784058096)的去向用 idd-edit --correct 更正(第 7 輪 Complexity routing: vagueness 應該是一階信號,但目前 4 層 gate 都沒衡量需求清晰度 #12)。驗證:留言的 Follow-up 段列出 [enhancement] spec-on-every-issue: round-6 in-scope MEDIUM/LOW left after #480 (step-3 list shape, change names, IC_RE boundary, fix-round plan line) #496。
  • 2.4 封存前 spectra-verify 的 warning:README 不再說 idd-plan 呈現 proposal;spec-wrapper-contract/test.sh 只留一份(先前誤貼兩次);idd-plan 用 spectra list 找這張 issue 開著的 change(allowed-tools 加 Bash(spectra:*)),規格寫明它不跑第 3 步的檢查;Aborted 列不再說還沒有 change;Step 6 的範例帶 --spec-change,流程圖改成 idd-implement 在 Step 2 propose。驗證:spec-wrapper-contract 新增的檢查先看到失敗。

Commits

Activity

  1. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-10):
    「我在想是不是簡單的也還是要通過spectra propose跟apply,只是可以更快速」
    — 維護者

    決定

    方向(原話是「我在想是不是」,還不是定案):Simple 的 issue 也走 spectra propose 與 apply,用比較快的形式。不另外做一條只寫規格的路。

    Rationale

    Claude 的看法:贊成,理由三個。

    1. 只有一條路。規格由同一個機制產生,IDD 不必另外維護一套寫規格的做法。
    2. 規格在實作之前寫好,verify 有明確的對象可以對(feat: 判定性質的工具先寫可執行的判定表再實作;verify 審規格並偵測不收斂的修補迴圈 #423)。
    3. tier 不再決定有沒有規格,只決定手續多少。spectra-archive-post-ic:留言帶出本機絕對路徑且繞過 gh-egress;候選偵測誤收其他 repo 的編號 #405 一開始看起來簡單,後來要做兩次設計決定;分錯 tier 的代價會變小。

    Spectra 3.0.0 現有的支援(查過 CLI):

    • 預設 workflow spec-driven 是 proposal → specs → tasks,design 本來就是選用。
    • 另有 no-spec(proposal → tasks),也可以自訂 workflow(spectra schema init、fork)。

    所以「更快」可以用 Spectra 自己的設定做到:Simple 跳過 discuss 與 design,只留短的 proposal、一條 requirement 的 spec delta、幾項 task。

    要先處理的兩件事:

    1. 不改變行為的 issue(錯字、純文件)沒有 requirement 可寫。要有一個明寫的出口,例如記一句「不改變行為」或改用 no-spec;不然規格會被湊數的 requirement 塞滿。
    2. 每張都過 Spectra,會放大現有的 IDD 與 Spectra 接縫問題:idd-all Phase 3b:在 idd worktree 裡呼叫 spectra,change 落在主 checkout(.spectra.yaml worktree: true) #462(在 worktree 裡呼叫 spectra,change 落在主 checkout)、spectra-archive-post-ic:tasks.md 太長時貼不出 Implementation Complete (sister bug from #405) #475(tasks.md 太長時貼不出 Implementation Complete)、openspec change add-privacy-scrubbing-gate 未封存:privacy-scrubbing-gate spec 不在 openspec/specs、Phase 2 task 未勾 (sister concern from #421) #433(change 沒有封存)。這幾張要先修。

    Related

    #423、#462、#475、#433、#252、#478

  2. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-10):
    「1. 或許需要audit」
    — 維護者,回答 Clarity Surface 第 1 題(不改變行為的 issue 也要寫一條規格嗎,還是記一句「不改變行為」就可以)

    決定

    方向(原話是「或許」):「不改變行為」不能只由做的人自己宣告,要經過一道 audit。

    Rationale

    Claude 的解讀,診斷時確認:

    • 「不改變行為、所以不寫規格」是最容易被濫用的出口:想省事的時候,每一張都可以宣告自己不改變行為。audit 是用來擋這個的。
    • 這個 audit 不能只看檔案類型。在這個 repo,SKILL.md 與 rules 是 markdown,但它們就是行為。
    • Spectra 現有的 audit(.spectra.yaml 的 audit: true 與 spectra-audit)審的是 diff 裡的安全陷阱(危險的預設值、型別混淆、無聲失敗),不回答「這個改動有沒有改變行為」。比較接近的是 spectra drift 與 spectra-verify。所以這道 audit 用哪一個,或要不要新增一種,是這張要定的事。

    Related

    #423

  3. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-10):
    「你選比較適合的」
    — 維護者,針對「這道 audit 用 spectra drift、spectra-verify,還是新增一種」

    決定

    維護者交給 Claude 選。選擇:不新增 audit 的種類,也不用 spectra drift。兩個方向各用一個現成的:

    方向 問的問題 用什麼
    規格 → 程式 寫下的每一條 requirement 都做了嗎 spectra-verify,照現狀,封存前跑
    程式 → 規格 diff 裡有沒有哪個行為改動是沒有 requirement 涵蓋的 idd-verify 既有的 Regression lens,改成拿這張 issue 的 spec delta 當對照

    「不改變行為」的 issue 就是 spec delta 為空的情況:Regression lens 在 diff 裡找到任何行為改動,就是 HIGH。

    Rationale

    三個候選各自回答的問題(讀過 CLI 說明與 skill 內容):

    • spectra drift:計畫寫好之後,程式有沒有變到讓計畫過時(擱置時間、design 裡失效的參照、task 與外部 commit 相撞)。它問的是計畫,不是這次的改動。
    • spectra-verify:實作有沒有涵蓋 change 的 artifacts(task 完成、requirement 有實作、scenario 有測試)。只有規格 → 程式這個方向;沒有 spec delta 時只剩檢查 task 有沒有勾。
    • 這道 audit 要的是反方向。idd-verify 的 Regression lens 現在做的就是這件事(多做了什麼、有什麼副作用),只是它對照的是 issue 的文字,不是規格。

    選這個組合的理由:

    • 不多一個步驟,也不多一個 agent。每張 issue 本來就會跑 idd-verify。
    • 審的人不是做的人,「自己宣告不改變行為」這個出口就關掉了。
    • 判斷是讀內容,不看檔案類型,SKILL.md 這類 markdown 也審得到。
    • diff 可以用 spectra scope --change 取得(唯讀,輸出這個 change 的實作 patch),IDD 不必自己算。

    代價:這個檢查跟 Regression lens 的判斷一樣好,不是機械保證。

    Related

    #423

  4. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-10):
    「每一條都要附可執行的檢查 是不是會更好。」
    — 維護者,針對 Clarity Surface 第 2 題(規格只要文字,還是每一條都要附可執行的檢查)

    決定

    方向(原話是問句):每一條 requirement 都附一個可執行的檢查。Claude 的看法是贊成,加一條例外的處理方式,寫在下面。

    Rationale

    現況(2026-11-10,main):

    • 32 份規格、190 條 requirement、444 個 scenario,只有 20 個 Example(分布在 12 份規格)。
    • 70 個測試 suite 裡,只有 3 個提到規格路徑、Requirement 或 Scenario。測試不少,但從一條 requirement 找不到它的檢查,也答不出哪幾條沒有檢查。

    Spectra 已經有這個位置:規格裡的 Example(給定輸入與預期結果),spectra-verify 會檢查每個 Example 有沒有用同一組輸入的測試。規則可以寫成「每條 requirement 至少一個 Example,每個 Example 有一個測試」,不必另外發明格式。

    例外的處理(Claude 的建議):IDD 有很多行為寫在 SKILL.md 裡、由模型照著做(例如「這時要問使用者」)。這一類寫不出確定性的檢查。

    • 不接受用搜尋字串檢查那句話還在不在:那檢查的是字,不是行為。
    • 不接受靜默跳過。
    • 接受兩種:把那一步搬進 script,讓它可以檢查;或在 requirement 上明寫「無法機械檢查」與理由,由 verify 審這個標記(跟「不改變行為」同一種處理)。

    寫不出檢查,通常表示那一步該從 SKILL.md 的文字搬進程式。這跟 #479 第 3 項(SKILL.md 太大、裡面的 bash 照著跑會出錯)是同一個方向。

    成本:程式的部分本來就先寫測試,多出來的是 requirement 與測試之間的連結。

    Related

    #423、#479、#387、#428、#433

  5. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    Diagnosis

    Type

    feature

    Root Cause / Analysis

    需求拆解(依 issue 正文與四則 Decision comment):

    1. 每一張 issue 改變或確定下來的行為都寫進 openspec/specs/,不論 tier。
    2. 寫入的方式用 Spectra 既有的機制(change、spec delta、archive),IDD 不另外維護一套規格格式。
    3. Simple 的 issue 也走 spectra propose 與 apply,用比較快的形式。
    4. 「不改變行為、所以不寫規格」要經過審核才成立:規格 → 程式用 spectra-verify;程式 → 規格用 idd-verify 的 Regression lens,拿這張 issue 的 spec delta 當對照,delta 是空的而 diff 有行為改動就是 HIGH。
    5. 每一條 requirement 附一個可執行的檢查(Spectra 的 Example 加對應的測試);寫不出檢查的要明寫理由並受審。

    現況(main,dc64efa):

    • 規格只在 Spectra tier 產生。idd-all 的 Simple 與 Plan 走 idd-implement,那裡沒有任何一步碰 openspec/;idd-implement 遇到 Spectra tier 是直接跳過、交給 spectra-apply。
    • idd-close 沒有封存的步驟(全文沒有 spectra archive)。封存靠人另外跑 /spectra-archive,所以 openspec/changes/ 現在有 8 個沒封存的 change,openspec/changes/archive/ 有 30 個(openspec change add-privacy-scrubbing-gate 未封存:privacy-scrubbing-gate spec 不在 openspec/specs、Phase 2 task 未勾 (sister concern from #421) #433 是其中一個沒封存的)。
    • idd-verify 的 Regression lens 對照的是 issue 的文字,不讀 spec delta。
    • 32 份規格、190 條 requirement、444 個 scenario,只有 20 個 Example(12 份規格)。70 個測試 suite 裡 3 個提到規格。從一條 requirement 找不到它的檢查。
    • Spectra 3.0.0 的預設 workflow spec-driven 是 proposal → specs → tasks,design 是選用;另有 no-spec,也可以自訂 workflow。所以「更快的形式」不必另外發明。
    • IDD 對 Spectra 的依賴現在只有一道:分到 Spectra tier 而機器上沒有 spectra CLI 就中止。每一張都要寫規格之後,這道依賴會擴到每一張 issue、每一個用 IDD 的 repo。

    這張真正難的地方不在「多寫一段規格」,在下面四件還沒決定的事(Strategy 的討論議程)。它們決定這個改動有多大。

    Existing work

    unknown:merged PR 清單到了上限(100),較舊的沒有查。查到的範圍內沒有 PR 或 branch 處理這張 issue。

    Impact

    • 分流與流程:rules/sdd-integration.md、idd-diagnose(Step 3.5 的下一步表)、idd-all(Phase 3a/3b 的分派)、idd-implement、idd-plan。
    • 驗證:idd-verify(Regression lens 的對照對象、reviewer 拿到的 context)、references/verify-profiles.md。
    • 結案:idd-close(封存要成為結案的一步)、.claude/scripts/spectra-archive-post-ic.sh。
    • 規格:routing-vagueness-layer、complexity-hard-gate、idd-pr-hitl-modes、idd-verify,加一份新的 capability。
    • 其他 repo:所有用 IDD 的 repo,包括沒有 openspec/ 的與第三方的 clone。
    • 使用者流程:Simple 的 issue 每張多一段規格與一次封存;/idd-all 的每一張都會經過 Spectra。

    Strategy

    走 /spectra-discuss,議程如下。前四項要維護者決定,後三項有明確的做法、討論時確認即可。

    • 沒有 Spectra 的 repo 怎麼辦(沒有 CLI,或沒有 openspec/)。停下並給安裝指令(品質一致,但所有 repo 都得先裝 Spectra),或照現在的方式跑、不寫規格(不擋路,但規則變成「有裝才有」)。
    • 既有的 190 條 requirement 要不要回頭補 Example 與檢查。只管之後新增或改到的,或另開一張把既有的補齊。
    • Plan tier 還要不要 /idd-plan。proposal 本身就是計畫:保留 /idd-plan 的核准,或讓 proposal 取代它,tier 只決定要不要 discuss 與 design。
    • 每張 issue 一個 change 目錄的代價。每結一張就多一個封存目錄與一個封存 commit。接受,或讓 Simple 的 delta 用更輕的方式落地(這會偏離 Spectra 的原生機制)。
    • Simple 的快速形式:用 spec-driven、跳過 discuss 與 design,還是 fork 一個 IDD 專用的 workflow。
    • requirement 與檢查之間的連結怎麼寫、誰來檢查:測試裡標出它對應的 capability、requirement 與 Example,加一支檢查腳本(每個 Example 都要有測試指到它)。Spectra 的 spectra-verify 對這件事是用搜尋推斷,不是機械檢查。
    • 不寫規格的類別:narrative/docs(Layer 1)與 meeting 沒有行為可寫,照「不改變行為」處理,由 Regression lens 審。

    分段(provisional,討論後再定):

    順序上的前提:#392 先進 main(維護者 2026-11-10 的決定,#392 comment 6761657951);IDD 與 Spectra 接縫的 #462、#475、#433 先修,不然每張 issue 都會踩到。

    Conflict Class

    C_shared_module_coord
    共享的是 skills/idd-all/SKILL.md、skills/idd-verify/SKILL.md 與 rules/sdd-integration.md:#392 還沒合併的分支大改前兩個,#457 也要改 idd-all。

    Complexity

    Spectra

    • Layer 2:改的是 plugin 對外的流程契約(每個用 IDD 的人下 /idd-all、/idd-issue 之後會發生什麼),要寫成規格。
    • Layer 3:三項都命中:改既有規格的 normative 行為(分流與 verify)、牽動兩份以上的規格、是會被之後的維護者繼承的結構決定。

    Hard-gate: triggered — 同一個概念(每張 issue 都寫規格)散在 rules/sdd-integration.md、idd-diagnose、idd-all、idd-implement、idd-verify、idd-close 六處以上,並改到共用的分流規則。Spectra 已先成立,這一行只作紀錄。

    Risks

    Residue

    維護者提這張的理由是「verify 之後不該再出現 HIGH」。這張提供的是機制(每張 issue 留下規格與可執行的檢查),不是那個保證:規格沒寫到的性質仍然沒有檢查。保證本身(停止條件與估計還沒找到的缺陷數)在 #423。

    Vagueness Pre-check

    • V1: 2 — 要做什麼寫得出來:每張 issue 的行為改動寫進 openspec/specs/,Simple 也走 spectra propose 與 apply(issue 正文 Expected 兩項與 Decision comment 6760232879)
    • V4: 3 — 完成條件大致清楚:每條 requirement 有 Example 與測試、「不改變行為」由 Regression lens 審(comment 6760421055、6760547758),但四件事還沒決定(Strategy 的前四項),所以不是可以直接測的條件
    • Triggered: no — both axes ≤ 3

    Sister Concerns Filed (mid-diagnose, v2.47.0+ #528)

  6. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    📊 For Reviewer / Collaborator

    現在:已結案。規格的寫入原本只接在 Spectra tier;現在 IDD 實作的每一張 issue 都留下一個 Spectra change(在 branch 上、verify 之前封存),或一個宣告過的豁免。PR #490 合併為 2dc56ab,細節在 closing summary。
    Blocking:無
    你該做什麼:無。這些改動已在 4.0.0 發佈(CHANGELOG [4.0.0]);延後的項目列在 closing summary 的「另開的 issue」。

    last-updated by idd-close at → closed, 2026-11-11

  7. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-10):
    「1. 對, 2. 照你的建議 3. 我還是傾向使用wrapper,因為以後可能會調整, 4. 接受」
    — 維護者,回答 Diagnosis 的 Strategy 前四項

    決定

    # 問題 決定
    1 沒有 Spectra 的 repo 自己的 repo 停下並給安裝與初始化的指令;第三方的 clone 不寫規格(不把 openspec/ 放進別人的 repo)
    2 既有的 190 條 requirement 只管之後新增或改到的;補齊既有的另開一張
    3 Plan tier 與 /idd-plan 保留 IDD 自己的 wrapper,不讓 Spectra 的 proposal 直接取代它。理由:以後可能會調整
    4 每張 issue 一個 change 目錄與一個封存 commit 接受

    Rationale

    第 3 項是維護者的選擇,與 Claude 的建議(讓 proposal 取代 /idd-plan)不同。

    Claude 對第 3 項的解讀,規格提案時確認:

    • /idd-plan 留著,Plan tier 仍由它進入;它裡面去呼叫 Spectra 的 propose 來產生規格與 task,核准的動作留在 IDD 這一層。
    • 同樣的道理套到 Simple:IDD 的 skill 包住 Spectra 的 propose 與 apply,不讓使用者或 idd-all 直接依賴 Spectra 那兩個 skill 的介面。之後 Spectra 改了、或 IDD 想換做法,只改 wrapper。

    第 2 項的「另開一張」還沒有開:等這張的規格提案定下「Example 與檢查怎麼連結」之後再開,否則補的格式會跟之後的規定不一樣。

    Related

    #423、#482

  8. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    規格提案:Spectra change spec-on-every-issue

    提案在 branch idd/480-spec-on-every-issue(commit e57163e)。只有提案,沒有實作;實作等 #392 進 main。spectra validate 通過,spectra analyze 沒有 finding。

    做法

    維護者的決定 提案裡的做法
    每張 issue 都更新規格,Simple 也走 propose 與 apply idd-implement 包住輕量的 propose(不做 discuss、不寫 design)、apply 與收尾
    保留 IDD 自己的 wrapper idd-plan 留著:attended 時在 plan mode 核准 proposal 與 tasks,再交給 idd-implement。共用的步驟寫在一份 references/spec-wrapper.md
    「不改變行為」要受審 Implementation Complete 留言多一行宣告;verify 的 Regression lens 發現範圍內有行為改動就是 HIGH
    每條 requirement 附可執行的檢查 測試裡寫標記指名 Example;一支腳本檢查新增與改到的 requirement 都有 Example 與測試,寫不出檢查的要寫一行理由
    沒有 Spectra 時自己的 repo 停下、第三方 clone 不寫 同一支腳本的 preflight
    接受每張 issue 一個 change 目錄 名稱 idd-<N>-<slug>;在 branch 上、verify 之前封存,被審查的 commit 就帶著套用後的規格

    verify 之後的修正也走同一條路:Blocking 的修正要留下一條寫出該性質的 requirement、Example 與修正前會失敗的測試。這是 #423 的對策落在這張的部分;停止條件本身仍在 #423。

    Claude 自己定的兩個預設

    維護者沒有決定過,提案先這樣寫:

    1. 行為不變的重構、只改測試、只改 CI 設定,都算「不改變行為」,由 verify 審。
    2. unattended 的 Plan issue 走輕量形式,沒有核准這一步(沿用現況)。

    寫提案時發現的限制

    Spectra 3.0.0 在 git 的 linked worktree 裡會把檔案寫進主工作樹(2026-11-10 在暫存 clone 上重現)。idd-implement 在主工作樹被別的 session 鎖住時會改用 linked worktree,所以這條路對要寫規格的 issue 走不通。提案的做法是 preflight 偵測到就停下並說明;把隔離方式改成獨立 clone 列為後續的 issue。

    規模

    17 項 task,略多於 Spectra 建議的 15。要拆成兩個 change 的話,切點是 task 4.2(verify 之後的修正)。

  9. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-11):維護者對兩個問題選了建議的選項:
    「#480 提案裡我自己定的兩個預設,可以照這樣嗎?」→「都照預設」
    「#480 現在開始實作嗎?」→「現在開始」

    決定

    1. 提案裡 Claude 定的兩個預設照用:
      • 行為不變的重構、只改測試、只改 CI 設定,都算「不改變行為」,由 verify 審。
      • unattended 的 Plan issue 走輕量形式,沒有核准這一步(沿用現況)。
    2. 開始實作 Spectra change spec-on-every-issue。feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 已在 3.7.0 發布,前提滿足;第一步是拿提案對最新的 main 重新驗證(task 1.1)。

    Related

    #392(已結案,3.7.0)、#424(已結案,3.7.0)

  10. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    📝 Note — 原列的前提 #462、#475、#433

    ### Blocking 寫著「IDD 與 Spectra 接縫的 #462、#475、#433 要先修」。這一句出自 decision 6760232879 的 Rationale,是 Claude 的建議,不是維護者的決定;維護者的決定只有 #392 先進 main。2026-11-11 問維護者要不要開工時,我寫的是「#392 已經在 3.7.0 發布,前提都滿足了」,沒有列出這三張。這是我的疏漏。

    當初的理由是:每張 issue 都過 Spectra,會放大這三個接縫問題。實作之後,三張與這份 change 的關係如下:

    所以這三張我不當作 #480 結案的前提,各自照原本的 issue 處理。要改回「先修再結案」,告訴我就好。

  11. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change spec-on-every-issue

    Spectra change spec-on-every-issue 已封存在 3eaa895;進度見 openspec/changes/archive/2026-11-11-spec-on-every-issue/tasks.md(18/18)。封存之後 spec-change.py links --base 03f5559 印 ok,spec-change.py archived --ref HEAD 印 pass。

    做了什麼

    • scripts/spec-change.py:declared、archived、links、preflight 四個子指令,各印一行 JSON。規格目錄照 Spectra 的規則從 .spectra.yaml 的 spec_dir 讀(沒有就是 openspec)。
    • references/spec-wrapper.md:wrapper 的共用契約。idd-implement(Simple)與 idd-plan(Plan)照它把實作包進一個 Spectra change,idd-all 的 Spectra tier 照它收尾,在 branch 上、verify 之前封存。
    • Implementation Complete 帶標記與剛好一行 **Spec**::change <名稱>、no behaviour change(封閉的四種)、third-party clone。
    • idd-verify(code profile)把宣告、範圍內改到的規格檔、兩個檢查的結果交給每個 reviewer。沒有 requirement 的行為改動是 HIGH,不成立的 no behaviour change 是 HIGH,檢查的缺漏與讀不到宣告是 Blocking。
    • idd-close Step 1.57:宣告的 change 沒有封存在預設 branch 上就不關。
    • verify 之後的修正若新增或改到 requirement,另建 idd-<N>-fix<k>。

    驗證

    • 測試:spec-change 265、spec-wrapper-contract 87、spec-close-gate 16,以及讀到改動檔案的其他 suite 全過;完整的 73 個 suite 在 afc2c67 全過,最後的 head 由 PR 的 CI 重跑。
    • 暫存 repo 實跑(2026-11-11,用這條 branch 的 plugin):Simple issue(3.2)、只改 README 的 issue(3.5)、Spectra tier issue(3.4)、兩次 verify(4.1)、一次修正 run(4.2)。結果逐項寫在 tasks.md;attended Plan(3.3)依維護者的決定只用契約測試驗收。
    • 封存前跑了 spectra-verify:1 項 critical、10 項 warning,都在 2f0f97f 修掉。

    實作中找到並修掉的

    • Spectra 封存時在 requirement 之間插入 ---,links 因此把前一條當成改過(7a3fbc1)。
    • spectra-propose 會 park change,spectra-apply 碰到 parked 的 change 會發問;無人值守時沒有人回答(644b1c1)。
    • 封存之後要改 requirement 本身時,契約沒有說怎麼做,暫存 run 因此改了 archive/ 底下的檔案(2f0f97f)。

    另開的 issue

  12. 48 remaining items

  13. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Follow-up Findings Filed (v2.72.0+ #148)

    第 7 輪 verify(報告)的 7 項範圍外 findings 都已有追蹤的 issue,這一輪沒有另開新的:

    Findings 去處
    #15、#16、#17、#18 #496(已列,第 1、3、2、4 項)
    #19 #491(已列)
    #20 #493(已列)
    #21 #494(已列)

    第 1 列 HIGH 是 Blocking,照契約第 7 步由下一個修正輪處理;第 2 到 14 列是 In-scope fix,會不會也在那一輪修,依 2026-11-11 的決定由修正輪的 plan 寫明。

  14. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Decision: attended Plan tier approves the Implementation Plan, not the proposal

    縮小範圍 (Recommended)

    (2026-11-11 10:40 +08:00,回答:第 4 到 7 輪 verify 的 HIGH 都出在 attended Plan tier 由 idd-plan 在 plan mode 核准 Spectra proposal 這一塊,這條路徑沒有實跑過,每輪加的新機件下一輪就出問題。三個選項:縮小範圍、原地做內容綁定、接受為已知限制)

    決定:attended 的 Plan tier 回到 #480 之前的做法。idd-plan 在 plan mode 只核准 Implementation Plan,不 propose。核准後由 idd-implement 照契約用輕量形式 propose、apply、收尾,與 Simple tier 走同一條路(Simple 已在暫存 repo 實跑過)。idd-plan 的事前 propose、rejected 寫法、Step 3.5(fix4 到 fix6 加的)由修正輪 idd-480-fix7 拿掉。

    另案:「在 plan mode 核准 Spectra 的 proposal 本身」另開 issue,驗收條件是內容綁定(核准的檔案就是 apply 的檔案,可機械檢查),加上一次真的 attended run。

    取代:Diagnosis 與規格提案摘要(comment 6763678281)裡「Plan tier 由 idd-plan 在 plan mode 核准 proposal 與 tasks」的設計,以及 task 3.3 的那一半。

  15. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Implementation Plan (fix round 7)

    Spec plan: change idd-480-fix7

    verify 第 7 輪(報告)有 1 項 HIGH。依 2026-11-11 的決定(decision),attended Plan tier 縮回只核准 Implementation Plan;在 plan mode 核准 proposal 本身移到 #497。

    Files & Changes

    • skills/idd-plan/SKILL.md:不再 propose。要寫規格時,plan 行在進 plan mode 前寫 **Spec plan**: proposed (change idd-<N>-<slug>),核准後改成 change <名稱>(已有開著的 idd-<N>- change 時寫那個名稱);Step 6 把名稱交給 idd-implement。拿掉 Step 3.5、Step 4 附檔案的說明與範本那一行、read_change_files task;Revised、Aborted 兩列與 Revise 說明回到 feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 之前的寫法。
    • skills/idd-implement/SKILL.md:從 idd-plan 來時用核准的 plan 行的名稱以輕量形式 propose,與 Simple 相同;change 已開著(上次中斷)就直接用它。Step 0.6 不再提 rejected。
    • references/spec-wrapper.md 第 3 步:拿掉 rejected 那一支與「idd-plan 會先建好」;寫法改成四種;停下訊息與表格改成「重跑 /idd-plan,核准後 plan 行寫上這個 change」。
    • scripts/spec-change.py:plan 不再認 rejected(沒有發布過的寫法)。
    • rules/sdd-integration.md 的 Plan 流程、idd-diagnose 的 route 表、CHANGELOG:改成核准 Implementation Plan、propose 在 idd-implement。
    • 規格(change idd-480-fix7):REMOVED fix6 的 requirement「Plan-tier approval covers the change as it will be applied」;MODIFIED wrapper 那條(Plan tier 的句子、**Spec plan**: 的寫法、兩個 Example 拿掉 rejected 的列)。
    • 測試:拿掉 Step 3.5 與 rejected 的檢查,加上「idd-plan 不 propose」「idd-implement 用核准的名稱 propose」的檢查,先看到失敗。

    留到之後

    第 7 輪 #2 到 #11、#13 都在 Step 3.5 或 rejected 上,隨它們一起拿掉;#12 用 idd-edit --correct 更正第 6 輪那則 follow-up 留言;#14 隨 wrapper requirement 的修改處理;#15 到 #21 已記在 #491、#493、#494、#496。

  16. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change spec-on-every-issue, idd-480-fix1, idd-480-fix2, idd-480-fix3, idd-480-fix4, idd-480-fix5, idd-480-fix6, idd-480-fix7

    verify 第 7 輪的 1 項 HIGH 依維護者的決定(decision)以縮小範圍處理,修正輪是 change idd-480-fix7(plan)。spec-change.py links --base 03f5559 印 ok,archived --ref HEAD 對這一行宣告印 pass。

    第 7 輪改了什麼

    更正於 2026-11-11:Aborted 列保留了 #480 加的一句(plan 行留在 proposed),不是整列回到 #480 之前

    驗證

    • spec-change 428、spec-wrapper-contract 238,新的檢查先看到失敗(25 個,加上 spectra-verify 那一輪 7 個);讀到改動檔案的 31 個 suite 全過。

    沒修、另開的

  17. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Verify: #480

    Engine

    manual fan-out (4 lens Agents + sequenced DA, model: opus, file-based output) + Codex (gpt-6.1-sol, effort medium, codex-pro profile), model: opus
    6 / 6 reviewers completed

    這一輪是第 8 輪,沒有用 pai canonical backend:這次是 headless 執行,每個 reviewer 與 Codex 都在前景跑完才合併,而 Workflow 是背景執行。四個 lens 與 Codex 同一波跑,Devil's Advocate 等五份結果都就緒之後才派出。五個 Claude reviewer 的寫檔工具被拒,它們改用 Bash 寫 findings 檔。Codex 前兩次呼叫回 network connection was lost,第三次(不帶 --service-tier fast,issue、context 與 diff 合成一個輸入檔)成功。

    Aggregate

    PASS — 0 blocking, 5 in-scope fix, 3 follow-up, 2 rejected

    Reviewed: 03f5559a9293bae743c6c2a4be7de2ad6b8de063..87bd9d04dc75ae8e1c1305d74ad6720ea10647e1

    依 2026-11-11 的決定(第 6 輪起沒有 HIGH 才合併):這一輪 Codex 提出 1 項 HIGH(第 1 列),DA 裁決與 coordinator 對照 base 與 idd-all 的分派表之後判為不成立,標 Rejected 並保留 Codex 的 severity,成不成立由維護者決定。其餘 reviewer 沒有 HIGH。表裡另有 3 項 MEDIUM 的 In-scope fix,加上 2 項 Rejected,/idd-all 不會自動 merge。

    要求覆蓋率

    12 / 12 requirements addressed

    第 7 輪的 HIGH(Revised 路徑在 plan mode 裡改不了檔案)已由 fix7 縮小範圍解決:idd-plan 只核准 Implementation Plan、不 propose,Revised 只改 plan 留言,核准的就是之後交給 idd-implement 的那一份。四個 lens、DA 與 Codex 都同意。第 7 輪 #2 到 #11、#13 隨 Step 3.5 與 rejected 寫法一起移除,grep 找不到殘留;#12(comment 6784058096 的去向)重新抓取後是乾淨的、列了 #496;#14 的 Scenario 已改寫。

    Codex 對四條要求判 PARTIALLY:其中三條的缺口是已經分流的 follow-up(#491、#493、#494),不是這一輪新出的;第四條(attended Plan)的依據是它的 HIGH,見第 1 列(Rejected)。「每條 requirement 有可執行檢查,寫不出來要說明並受審」這一條仍算做到:第 3 列的免檢查理由不成立,正是這條 requirement 要求的審查抓到的,修法是 In-scope fix。

    規格對照:宣告是 change(spec-on-every-issue 與 idd-480-fix1 到 fix7),spec-change.py links 印 ok,archived 在受審的 head 印 pass,所以不加規格檢查的 Blocking 列。

    測試(reviewer 實際執行,head 87bd9d0):完整的 run-all-tests.sh 73 個 suite 全過(Regression lens);其中 spec-change 428/0、spec-wrapper-contract 238/0(重複的那一份已拿掉)、spec-close-gate 29/0、verify-profiles 18/0、plan-routing-consistency 28/0、merge-and-close-contract 119/0、authoritative-source-producer 28/0、skill-description-contract 62/0。

    Findings(合併後)

    # Severity Finding Source Action
    1 HIGH Codex:沒有 open change 時契約第 3 步(references/spec-wrapper.md:59-62)不讀最新 plan 就印 propose,所以中止或未核准、留在 proposed 的 Implementation Plan 會被之後的 /idd-implement 越過並 propose、apply。不成立的理由:(a) head 的規格沒有承諾這個 guard,spec.md:164 的 Example 第一列就是「沒有 open change、plan 不讀、印 propose」;(b) 不是 #480 引入的,base 03f5559 的 idd-plan Aborted 列沒有任何 guard,idd-implement 只在直接呼叫 Plan-tier issue 時詢問;(c) Codex 的兩條重現路徑:Simple issue 本來不需要核准;idd-all attended 的 Plan tier 一律經 Phase 3p 走 /idd-plan(idd-all/SKILL.md:673),只有 unattended 直送 idd-implement,那是規格刻意允許的。真正錯的是文字,見第 2 列;要加真的 guard 歸 #496 codex Rejected
    2 MEDIUM skills/idd-plan/SKILL.md:249 的 Aborted 列說 plan 行留在 proposed 時「idd-implement 看到 proposed 不會 propose 也不會 apply」,這只在有 open change 時成立;fix7 之後中止的 Plan-tier issue 通常沒有 open change,之後的 run 會 propose、apply(第 1 列)。改寫這一句;spec.md:96 那句「in the Plan tier the change is proposed only after idd-plan has written change <name>」沒有 SHALL、又比同段其他句子寬,限縮到經 idd-plan 的 attended run。fix7 的 Implementation Complete 對 Aborted 列的描述也要更正,見 Proposed Corrections agents:logic+regression+requirements+devils-advocate+codex In-scope fix
    3 MEDIUM spec.md:98 的 No executable check: 把「idd-plan's lookup of an open change」列為免檢查,但理由不成立:那是兩次 spectra list 加名稱過濾,讀不到或不是 JSON 就停,與契約第 3 步已用固定 bash 並有測試的做法相同,寫得出檢查。現在 idd-plan:140 只有散文,讀不到就停的行為若退化不會被發現。改成固定 bash 並加測試,或把這一項從免檢查清單拿掉並給 Example agents:regression+devils-advocate In-scope fix
    4 MEDIUM skills/idd-implement/SKILL.md:428,434 要求 propose 之後把 Implementation Plan 的清單改成 change 的 tasks(改自己的留言),這也套用到從 idd-plan 來的路徑(:431)。fix7 之後那則留言是維護者核准的唯一紀錄,這樣做會把核准過的清單換成沒人核准過的 Spectra tasks。從 idd-plan 來的路徑改成把 tasks 附加在後面或另貼一則留言 agents:requirements+devils-advocate In-scope fix
    5 LOW skills/idd-plan/SKILL.md:53 的 chain_to_idd_implement task 仍說 idd-implement 跳過 Step 2,與 Step 6 及流程圖(帶 --spec-change 時在 Step 2 propose)矛盾。測試只擋字面上的 Step 2: SKIP,所以這一行漏掉了 agents:regression+devils-advocate In-scope fix
    6 INFO issue 正文的 task 3.3 仍是勾選狀態,文字描述的是 2026-11-11 決定撤回的設計(idd-plan propose、在 plan mode 核准 proposal)。用 /idd-update 標成被 fix7 取代 agents:requirements+devils-advocate In-scope fix
    7 LOW 從 plan 行到 propose 沒有機械綁定:idd-implement --spec-change <名稱> 不檢查名稱格式,也不比對核准的 change <名稱>;Approved 列改 plan 行失敗時仍會 propose,紀錄停在 proposed,中斷的話重跑會停在第 3 步、要再核准一次;手打 --spec-change 也會跳過 spec.md:96 要求的 /idd-plan 詢問。與 #496 第 3 項同根 agents:logic+requirements+security+devils-advocate Follow-up
    8 LOW 有中斷留下的 open change 時,idd-plan 在 plan 行點名它,plan mode 只呈現 Implementation Plan,核准後 idd-implement apply 的是 branch 上既有、維護者沒看過的 proposal 與 spec delta。spec.md:96 已寫明在 plan mode 核准 proposal 屬 #497,所以是第 7 輪 HIGH 刻意延後的那一半 agents:security+regression Follow-up
    9 INFO idd-verify 的外部寫入收集器把第 7 輪 verify 報告裡引用的 ### Follow-up Findings Filed 段落(含多餘的 code fence 與 </details>)當成紀錄抓進來:它不理會 code fence,引用在別的留言裡的標題也會被當成 audit-trail。是 #315 收集器的問題,不屬 #480 agents:regression+devils-advocate Follow-up
    10 LOW Security lens 說 comment 6784058096 的更正多貼了一份表格、code fence、</details> 與一句像指示的文字,建議重跑 /idd-edit --correct。不成立:DA 與 coordinator 重新抓取這則留言,裡面沒有 </details>、code fence 或那句話;那些內容是收集器從第 7 輪報告抓進 context 的(第 9 列) agents:security Rejected

    Scope Check

    fix7 動到的 15 個檔案都屬 #480;新增的只有 idd-plan allowed-tools 的 Bash(spectra:*),Spectra 的依賴宣告已在 #492 追蹤。拿掉的 rejected 寫法沒有發布過(CHANGELOG 仍在 unreleased),舊的 rejected plan 行讀成 invalid,第 3 步會停下並指向 /idd-plan,失敗方向是安全的。外部寫入(#482、#492 到 #494、#487、#488、#491、#496 的 follow-up 紀錄)與 diff 的內容一致,沒有發現指示性文字。

    Proposed Corrections

    # Target Section 錯在哪 Command
    1 comment:6786451601 ### 第 7 輪改了什麼 第三點對 idd-plan Revised、Aborted 兩列的描述不完整:Revised 列回到 #480 之前的寫法,Aborted 列仍保留 #480 加的「plan 行留在 proposed」那一句(idd-plan/SKILL.md:249) /idd-edit comment:6786451601 --correct --section '### 第 7 輪改了什麼' --body-file '<執行時建的檔>'

    這一輪是 unattended(headless),只列不做;替換內容在修掉第 2 列之後再寫,照修完的實際文字描述 Aborted 列。issue 正文 task 3.3(第 6 列)在 ## Current Status > ### Tasks 底下,走 /idd-update,不在這張表。

  18. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Follow-up Findings Filed (v2.72.0+ #148)

    第 8 輪 verify(報告)的範圍外 findings:

    Findings 去處
    #7、#1 的 guard #496(補充 comment)
    #8 #497(補充 comment)
    #9 #498(新開)
  19. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Decision: round 8 — the rejected HIGH stays rejected, merge and close

    審過了

    合併並結案

    (2026-11-11 12:36 +08:00,回答兩題:「PR #490 是 #480 的全部改動,你審過了嗎?」與「第 8 輪有一項 Codex 提的 HIGH 被判不成立,要怎麼處理?」;第二題的其他選項是「第 1 列算 HIGH,修」「先修第 2–5 列」「先不動」)

    決定:verify 第 8 輪(報告)第 1 列照不成立處理。核對過的依據:base 03f5559 與 PR head 87bd9d0 的 idd-implement 對「直接呼叫 Plan-tier issue」問的是同一個問題(要不要改走 /idd-plan),head 只是把它從 Step 2.5 提前到 propose 之前的 Step 0.6,所以不是 #480 引入的。第 2 到 5 列(3 項 MEDIUM、1 項 LOW)開成 #499;第 6 列已在正文處理。PR #490 以 squash 合併、保留 branch,接著 /idd-close #480。

    close stage 的 gate 因為 Rejected 與 MEDIUM 的 In-scope 列不會放行,這次合併依這個決定執行,不經 gate。

    不包含:3.8.0 的 release。

  20. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Closing Summary

    Problem

    只有 Spectra tier 的 issue 會留下 spec delta。Simple 與 Plan 的設計決定留在 issue 留言、程式與測試裡,openspec/specs/ 與實際行為對不上(例子:#405、#387、#428、#433)。維護者要求 IDD 處理的每一張 issue 不論 tier 都更新規格,做法是與 Spectra 深度整合。

    Root Cause

    規格的寫入只接在 Spectra tier 的路徑上:idd-implement 沒有任何一步碰 openspec/,idd-close 沒有封存的步驟,idd-verify 對照的是 issue 的文字、不讀 spec delta,從一條 requirement 也找不到它的檢查(Diagnosis)。

    Solution

    • 每一張實作的 issue 留下一個 Spectra change,或一個宣告過的豁免。Implementation Complete 帶標記與一行 **Spec**::change <名稱>、no behaviour change(封閉列舉的四種情況)或 third-party clone。
    • Simple 與 Plan 由 idd-implement 以輕量形式(不做 discuss、不寫 design)propose、apply、收尾。attended 的 Plan tier 由 idd-plan 在 plan mode 核准 Implementation Plan,核准後把 change 名稱交給 idd-implement。Spectra tier 由 idd-all 照同一份契約收尾。契約在 references/spec-wrapper.md。
    • change 在 branch 上、verify 之前封存,verify 看到的就是會合併的規格。
    • 新增或改到的 requirement 各附一個帶測試標記的 Example;寫不出檢查的寫 No executable check: 與理由,由 verify 審。
    • 機械判定集中在 scripts/spec-change.py(declared、archived、links、preflight、ic、plan,各印一行 JSON)。
    • idd-verify 把宣告、範圍內改到的規格、links 與 archived 的結果交給每個 reviewer:規格沒寫到的行為是 HIGH,不成立的 no behaviour change 是 HIGH,檢查沒過是 Blocking。
    • idd-close 新增 Step 1.57:宣告的 change 沒有在預設 branch 上封存就不結案。
    • verify 之後新增或修改 requirement 的修正,另建 change idd-<N>-fix<k>。
    • 沒有 Spectra 的 repo:自己的 repo 停下並給安裝或初始化的指令;第三方 clone 照舊實作並宣告 third-party clone。
    • 新的規格 openspec/specs/spec-on-every-issue/spec.md(9 條 requirement、11 個 Example);openspec/specs/idd-verify/spec.md 加上 reviewer 拿規格對照行為的 requirement。

    對流程是 BREAKING:會改變行為的 Simple 與 Plan issue 現在都經過 Spectra。已知限制寫在 CHANGELOG [Unreleased]:linked worktree 會停下(#488);一次無人值守的 Simple run 量到 5 分鐘裡約 3 分鐘花在 propose 與收尾。

    Verification

    • verify 共 8 輪。第 1 到 7 輪各有 HIGH 或範圍內的 finding,逐輪以 change idd-480-fix1 到 idd-480-fix7 修正並封存(第 1 輪的報告沒有貼出:headless run 在 Regression lens 回來前結束)。第 4 到 7 輪的 HIGH 都在「attended Plan tier 在 plan mode 核准 Spectra proposal」這個沒有實跑過的機制上,維護者決定縮小範圍(decision),核准 proposal 本身移到 [enhancement] idd-plan: approve the Spectra proposal itself in plan mode, bound to the files that are applied (follow-up from #480) #497。
    • 第 8 輪 PASS、0 blocking(報告),審的是 03f5559..87bd9d0。Codex 提的 1 項 HIGH 在報告裡判為不成立,維護者認可這個判定並決定合併(decision)。這次合併依維護者的決定執行,沒有經過 close stage 的 gate。
    • 測試:spec-change 428、spec-wrapper-contract 238、spec-close-gate 29 個檢查。第 8 輪在 87bd9d0 跑完整的 run-all-tests.sh,73 個 suite 全過;PR 的 CI 在同一個 commit 通過。
    • 暫存 repo 的端到端實跑:一張 Simple issue、一張只改 README 的 issue、一張 Spectra tier 的 issue、兩種 verify 情境、一次修正 run。attended 的 Plan tier 沒有實跑,只有契約測試。
    • 結案時的檢查:Step 1.57(這張自己加的那一道)對合併後的 main 印 pass(archived at 2dc56ab);merge-completeness 回 0;spec-change.py links --base 03f5559 印 ok。semantic gate 8 項通過、46 項沒有可辨識的 pattern、1 項警告:task 3.2 提到的 docs/spectra/specs/word-count-script/spec.md 是暫存 repo 裡的檔案,不在這個 repo,判為誤報。
    • doc-sync:8 files checked, no staleness detected(plugin 的 README 與 CLAUDE.md 已在 PR 裡更新)。

    Changes

    另開的 issue

    Residue Acknowledgement

    Filed: #423。Diagnosis 的 residue 是「這張提供的是機制,不是『verify 之後不再出現 HIGH』的保證」。保證本身(停止條件與估計還沒找到的缺陷數)在診斷時就指向 #423,那張仍開著,沒有另開。

    Distribution Sync

    • Detected: plugin(這個 repo 自己就是 marketplace)
    • Choice: 發佈並更新。版本號由維護者決定為 4.0.0(原話「我覺得這是超極大的改動,應該是4.0.0」);先前備好、在這張 issue 裡稱為 3.8.0 的就是這一版,3.8.0 沒有發佈過。
    • Outcome: fdf8d0d chore: release 4.0.0 已在 main,遠端 CI 通過;plugin.json 與 marketplace.json 是 4.0.0。上面說寫在 CHANGELOG [Unreleased] 的內容,現在在 [4.0.0] - 2026-11-11。沒有打 tag,也沒有 GitHub Release(與 3.7.0 相同)。
    • At: 2026-11-11T05:13:10Z
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions