Repository navigation
Closed
Labels
enhancementNew feature or requestNew feature or request
Description
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
- 只有 Spectra tier 會產生 spec delta。Simple 與 Plan 的設計決定留在 issue 留言、程式與測試裡。
- routing 判準:更傾向 Spectra/SDD — 規格記錄的價值應計入分流權重 #252(2026-07-17 結案)加了設定
sdd_bias: high:硬閘命中時升到 Spectra。預設不變,Simple 仍然不碰規格。 - spectra-archive-post-ic:留言帶出本機絕對路徑且繞過 gh-egress;候選偵測誤收其他 repo 的編號 #405 是例子。決定行為的兩個維護者決定(只有明確來源才自動貼;由讀的人核准)記在 issue 留言與 SKILL.md;
openspec/specs/的 32 份規格沒有任何一份描述這支腳本現在的行為,合併的 commit 在openspec/底下只改了CONVENTIONS.md。 - 規格與實際行為已經對不上的例子:docs: specs and idd-all description still say idd-all always stops at verified; meeting runs do not #387、idd-clarify 文件與 spec 漂移:spec 仍要求 TTY unattended 偵測與 Suggested canonical 欄,SKILL 連到不存在的 spec 路徑 (sister concern from #422) #428、openspec change add-privacy-scrubbing-gate 未封存:privacy-scrubbing-gate spec 不在 openspec/specs、Phase 2 task 未勾 (sister concern from #421) #433。
跟 verify 的關係
維護者的推論:沒有 HIGH 的一輪之後又出現 HIGH,代表先前的設計不完整。verify 的停止條件與怎麼接近它,在 #423 討論;這張負責的是讓每一張 issue 都留下規格,使找到過的 HIGH 不再出現。
相關 issue
- feat: 判定性質的工具先寫可執行的判定表再實作;verify 審規格並偵測不收斂的修補迴圈 #423:先寫可執行的規格再實作;verify 的停止條件。
- routing 判準:更傾向 Spectra/SDD — 規格記錄的價值應計入分流權重 #252:routing 偏向 Spectra 的設定開關。
- feature: mechanism for sync archived Spectra spec deltas with subsequent capability extensions #54:
spectra archive會把 delta 套進openspec/specs/的主規格(機制已存在)。 - verify 列出的更正與實作者換掉的做法不會寫回 Diagnosis(#424 範圍外) #474、feat: 討論中持續更新 issue:問題變了改正文、診斷變了改 Diagnosis 留言、補充才新增 comment #424:verify 的更正與討論的變動寫回 issue。
- feat: /idd-all 不帶參數(或 rest)— 一次把剩下的 open issue 全部解掉並結案,只在必須要人的地方停下來(#37 重提) #478:一次解掉所有 issue;每張都要寫規格的話,成本會算進那一次 run。
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
- 2026-11-10 方向:Simple 的 issue 也走
spectra propose與apply,用比較快的形式(原話「我在想是不是」;decision) - 2026-11-10 方向:「不改變行為、所以不寫規格」要經過 audit 才成立(原話「或許需要audit」;decision)
- 2026-11-10 audit 的做法(維護者交給 Claude 選):規格 → 程式用 spectra-verify;程式 → 規格用 idd-verify 的 Regression lens 對照 spec delta;不用
spectra drift,不新增種類(decision) - 2026-11-10 方向:每一條 requirement 附一個可執行的檢查(Spectra 的 Example 加對應的測試);寫不出檢查的要明寫理由並由 verify 審,不接受搜尋字串充當檢查(decision)
- Complexity = Spectra → 下一步
/spectra-discuss(Diagnosis) - Conflict Class = C_shared_module_coord(
idd-all、idd-verify的 SKILL.md 與rules/sdd-integration.md,與 feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392、refactor: 人的工作記憶是稀缺資源 — 只留四個入口,背景 skill 設 user-invocable: false,idd-all 預設 chain #457 共用) - 2026-11-10:feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 先進 main,這張在那之前只做診斷與規格提案(feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 comment 6761657951)
- 2026-11-10 討論議程前四項(decision):沒有 Spectra 時,自己的 repo 停下並給安裝指令、第三方 clone 不寫規格;只管新增或改到的 requirement;保留 IDD 自己的 wrapper(
/idd-plan不被 proposal 取代);接受每張 issue 一個 change 目錄 - 2026-11-10 規格提案:Spectra change
spec-on-every-issue,在 branchidd/480-spec-on-every-issue(摘要);2026-11-11 實作完成,封存在3eaa895 - 2026-11-11 維護者決定現在開工(feat: idd-all 在 verify 乾淨通過後自己 merge 並 close,結束時回報(Foresay traceable:可逆操作先做再回報) #392 已在 3.7.0);原列的 idd-all Phase 3b:在 idd worktree 裡呼叫 spectra,change 落在主 checkout(.spectra.yaml worktree: true) #462、spectra-archive-post-ic:tasks.md 太長時貼不出 Implementation Complete (sister bug from #405) #475、openspec change add-privacy-scrubbing-gate 未封存:privacy-scrubbing-gate spec 不在 openspec/specs、Phase 2 task 未勾 (sister concern from #421) #433 前提是 Claude 的建議,與這份 change 的關係見 note
- 2026-11-11 維護者決定:attended Plan(task 3.3)只用契約測試驗收;sandbox 的 main 可以跑
spectra init做端到端驗收 - 2026-11-11 verify 第 1 輪(未貼出報告:headless run 在 Regression 回來前結束)的 HIGH 與 MEDIUM 以 change
idd-480-fix1修正並封存(契約第 7 步) - 2026-11-11 verify 第 2 至 4 輪的 Blocking 與範圍內 finding 以 change
idd-480-fix2、idd-480-fix3、idd-480-fix4修正並封存(第 4 輪有 2 項 HIGH) - 2026-11-11 verify 第 5 輪(1 項 HIGH:核准前的 plan 被當成已核准)以 change
idd-480-fix5修正並封存 - 2026-11-11 維護者決定:verify 第 6 輪起報告沒有 HIGH,剩下的 MEDIUM/LOW 各開 follow-up,PR feat: every implemented issue leaves a spec change or a declared exemption (#480) #490 就合併、結案(decision)
- 2026-11-11 verify 第 6 輪(1 項 HIGH:Plan tier 核准的不一定是 apply 的那一份)以 change
idd-480-fix6修正並封存 - 2026-11-11 維護者決定縮小範圍:attended Plan tier 只核准 Implementation Plan,
idd-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(decision)。verify 第 7 輪的 HIGH 以 changeidd-480-fix7照這個決定處理並封存 - 2026-11-11 verify 第 6 輪 FAIL:1 項 HIGH(Plan 核准沒涵蓋實際 apply 的 proposal 與 tasks)、9 項 In-scope fix、10 項 Follow-up(報告)
- 2026-11-11 verify 第 7 輪 FAIL:1 項 HIGH(Revised 在 plan mode 裡改不了 change 的檔案,核准的可能不是 apply 的那一份)、13 項 In-scope fix、7 項 Follow-up 都已有追蹤(報告)
- 2026-11-11 verify 第 8 輪 PASS:0 blocking、5 項 In-scope fix(3 MEDIUM、1 LOW、1 INFO)、3 項 Follow-up、2 項 Rejected;Codex 的 1 項 HIGH 判為不成立,成不成立由維護者決定(報告)
- 2026-11-11 維護者決定:第 8 輪第 1 列照不成立處理(base 與 head 對直接呼叫 Plan-tier issue 問的是同一個問題,只是提前到 propose 之前),第 2 到 5 列開成 [enhancement] spec-on-every-issue: round-8 in-scope MEDIUM/LOW left after #480 (Aborted row wording, idd-plan lookup check, approved plan list, chain task text) #499,PR feat: every implemented issue leaves a spec change or a declared exemption (#480) #490 合併並結案(decision)
- 2026-11-11 結案:PR feat: every implemented issue leaves a spec change or a declared exemption (#480) #490 以 squash 合併為
2dc56ab(branch 保留);idd-closeStep 1.57 對合併後的 main 印pass - 2026-11-11 發佈:維護者決定版本號是 4.0.0(改動很大;先前稱為 3.8.0 的就是這一版)。
fdf8d0dchore: release 4.0.0 已在 main,遠端 CI 通過
Scope Changes
- Sister concerns 已開 issue:五個已完成的 Spectra change 沒有封存,主規格缺它們的 delta (sister concern from #480) #482
- 補齊既有 requirement 的 Example 與檢查:不在這張,之後另開(等連結的寫法定下來)
- 實作中加入 task 2.6:規格目錄照 Spectra 的規則從
.spectra.yaml的spec_dir讀(Spectra 3 新 repo 預設docs/spectra) - 後續另開:[enhancement] 既有的 requirement 補上 Example 與帶標記的測試 (follow-up from #480) #487(既有 requirement 補 Example 與檢查)、[enhancement] 主工作樹被佔用時,要寫規格的 issue 改用獨立 clone 隔離 (follow-up from #480) #488(獨立 clone 隔離)、bug: a | inside a verify report table cell shifts the columns and the verify gate reads the report as unparseable #489(verify 報告表格的
|) - 第 1 輪沒修的設計層 MEDIUM 與 LOW 另開 [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
- 第 2 輪 follow-up:[enhancement] spec preflight: Spectra is not a declared dependency and the preflight does not check the Spectra skills (follow-up from #480) #492(Spectra 未宣告為依賴、preflight 不檢查 Spectra skills);其餘歸 [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 或屬既定設計
- 第 3 輪 follow-up:spec-change.py: links 與 archived 從受審的 revision 讀 .spectra.yaml,diff 可以把 spec_dir 指到別的目錄 #493(gate 從受審的 revision 讀
.spectra.yaml)、idd-close Step 1.55/1.57 用 GITHUB_REPO 取預設 branch,卻從 origin fetch #494(預設 branch 取自GITHUB_REPO、fetch 自origin) - 第 5 輪 follow-up 記在既有 issue:[enhancement] 主工作樹被佔用時,要寫規格的 issue 改用獨立 clone 隔離 (follow-up from #480) #488(spectra 不跟
--cwd)、[enhancement] 既有的 requirement 補上 Example 與帶標記的測試 (follow-up from #480) #487(code profile「byte-identical」的舊說法)、spec-change.py: links 與 archived 從受審的 revision 讀 .spectra.yaml,diff 可以把 spec_dir 指到別的目錄 #493(引號內spec_dir的空白與 escape)、[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(**Spec plan**:行的信任、allowed-tools) - 第 6 輪 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(範圍內的 MEDIUM/LOW 七項)、follow-up(#480 r6): spec-change 與修正輪的四項小缺口(marker 副檔名、安裝提示、git grep 切分、修正輪 plan 留言) #495(四項 INFO);其餘記在 [enhancement] 既有的 requirement 補上 Example 與帶標記的測試 (follow-up from #480) #487、[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、spec-change.py: links 與 archived 從受審的 revision 讀 .spectra.yaml,diff 可以把 spec_dir 指到別的目錄 #493、idd-close Step 1.55/1.57 用 GITHUB_REPO 取預設 branch,卻從 origin fetch #494
- 第 7 輪:在 plan mode 核准 Spectra proposal 本身另開 [enhancement] idd-plan: approve the Spectra proposal itself in plan mode, bound to the files that are applied (follow-up from #480) #497;其餘 follow-up 記在 [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、spec-change.py: links 與 archived 從受審的 revision 讀 .spectra.yaml,diff 可以把 spec_dir 指到別的目錄 #493、idd-close Step 1.55/1.57 用 GITHUB_REPO 取預設 branch,卻從 origin fetch #494、[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
- 第 8 輪 follow-up:[enhancement] spec-on-every-issue: round-8 in-scope MEDIUM/LOW left after #480 (Aborted row wording, idd-plan lookup check, approved plan list, chain task text) #499(範圍內的 3 項 MEDIUM、1 項 LOW)、idd-verify: the external-writes collector picks up audit-trail headings quoted inside other comments and code fences #498(verify 的外部寫入收集器把引用在別的留言裡的 audit-trail 標題當成紀錄);其餘記在 [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、[enhancement] idd-plan: approve the Spectra proposal itself in plan mode, bound to the files that are applied (follow-up from #480) #497
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 --refPR 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-closeStep 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-allPhase 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-allStep 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-closeStep 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-closeStep 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-implementStep 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那列回invalidexit 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
fdf8d0dchore: release 4.0.02dc56abfeat: every implemented issue leaves a spec change or a declared exemption (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480) (feat: every implemented issue leaves a spec change or a declared exemption (#480) #490)(main 上的 squash;以下是 branch 上的 commit)87bd9d0chore: archive idd-480-fix7 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)e3c7f17fix: what spectra-verify found on idd-480-fix7 before its archive (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)f5b6199refactor: the attended Plan tier approves the Implementation Plan, idd-implement proposes (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)220aa7fchore: archive idd-480-fix6 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)44bf701fix: what spectra-verify found on idd-480-fix6 before its archive (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)154d337fix: a Plan-tier approval covers the change's own files (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)b6bb63bchore: archive idd-480-fix5 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)c0008cdfix: idd-plan is the approval path for any open change that is not approved (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)bbd440bfix: verify round 5 of feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 — a plan is proposed before it is approved, NUL-separated paths (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)f089db8chore: archive idd-480-fix4 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)ab19635fix: a rejected plan is never applied, and the Plan question comes before the propose (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)fee863cfix: verify round 4 of feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 — keep the Plan routing question, the Spec plan line, unquoted paths (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)93f8991chore: archive idd-480-fix3 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)fd2a1d0fix: what spectra-verify found on idd-480-fix3 before its archive (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)0149a10fix: verify round 3 of feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 — one fence rule for declared and links, literal paths, the fetched commit (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)6758bf3chore: archive idd-480-fix2 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)0d40363fix: what spectra-verify found on idd-480-fix2 before its archive (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)83e93a6fix: verify round 2 of feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 — fences and duplicate names in links, stop on any preflight failure, fenced spec data (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)90f1b5achore: archive idd-480-fix1 (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480)
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request
Activity
kiki830621 commentedon Nov 10, 2026
🎯 Decision
決定
方向(原話是「我在想是不是」,還不是定案):Simple 的 issue 也走
spectra propose與apply,用比較快的形式。不另外做一條只寫規格的路。Rationale
Claude 的看法:贊成,理由三個。
Spectra 3.0.0 現有的支援(查過 CLI):
spec-driven是 proposal → specs → tasks,design 本來就是選用。no-spec(proposal → tasks),也可以自訂 workflow(spectra schema init、fork)。所以「更快」可以用 Spectra 自己的設定做到:Simple 跳過 discuss 與 design,只留短的 proposal、一條 requirement 的 spec delta、幾項 task。
要先處理的兩件事:
no-spec;不然規格會被湊數的 requirement 塞滿。Related
#423、#462、#475、#433、#252、#478
kiki830621 commentedon Nov 10, 2026
🎯 Decision
決定
方向(原話是「或許」):「不改變行為」不能只由做的人自己宣告,要經過一道 audit。
Rationale
Claude 的解讀,診斷時確認:
audit(.spectra.yaml的audit: true與 spectra-audit)審的是 diff 裡的安全陷阱(危險的預設值、型別混淆、無聲失敗),不回答「這個改動有沒有改變行為」。比較接近的是spectra drift與 spectra-verify。所以這道 audit 用哪一個,或要不要新增一種,是這張要定的事。Related
#423
kiki830621 commentedon Nov 10, 2026
🎯 Decision
決定
維護者交給 Claude 選。選擇:不新增 audit 的種類,也不用
spectra drift。兩個方向各用一個現成的:「不改變行為」的 issue 就是 spec delta 為空的情況:Regression lens 在 diff 裡找到任何行為改動,就是 HIGH。
Rationale
三個候選各自回答的問題(讀過 CLI 說明與 skill 內容):
spectra drift:計畫寫好之後,程式有沒有變到讓計畫過時(擱置時間、design 裡失效的參照、task 與外部 commit 相撞)。它問的是計畫,不是這次的改動。選這個組合的理由:
spectra scope --change取得(唯讀,輸出這個 change 的實作 patch),IDD 不必自己算。代價:這個檢查跟 Regression lens 的判斷一樣好,不是機械保證。
Related
#423
kiki830621 commentedon Nov 10, 2026
🎯 Decision
決定
方向(原話是問句):每一條 requirement 都附一個可執行的檢查。Claude 的看法是贊成,加一條例外的處理方式,寫在下面。
Rationale
現況(2026-11-10,main):
Spectra 已經有這個位置:規格裡的 Example(給定輸入與預期結果),spectra-verify 會檢查每個 Example 有沒有用同一組輸入的測試。規則可以寫成「每條 requirement 至少一個 Example,每個 Example 有一個測試」,不必另外發明格式。
例外的處理(Claude 的建議):IDD 有很多行為寫在 SKILL.md 裡、由模型照著做(例如「這時要問使用者」)。這一類寫不出確定性的檢查。
寫不出檢查,通常表示那一步該從 SKILL.md 的文字搬進程式。這跟 #479 第 3 項(SKILL.md 太大、裡面的 bash 照著跑會出錯)是同一個方向。
成本:程式的部分本來就先寫測試,多出來的是 requirement 與測試之間的連結。
Related
#423、#479、#387、#428、#433
kiki830621 commentedon Nov 10, 2026
Diagnosis
Type
feature
Root Cause / Analysis
需求拆解(依 issue 正文與四則 Decision comment):
openspec/specs/,不論 tier。spectra propose與apply,用比較快的形式。現況(main,
dc64efa):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 是其中一個沒封存的)。spec-driven是 proposal → specs → tasks,design 是選用;另有no-spec,也可以自訂 workflow。所以「更快的形式」不必另外發明。spectraCLI 就中止。每一張都要寫規格之後,這道依賴會擴到每一張 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。openspec/的與第三方的 clone。/idd-all的每一張都會經過 Spectra。Strategy
走
/spectra-discuss,議程如下。前四項要維護者決定,後三項有明確的做法、討論時確認即可。openspec/)。停下並給安裝指令(品質一致,但所有 repo 都得先裝 Spectra),或照現在的方式跑、不寫規格(不擋路,但規則變成「有裝才有」)。/idd-plan。proposal 本身就是計畫:保留/idd-plan的核准,或讓 proposal 取代它,tier 只決定要不要 discuss 與 design。spec-driven、跳過 discuss 與 design,還是 fork 一個 IDD 專用的 workflow。分段(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
/idd-all、/idd-issue之後會發生什麼),要寫成規格。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
openspec/specs/,Simple 也走spectra propose與apply(issue 正文 Expected 兩項與 Decision comment 6760232879)Sister Concerns Filed (mid-diagnose, v2.47.0+ #528)
spectra list發現;與 openspec change add-privacy-scrubbing-gate 未封存:privacy-scrubbing-gate spec 不在 openspec/specs、Phase 2 task 未勾 (sister concern from #421) #433 不同:那是一個還在進行的 change)kiki830621 commentedon Nov 10, 2026
📊 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
kiki830621 commentedon Nov 10, 2026
🎯 Decision
決定
openspec/放進別人的 repo)/idd-planRationale
第 3 項是維護者的選擇,與 Claude 的建議(讓 proposal 取代
/idd-plan)不同。Claude 對第 3 項的解讀,規格提案時確認:
/idd-plan留著,Plan tier 仍由它進入;它裡面去呼叫 Spectra 的 propose 來產生規格與 task,核准的動作留在 IDD 這一層。idd-all直接依賴 Spectra 那兩個 skill 的介面。之後 Spectra 改了、或 IDD 想換做法,只改 wrapper。第 2 項的「另開一張」還沒有開:等這張的規格提案定下「Example 與檢查怎麼連結」之後再開,否則補的格式會跟之後的規定不一樣。
Related
#423、#482
kiki830621 commentedon Nov 10, 2026
規格提案:Spectra change
spec-on-every-issue提案在 branch
idd/480-spec-on-every-issue(commite57163e)。只有提案,沒有實作;實作等 #392 進 main。spectra validate通過,spectra analyze沒有 finding。做法
idd-implement包住輕量的 propose(不做 discuss、不寫 design)、apply 與收尾idd-plan留著:attended 時在 plan mode 核准 proposal 與 tasks,再交給idd-implement。共用的步驟寫在一份references/spec-wrapper.mdidd-<N>-<slug>;在 branch 上、verify 之前封存,被審查的 commit 就帶著套用後的規格verify 之後的修正也走同一條路:Blocking 的修正要留下一條寫出該性質的 requirement、Example 與修正前會失敗的測試。這是 #423 的對策落在這張的部分;停止條件本身仍在 #423。
Claude 自己定的兩個預設
維護者沒有決定過,提案先這樣寫:
寫提案時發現的限制
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 之後的修正)。
kiki830621 commentedon Nov 10, 2026
🎯 Decision
決定
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)
kiki830621 commentedon Nov 10, 2026
📝 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 的關係如下:
spec-change.py preflight,在 linked worktree 裡回linked-worktree並停下,不建任何 artifact。結果是停下,不是寫錯地方,所以不會被放大。完整的修正仍在 idd-all Phase 3b:在 idd worktree 裡呼叫 spectra,change 落在主 checkout(.spectra.yaml worktree: true) #462 與 [enhancement] 主工作樹被佔用時,要寫規格的 issue 改用獨立 clone 隔離 (follow-up from #480) #488(改用獨立 clone 隔離)。.claude/skills/spectra-archive與.claude/scripts/spectra-archive-post-ic.sh。plugin 的新流程照references/spec-wrapper.md直接跑spectra archive,Implementation Complete 由 wrapper 貼,不經過那支腳本,所以不受影響。add-privacy-scrubbing-gate沒有封存):是既有的資料。新加的idd-closeStep 1.57 會擋住以後的同類情況,但不會回頭處理這一個。所以這三張我不當作 #480 結案的前提,各自照原本的 issue 處理。要改回「先修再結案」,告訴我就好。
kiki830621 commentedon Nov 10, 2026
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 之前封存。**Spec**::change <名稱>、no behaviour change(封閉的四種)、third-party clone。idd-verify(code profile)把宣告、範圍內改到的規格檔、兩個檢查的結果交給每個 reviewer。沒有 requirement 的行為改動是 HIGH,不成立的no behaviour change是 HIGH,檢查的缺漏與讀不到宣告是 Blocking。idd-closeStep 1.57:宣告的 change 沒有封存在預設 branch 上就不關。idd-<N>-fix<k>。驗證
spec-change265、spec-wrapper-contract87、spec-close-gate16,以及讀到改動檔案的其他 suite 全過;完整的 73 個 suite 在afc2c67全過,最後的 head 由 PR 的 CI 重跑。tasks.md;attended Plan(3.3)依維護者的決定只用契約測試驗收。spectra-verify:1 項 critical、10 項 warning,都在2f0f97f修掉。實作中找到並修掉的
---,links因此把前一條當成改過(7a3fbc1)。spectra-propose會 park change,spectra-apply碰到 parked 的 change 會發問;無人值守時沒有人回答(644b1c1)。archive/底下的檔案(2f0f97f)。另開的 issue
|時,gate 讀不出報告chore: merge main (3.7.0: #392, #424) into the #480 branch (#480)
docs: task 1.1 — the proposal re-checked against 3.7.0 (#480)
feat: scripts/spec-change.py — declared, archived, links and prefligh…
48 remaining items
kiki830621 commentedon Nov 11, 2026
Follow-up Findings Filed (v2.72.0+ #148)
第 7 輪 verify(報告)的 7 項範圍外 findings 都已有追蹤的 issue,這一輪沒有另開新的:
第 1 列 HIGH 是 Blocking,照契約第 7 步由下一個修正輪處理;第 2 到 14 列是 In-scope fix,會不會也在那一輪修,依 2026-11-11 的決定由修正輪的 plan 寫明。
kiki830621 commentedon Nov 11, 2026
Decision: attended Plan tier approves the Implementation Plan, not the proposal
(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 的那一半。kiki830621 commentedon Nov 11, 2026
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_filestask;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。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的列)。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。refactor: the attended Plan tier approves the Implementation Plan, id…
fix: what spectra-verify found on idd-480-fix7 before its archive (#480)
chore: archive idd-480-fix7 (#480)
kiki830621 commentedon Nov 11, 2026
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 輪改了什麼
idd-plan在 plan mode 只核准 Implementation Plan,不 propose;要寫規格時 plan 行在進 plan mode 前寫proposed (change idd-<N>-<slug>),核准後改change <名稱>,把名稱交給idd-implement,由它用輕量形式 propose、apply、收尾,與 Simple tier 相同。在 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。idd-plan的事前 propose、Step 3.5、附 change 檔案的說明與範本、read_change_filestask;rejected寫法(spec-change.py plan把它讀成invalid,這個寫法沒有發布過);契約第 3 步的rejected那一支與「idd-plan會先建好」。規格 REMOVED fix6 那條 requirement,MODIFIED wrapper 那條。idd-plan的 Revised 列與 Revise 說明回到 feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 之前的寫法。Aborted 列是 feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 之前的文字,另外保留 feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480 加的一句(要寫規格的 code issue,plan 行留在proposed);那一句對idd-implement的描述只在這張 issue 有開著的 change 時成立(verify 第 8 輪第 2 列)。「Plan tier 不會產出 spec/proposal/tasks artifacts」改成「只留下輕量形式的 change」。rules/sdd-integration.md的 Plan 流程、idd-diagnose的 route 表、CHANGELOG 改成核准 Implementation Plan、propose 在idd-implement。idd-edit --correct補上 [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(第 7 輪 Complexity routing: vagueness 應該是一階信號,但目前 4 層 gate 都沒衡量需求清晰度 #12)。spectra-verify沒有 critical,4 項 warning 在同一個 change 修掉:README 不再說idd-plan呈現 proposal;idd-plan用spectra list找這張 issue 開著的 change(allowed-tools加Bash(spectra:*)),規格寫明它不跑第 3 步的檢查;Step 6 的範例帶--spec-change,流程圖改成idd-implement在 Step 2 propose;spec-wrapper-contract/test.sh在f5b6199被我誤貼成兩份(前一份載入的計數會被後一份重設),現在只留一份。更正於 2026-11-11:Aborted 列保留了 #480 加的一句(plan 行留在 proposed),不是整列回到 #480 之前
驗證
spec-change428、spec-wrapper-contract238,新的檢查先看到失敗(25 個,加上 spectra-verify 那一輪 7 個);讀到改動檔案的 31 個 suite 全過。沒修、另開的
rejected上,隨它們一起拿掉;[refactor] idd-list PR body parsing: ignore #N inside fenced code blocks (sister concern from #13) #14 隨 wrapper requirement 的修改處理;[enhancement] idd-list cluster_leader config (lowest | primary) (sister concern from #13) #15 到 feat(idd-issue): bundle flags — --parent / --blocked-by / --bundle-mode for ordered/unordered issue bundles #21 已記在 [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、spec-change.py: links 與 archived 從受審的 revision 讀 .spectra.yaml,diff 可以把 spec_dir 指到別的目錄 #493、idd-close Step 1.55/1.57 用 GITHUB_REPO 取預設 branch,卻從 origin fetch #494、[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。kiki830621 commentedon Nov 11, 2026
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.sh73 個 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(合併後)
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-planAborted 列沒有任何 guard,idd-implement只在直接呼叫 Plan-tier issue 時詢問;(c) Codex 的兩條重現路徑:Simple issue 本來不需要核准;idd-allattended 的 Plan tier 一律經 Phase 3p 走/idd-plan(idd-all/SKILL.md:673),只有 unattended 直送idd-implement,那是規格刻意允許的。真正錯的是文字,見第 2 列;要加真的 guard 歸 #496skills/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 afteridd-planhas writtenchange <name>」沒有 SHALL、又比同段其他句子寬,限縮到經idd-plan的 attended run。fix7 的 Implementation Complete 對 Aborted 列的描述也要更正,見 Proposed Correctionsspec.md:98的No executable check:把「idd-plan's lookup of an open change」列為免檢查,但理由不成立:那是兩次spectra list加名稱過濾,讀不到或不是 JSON 就停,與契約第 3 步已用固定 bash 並有測試的做法相同,寫得出檢查。現在idd-plan:140只有散文,讀不到就停的行為若退化不會被發現。改成固定 bash 並加測試,或把這一項從免檢查清單拿掉並給 Exampleskills/idd-implement/SKILL.md:428,434要求 propose 之後把 Implementation Plan 的清單改成 change 的 tasks(改自己的留言),這也套用到從idd-plan來的路徑(:431)。fix7 之後那則留言是維護者核准的唯一紀錄,這樣做會把核准過的清單換成沒人核准過的 Spectra tasks。從idd-plan來的路徑改成把 tasks 附加在後面或另貼一則留言skills/idd-plan/SKILL.md:53的chain_to_idd_implementtask 仍說idd-implement跳過 Step 2,與 Step 6 及流程圖(帶--spec-change時在 Step 2 propose)矛盾。測試只擋字面上的Step 2: SKIP,所以這一行漏掉了idd-planpropose、在 plan mode 核准 proposal)。用/idd-update標成被 fix7 取代idd-implement --spec-change <名稱>不檢查名稱格式,也不比對核准的change <名稱>;Approved 列改 plan 行失敗時仍會 propose,紀錄停在proposed,中斷的話重跑會停在第 3 步、要再核准一次;手打--spec-change也會跳過spec.md:96要求的/idd-plan詢問。與 #496 第 3 項同根idd-plan在 plan 行點名它,plan mode 只呈現 Implementation Plan,核准後idd-implementapply 的是 branch 上既有、維護者沒看過的 proposal 與 spec delta。spec.md:96已寫明在 plan mode 核准 proposal 屬 #497,所以是第 7 輪 HIGH 刻意延後的那一半### Follow-up Findings Filed段落(含多餘的 code fence 與</details>)當成紀錄抓進來:它不理會 code fence,引用在別的留言裡的標題也會被當成 audit-trail。是 #315 收集器的問題,不屬 #480</details>與一句像指示的文字,建議重跑/idd-edit --correct。不成立:DA 與 coordinator 重新抓取這則留言,裡面沒有</details>、code fence 或那句話;那些內容是收集器從第 7 輪報告抓進 context 的(第 9 列)Scope Check
fix7 動到的 15 個檔案都屬 #480;新增的只有
idd-planallowed-tools的Bash(spectra:*),Spectra 的依賴宣告已在 #492 追蹤。拿掉的rejected寫法沒有發布過(CHANGELOG 仍在 unreleased),舊的rejectedplan 行讀成invalid,第 3 步會停下並指向/idd-plan,失敗方向是安全的。外部寫入(#482、#492 到 #494、#487、#488、#491、#496 的 follow-up 紀錄)與 diff 的內容一致,沒有發現指示性文字。Proposed Corrections
idd-planRevised、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,不在這張表。kiki830621 commentedon Nov 11, 2026
Follow-up Findings Filed (v2.72.0+ #148)
第 8 輪 verify(報告)的範圍外 findings:
kiki830621 commentedon Nov 11, 2026
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 head87bd9d0的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。
feat: every implemented issue leaves a spec change or a declared exem…
kiki830621 commentedon Nov 11, 2026
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
**Spec**::change <名稱>、no behaviour change(封閉列舉的四種情況)或third-party clone。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。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 上封存就不結案。idd-<N>-fix<k>。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
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。03f5559..87bd9d0。Codex 提的 1 項 HIGH 在報告裡判為不成立,維護者認可這個判定並決定合併(decision)。這次合併依維護者的決定執行,沒有經過 close stage 的 gate。spec-change428、spec-wrapper-contract238、spec-close-gate29 個檢查。第 8 輪在87bd9d0跑完整的run-all-tests.sh,73 個 suite 全過;PR 的 CI 在同一個 commit 通過。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,判為誤報。Changes
2dc56abfeat: every implemented issue leaves a spec change or a declared exemption (feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480) (feat: every implemented issue leaves a spec change or a declared exemption (#480) #490):PR feat: every implemented issue leaves a spec change or a declared exemption (#480) #490 的 squash,branchidd/480-spec-on-every-issue上 36 個 commit、60 個檔案;branch 保留。openspec/changes/archive/底下的2026-11-11-spec-on-every-issue與2026-11-11-idd-480-fix1到2026-11-11-idd-480-fix7。另開的 issue
|)。Residue Acknowledgement
Filed: #423。Diagnosis 的 residue 是「這張提供的是機制,不是『verify 之後不再出現 HIGH』的保證」。保證本身(停止條件與估計還沒找到的缺陷數)在診斷時就指向 #423,那張仍開著,沒有另開。
Distribution Sync
fdf8d0dchore: 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 相同)。chore: release 4.0.0
chore: release 4.0.1