Repository navigation
Description
Problem
plugins/issue-driven-dev/skills/idd-close/SKILL.md 對 doc-sync 檢查在什麼時候做,有兩個互相衝突的說法(4.0.0):
- Step 6.3 的「位置」寫:closing summary 已 publish、
gh issue close之前。 - Step 4 在同一個 bash 區塊裡貼出結案摘要,接著
gh issue close。Step 6.3 的編號排在 Step 4、Step 5、Step 6 之後。
照步驟的順序跑,到 Step 6.3 時 issue 已經關了。照「位置」那一句跑,就要把 Step 4 的區塊拆成兩半,而 skill 沒有這樣寫。
連帶的差別:Step 3.5(follow-up 關鍵字)與 Step 3.6(Residue)的結果是在貼出之前寫進草稿;Step 6.3(過時但無法自動判定時)與 Step 6.5(distribution sync)的結果則是貼出之後再 PATCH 追加到同一則摘要。結案摘要貼出時會通知關注者,之後才追加的段落不在那次通知裡。
Type
bug
Expected
兩處說法一致,執行的人不必自己決定順序。動手之前要先選一個做法:
- 把 Step 6.3 的「位置」改成「issue 關閉之後」,與編號一致;或
- 把 doc-sync 檢查(以及結果在結案時就能確定的 distribution sync 紀錄)移到貼出摘要之前,結果直接寫進草稿,與 Step 3.5、3.6 相同,少一次事後 PATCH。
Step 0.5 的 TaskCreate 清單順序跟著調整。
Actual
兩個說法並存。/idd-close #499 那次採用的是第二個做法:貼出之前做 doc-sync 檢查,把 ### Doc-sync 檢查 與 ### Distribution Sync 直接寫進摘要,沒有事後 PATCH。這是執行時自己決定的,skill 沒有這樣寫。
Impact
plugins/issue-driven-dev/skills/idd-close/SKILL.md(Step 0.5 的清單、Step 4、Step 6.3、Step 6.5),以及讀這些步驟的測試(例如 doc-sync-sweep)。
Source: /idd-close #499(2026-11-11)。
Clarity Surface(idd-clarify run 2026-11-11T12:38:34Z)
| Type | Source | Question for you | Status |
|---|---|---|---|
| ambiguity | "動手之前要先選一個做法" | doc-sync 檢查要留在 issue 關閉之後(只改「位置」那一句),還是移到貼出摘要之前、結果直接寫進草稿? | resolved @ 2026-11-11T13:57:58Z (reason: 留在關閉之後,只改「位置」那一句;decision) |
Current Status
Phase: closed
Last updated: 2026-11-12 by idd-close
Dashboard: #512 (comment)
Key Decisions
- 2026-11-11 維護者決定:doc-sync 檢查留在 issue 關閉之後,只改「位置」那一句(decision)
- 2026-11-12 診斷:Complexity Simple;只有 Step 6.3 的「位置」那一句與步驟順序、清單、Step 4 不一致,沒有檢查比對;改那一句並加檢查與一條 requirement(Diagnosis)
- 2026-11-12 實作:寫規格(新 capability
idd-close-doc-sync,changeidd-512-doc-sync-after-close已封存);那一句改成說狀態,--retroactive模式下也成立;該模式跑不跑這一步另開 [bug] idd-close --retroactive: the table does not say what happens to Step 1.55, 3.5, 3.6, 6.3 and 6.8 (found during #512) #521(plan、Implementation Complete) - 2026-11-12 verify 第 1 輪:PASS,0 blocking;四列 LOW/INFO 不在這條 branch 上改,記在 [enhancement] doc-sync position check: LOW and INFO findings left by the verify of #512 (follow-up from #512) #522(報告)
- 2026-11-12 結案:PR fix: say in one way where idd-close's doc-sync sweep sits (#512) #523 以 squash 合併成
ecb36fb(Closing Summary)
Scope Changes
- 2026-11-12
--retroactive的表沒有寫幾個步驟怎麼處理,不在這張做,另開 [bug] idd-close --retroactive: the table does not say what happens to Step 1.55, 3.5, 3.6, 6.3 and 6.8 (found during #512) #521
Blocking
- (none)
Commits
e8f221ffix: say in one way where idd-close's doc-sync sweep sits ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)a1a3ccfchore: archive idd-512-doc-sync-after-close ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)054c17etest: exercise each condition of the doc-sync position check ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)ecb36fbfix: say in one way where idd-close's doc-sync sweep sits ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512) (fix: say in one way where idd-close's doc-sync sweep sits (#512) #523) — squash merge on main
Activity
kiki830621 commentedon Nov 11, 2026
🎯 Decision
問的是:doc-sync 檢查要留在 issue 關閉之後(只改「位置」那一句),還是移到貼出摘要之前、結果直接寫進草稿。
決定
doc-sync 檢查留在 issue 關閉之後。只改 Step 6.3「位置」那一句,讓它與步驟的編號一致;不把檢查移到貼出摘要之前。
Rationale
維護者沒有另外說明理由。以下是這個選擇對實作的含義,由記錄的人整理。Step 4 的區塊不拆,貼出摘要後接著關閉。Step 6.3 與 Step 6.5 的結果照舊在貼出之後追加到結案摘要。
/idd-close #499那次在貼出之前做檢查的做法不成為規定。kiki830621 commentedon Nov 12, 2026
Diagnosis
Type
bug(label
bug)Root Cause / Analysis
我認為 root cause 是:Step 6.3 加進
idd-close的時候(commit1b5c02d,#220,2026-07-06),「位置」那一句寫的是原本的打算(摘要貼出之後、關閉之前),但這一步實際被放在 Step 4、Step 5、Step 6 之後,而 Step 4 在同一個 bash 區塊裡先貼摘要、再關閉 issue。沒有任何檢查比對這兩件事,所以矛盾一直留著。證據(
plugins/issue-driven-dev/skills/idd-close/SKILL.md,005531b):gh issue close之前。gh issue close。兩者在同一個區塊,中間沒有可以插入別的步驟的地方。publish_and_close→auto_update_body→doc_sync_sweep→distribution_sync_chain_detection。### Doc-sync 檢查追加到結案摘要。scripts/tests/doc-sync-sweep/test.sh只檢查標題與 task 名稱存在(第 23、24 行),不檢查位置。所以只有「位置」那一句與其他四處不一致。照步驟順序跑的執行者,到 Step 6.3 時 issue 已經關了。
規格:沒有任何 capability 寫到這一步在什麼時候做(
idd-pr-hitl-modes只寫了被/idd-all呼叫時過時文件的處置)。Existing work
unknown:查詢已 merge 的 PR 時到達上限(100 筆),更早的沒有檢查到。open 的 PR 與 branch 沒有引用這張的。
Impact
plugins/issue-driven-dev/skills/idd-close/SKILL.md(一句)、plugins/issue-driven-dev/scripts/tests/doc-sync-sweep/test.sh(加檢查)、規格(新增一條 requirement)、plugins/issue-driven-dev/CHANGELOG.md。Strategy
維護者已決定(2026-11-11):doc-sync 檢查留在 issue 關閉之後,只改「位置」那一句,不把檢查移到貼出摘要之前。
doc-sync-sweep):「位置」那一句說的是關閉之後;檔案裡gh issue close那一行在 Step 6.3 的標題之前、Step 6.3 在 Step 6.5 之前;Step 0.5 的清單裡publish_and_close在doc_sync_sweep之前、doc_sync_sweep在distribution_sync_chain_detection之前idd-closeStep 6.3 的「位置」那一句[Unreleased]的 Fixed 條目doc-sync-sweep與整套測試Conflict Class
A_parallel_safe
各檔各自獨立,沒有共享的可變資源。
idd-close/SKILL.md與 CHANGELOG 的[Unreleased]可能與其他進行中的 PR 改到相鄰的行,這一批是一張一張依序做。Complexity
Simple
Layer 1 未命中(skill 的文字會被執行,不算純文件);Layer 2 未命中(不新增對外介面)。Layer P 沒有訊號:做法已由維護者決定,檔案之間沒有順序依賴。
Hard-gate: not triggered — 估計動 4 個檔(
idd-close/SKILL.md、doc-sync-sweep/test.sh、一份規格、CHANGELOG.md),不動任何被其他檔案引用的共用抽象。Risks
Residue
(none)
Vagueness Pre-check
Sister Concerns Filed (mid-diagnose)
(none surfaced)
kiki830621 commentedon Nov 12, 2026
📊 For Reviewer / Collaborator
現在:已結案。
idd-closeStep 6.3 的「位置」那一句原本說 doc-sync 檢查在關閉之前做,與步驟順序矛盾;現在改成說 issue 已關閉、結案摘要已貼出之後才做,並加了規格與測試(Closing Summary)。Blocking:無。
你該做什麼:無。
last-updated by idd-close at → closed, 2026-11-12
kiki830621 commentedon Nov 12, 2026
Implementation Plan
Spec plan: change idd-512-doc-sync-after-close
這張改的是 skill 的文字,照那一句執行的人跑的步驟順序會不同,所以寫規格:新的 capability
idd-close-doc-sync,一條 requirement,寫明 doc-sync 檢查在 issue 關閉、結案摘要貼出之後才做;idd-close的步驟順序與 Step 0.5 的清單都把它排在關閉與 body sync 之後、distribution sync 之前,Step 6.3 的「位置」那一句要說 issue 已經關閉、不得說在關閉之前。以下是 change
idd-512-doc-sync-after-close的 tasks(照tasks.md的順序)。1. 測試先行
2. skill 文字
3. 收尾
kiki830621 commentedon Nov 12, 2026
Implementation Complete
Spec: change idd-512-doc-sync-after-close
這張改的是 skill 的文字,照那一句執行的人跑的步驟順序會不同,所以寫了規格。change
idd-512-doc-sync-after-close新增 capabilityidd-close-doc-sync,一條 requirement「The doc-sync sweep runs after the issue is closed」;change 已封存,主規格在openspec/specs/idd-close-doc-sync/spec.md。Checklist (synced from tasks.md)
change
idd-512-doc-sync-after-close:Changes
e8f221ffix: say in one way where idd-close's doc-sync sweep sits ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)a1a3ccfchore: archive idd-512-doc-sync-after-close ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)054c17etest: exercise each condition of the doc-sync position check ([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)Files Changed
改了什麼
idd-closeStep 6.3 的「位置」那一句。 原本說這一步在結案摘要貼出之後、gh issue close之前。現在說:issue 已關閉、結案摘要已貼出之後(Step 4 與 Step 6 body sync 之後),Step 6.5 distribution sync 之前;到這一步時 issue 已經關了,所以它不擋結案。步驟的順序、Step 0.5 的清單、Step 4 都沒有動,照步驟順序執行的人行為不變。--retroactive模式的 Step 4 只貼摘要、不關閉(issue 本來就關了),寫成狀態在兩種模式下都成立。這個模式跑不跑 Step 6.3,表裡沒有寫,不在這張決定([bug] idd-close --retroactive: the table does not say what happens to Step 1.55, 3.5, 3.6, 6.3 and 6.8 (found during #512) #521)。doc-sync-sweep加一個讀 SKILL.md 的檢查程式,回報哪一類不一致(那一句、步驟順序、清單順序),以及十二個檢查:Example 的八列各一個,另外四個各改壞一件八列沒有單獨涵蓋的事。封存之後補的測試(最後一個 commit)
tasks 寫的是七份改壞的副本。封存 change 之後我把檢查程式的條件逐一關掉來試,發現「不得說在關閉之前」那一項沒有任何檢查是只靠它抓到的(舊的那一句同時也沒說已關閉)。所以補了四份副本:同一句又說已關閉、又說在
gh issue close之前;gh issue close那一行搬到 Step 6.3 之後;Step 6.3 的標題不見了;清單裡沒有doc_sync_sweep。同時刪掉一個永遠不會觸發的條件(關閉指令在 Step 4 裡,步驟順序對的時候它必然在 Step 6.3 之前)。規格沒有改:這四份是既有 requirement 的額外測試,Example 仍是八列,封存的 change 也沒有動。核對過的其他地方
Diagnosis 說「只有那一句不一致」。實作前把 repo 裡講到這一步的地方都讀過一次:
idd-close裡的其他幾處與「關閉之後」一致:Orchestrated close 的表(在已貼出的摘要追加一段)、Step 0.5 的 task 描述、6.3.3 的處置表(PR 已 merge、用 PATCH 追加)、Step 6.3 引用的使用者原話(「最後一步」)。idd-pr-hitl-modes的「idd-close honors the orchestrated directive from idd-all」提到 Step 6.3,寫的是過時文件怎麼處置,沒有寫位置,所以這次是新增 requirement,不是修改。先失敗的檢查與測試結果
doc-sync-sweep:當時新加的七個檢查裡六個失敗。現行的檔案被判「那一句」不一致;說在關閉之前的那份副本與現行檔案相同,做不出來;四份改順序的副本除了順序還帶著那一句的問題。原有的七個檢查通過。改了那一句之後全部通過。doc-sync-sweep現在 19 項通過(原有 7 項加 12 項)。spectra-archive-post-ic141 項通過。之後還有封存與補測試兩個 commit,在最後的 commit 上重跑了會讀到改動的檔案或規格目錄的 22 個 suite 與spectra-archive-post-ic,全部通過。merge-completeness(約 22 分鐘)用它自己建的 repo,不讀這些檔案,沒有重跑。edit-run的 168 秒(它自己的時限是 480 秒),其餘都在 180 秒以內。ok(Example 有帶標記的測試),封存檢查回pass。Scope Compliance
idd-close/SKILL.md一行、doc-sync-sweep/test.sh、CHANGELOG.md、新的規格檔、封存的 change 與附件清單。--retroactive的表([bug] idd-close --retroactive: the table does not say what happens to Step 1.55, 3.5, 3.6, 6.3 and 6.8 (found during #512) #521)。[Unreleased]條目。Sister Bugs Filed (mid-impl)
Filed: #521
idd-close --retroactive的表沒有寫 Step 1.55、3.5、3.6、6.3、6.8 在這個模式下怎麼做。核對 doc-sync 檢查的位置時發現。Next: verification pending
kiki830621 commentedon Nov 12, 2026
Verify: #512
第 1 輪。審查範圍是整條 branch(三個 commit)。
Engine
pai-ensemble 2.26.0 (canonical #207) — 4 IDD lenses + DA + Codex (gpt-6.1-sol, effort xhigh), model: opus
6 / 6 reviewers completed
Aggregate
PASS — 0 blocking, 3 in-scope fix, 1 follow-up
Reviewed:
005531b12033fff7f93eb3516f4cf5ab60701d1d..054c17e979dd594ff1a454d71e934c8877badb65要求覆蓋率
3 / 3 requirements addressed
Findings(合併後)
doc-sync-sweep依賴idd-closeSKILL.md 的幾個寫法:Step 4 的 code block 裡有一行不縮排、以gh issue close開頭的指令;五個步驟的標題各只有一個;Step 6.3 有一行以「位置」開頭而且用詞在比對的清單裡。與 doc-sync 無關的編輯(把關閉指令縮排進if、多加一個 Step 4 的標題、換一種說法)也會讓這個 suite 失敗。這正是規格要的鎖,失敗訊息會指出是哪一處;reviewer 認為這個 diff 不必改。error。相關的檢查仍然會失敗,但失敗訊息看不出是檢查程式自己壞了。查證
第 1 列:把 reviewer 舉的三句各放進 SKILL.md 的副本,用測試裡的檢查程式跑,前兩句回
ok、第三句被判那一句不一致,與 reviewer 說的相同。第 3 列:給檢查程式一個不是 UTF-8 的檔,結束碼 1、標準輸出是空的。第 4 列:讀了決定留言的 Rationale 段,寫的是「Step 6.3 與 Step 6.5 的結果照舊在貼出之後追加到結案摘要」;通知這件事寫在 issue 正文。第 2 列讀檢查程式的三組條件,與 reviewer 列的相同。DA 另外做的反駁都沒有找到新的問題:在審查的 commit 上跑
doc-sync-sweep,19 項通過;把檢查程式的八個條件逐一關掉重跑,每一個都至少讓一個檢查失敗,所以帶標記的測試確實測到 Example 的八列;repo 裡其他講到 doc-sync 的地方(Orchestrated close 的表、6.3.3 的處置表、Step 0.5 的清單、plugin 的 CLAUDE.md 與 README、idd-pr-hitl-modes的規格)都與新的那一句一致;Implementation Complete 記的 #521 與 #521 的正文相符。security 這位 reviewer 沒有意見。Codex 只做靜態審閱,沒有執行測試,沒有發現要修的問題。
規格對照(#480):宣告是
change idd-512-doc-sync-after-close,連結檢查ok,封存檢查pass。requirement 底下的「No executable check:」說的是執行時實際的步驟順序沒有檢查,requirements、regression 與 DA 三位都認為理由成立。Scope Check
diff 是
idd-closeStep 6.3 的一行、doc-sync-sweep/test.sh、CHANGELOG 的[Unreleased]條目、新的規格檔、封存的 change 與附件清單,沒有範圍外的改動。diff 之外的寫入是 Diagnosis 與 Implementation Complete 裡的 audit 紀錄,以及 #521,內容與 diff 一致。接下來
這一輪沒有 MEDIUM 以上的項目。In-scope 的三列是 LOW 或 INFO,不在這條 branch 上再改(合併的要是審過的 commit),與第 2 列一起記進一張 follow-up issue。
kiki830621 commentedon Nov 12, 2026
Follow-up Findings Filed
verify 第 1 輪(報告):
Filed: #522
fix: say in one way where idd-close's doc-sync sweep sits (#512) (#523)
kiki830621 commentedon Nov 12, 2026
Closing Summary
Problem
idd-close對 doc-sync 檢查(Step 6.3)在什麼時候做有兩個說法。Step 6.3 的「位置」那一句說在結案摘要貼出之後、gh issue close之前;Step 4 卻在同一個區塊裡貼摘要並關閉 issue,步驟的順序與 Step 0.5 的清單也都是先關閉。照那一句執行的人要自己把 Step 4 拆開,照步驟順序執行的人到 Step 6.3 時 issue 已經關了。Root Cause
Step 6.3 加進來的時候(#220),「位置」那一句寫的是當時的打算,這一步實際被放在 Step 4 與 Step 6 之後。沒有任何檢查比對這一句、步驟的順序與清單,也沒有規格寫明這一步在什麼時候做。
Solution
plugins/issue-driven-dev/skills/idd-close/SKILL.mdStep 6.3 的「位置」那一句改成:issue 已關閉、結案摘要已貼出之後(Step 4 與 Step 6 body sync 之後),Step 6.5 distribution sync 之前;到這一步時 issue 已經關了,所以它不擋結案。步驟的順序、清單、Step 4 沒有動。--retroactive模式(Step 4 只貼摘要、不關閉)也成立。idd-close-doc-sync,一條 requirement 與一張八列的 Example;changeidd-512-doc-sync-after-close已封存。doc-sync-sweep加一個讀 SKILL.md 的檢查程式,比對那一句、步驟順序與清單順序,並用十一份故意改壞的副本確認每一項都會失敗。[Unreleased]的條目,版號沒有動。Verification
doc-sync-sweep現在 19 項通過。把檢查程式的八個條件逐一關掉,每一個都至少讓一個檢查失敗。spectra-archive-post-ic141 項通過;最後的 commit 上重跑了會讀到改動的 22 個 suite,全部通過。suites)通過。合併後 main 的ecb36fb與審過的054c17e是同一棵 tree;main 上的 CI 在寫這則摘要時還在跑。ok,封存檢查pass。pass(change 封存在ecb36fb)。Changes
PR #523 以 squash 合併成
ecb36fb。 branch 上的三個 commit:e8f221ffix: say in one way where idd-close's doc-sync sweep sitsa1a3ccfchore: archive idd-512-doc-sync-after-close054c17etest: exercise each condition of the doc-sync position check改到的檔案:
plugins/issue-driven-dev/skills/idd-close/SKILL.md(一行)、scripts/tests/doc-sync-sweep/test.sh、CHANGELOG.md、openspec/specs/idd-close-doc-sync/spec.md(新檔)、封存的 change(四個檔)與.claude/.idd/attachments/issue-512/_manifest.json;共 9 個檔案。沒有在這張做的
--retroactive模式的表沒有寫 Step 6.3 等五個步驟怎麼處理:[bug] idd-close --retroactive: the table does not say what happens to Step 1.55, 3.5, 3.6, 6.3 and 6.8 (found during #512) #521Closing Follow-ups Filed
Residue Acknowledgement
residue declared as
(none)at diagnose time — no acknowledgement neededDoc-sync 檢查
→ doc-sync: 8 files checked, no staleness detected
這一段是 issue 關閉之後才做、事後追加的(Step 6.3)。plugin 的 CLAUDE.md 提到這一步,但沒有寫它在什麼時候做;其他七份沒有提到。
Distribution Sync
issue-driven-dev;plugin 與 marketplace 在同一個 repo)[Unreleased],plugin.json與marketplace.json仍是 4.0.1。發版要先有一個升版號的 commit,版號由維護者決定。這次改的是idd-close的一句說明文字,照步驟順序執行的人行為不變chore: release 4.1.0