Skip to content

[bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512

Closed

Description

@kiki830621

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

Scope Changes

Blocking

  • (none)

Commits

Activity

  1. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    🎯 Decision

    Original (2026-11-11):
    「3.4. 關閉後好了」

    問的是:doc-sync 檢查要留在 issue 關閉之後(只改「位置」那一句),還是移到貼出摘要之前、結果直接寫進草稿。

    決定

    doc-sync 檢查留在 issue 關閉之後。只改 Step 6.3「位置」那一句,讓它與步驟的編號一致;不把檢查移到貼出摘要之前。

    Rationale

    維護者沒有另外說明理由。以下是這個選擇對實作的含義,由記錄的人整理。Step 4 的區塊不拆,貼出摘要後接著關閉。Step 6.3 與 Step 6.5 的結果照舊在貼出之後追加到結案摘要。/idd-close #499 那次在貼出之前做檢查的做法不成為規定。

  2. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    Diagnosis

    Type

    bug(label bug)

    Root Cause / Analysis

    我認為 root cause 是:Step 6.3 加進 idd-close 的時候(commit 1b5c02d,#220,2026-07-06),「位置」那一句寫的是原本的打算(摘要貼出之後、關閉之前),但這一步實際被放在 Step 4、Step 5、Step 6 之後,而 Step 4 在同一個 bash 區塊裡先貼摘要、再關閉 issue。沒有任何檢查比對這兩件事,所以矛盾一直留著。

    證據(plugins/issue-driven-dev/skills/idd-close/SKILL.md,005531b):

    • 第 955 行(Step 6.3 的「位置」):closing summary 已 publish、gh issue close 之前。
    • Step 4 的區塊:第 872 行貼出結案摘要,第 885 行 gh issue close。兩者在同一個區塊,中間沒有可以插入別的步驟的地方。
    • 步驟的順序:Step 4(第 861 行)→ Step 5 → Step 6 → Step 6.3(第 951 行)→ Step 6.5。
    • Step 0.5 的 TaskCreate 清單順序相同:publish_and_close → auto_update_body → doc_sync_sweep → distribution_sync_chain_detection。
    • Step 6.3 自己的其他部分也假設摘要已經貼出:6.3.3 的處置是用 PATCH 把 ### 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。
    • 影響的流程:照「位置」那一句執行的人,要自己把 Step 4 的區塊拆開;照步驟順序執行的人不受影響。

    Strategy

    維護者已決定(2026-11-11):doc-sync 檢查留在 issue 關閉之後,只改「位置」那一句,不把檢查移到貼出摘要之前。

    • 規格:新增一條 requirement,寫明 doc-sync 檢查在 issue 關閉之後、distribution sync 之前做,附 Example
    • 先加會失敗的檢查(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-close Step 6.3 的「位置」那一句
    • CHANGELOG 加 [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

    • 改的是說明文字,步驟的順序與清單都不動;照步驟順序執行的人行為不變。
    • Step 6.3 與 Step 6.5 的結果仍是在摘要貼出之後才追加,不在結案時那一次通知裡。這是維護者選的做法帶來的,正文已寫明。

    Residue

    (none)

    Vagueness Pre-check

    • V1: 2 — 正文點名了哪一句與哪一步矛盾,做法由維護者決定為「只改那一句」。
    • V4: 2 — 完成條件可以檢查:兩處說法一致,執行者不必自己決定順序。
    • Triggered: no — both axes ≤ 3

    Sister Concerns Filed (mid-diagnose)

    (none surfaced)

  3. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    📊 For Reviewer / Collaborator

    現在:已結案。idd-close Step 6.3 的「位置」那一句原本說 doc-sync 檢查在關閉之前做,與步驟順序矛盾;現在改成說 issue 已關閉、結案摘要已貼出之後才做,並加了規格與測試(Closing Summary)。
    Blocking:無。
    你該做什麼:無。

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

  4. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    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. 測試先行

    • 1.1 doc-sync 檢查的位置有可執行的檢查:依 requirement「The doc-sync sweep runs after the issue is closed」的 Example「where the doc-sync sweep sits in idd-close」,doc-sync-sweep 加一個讀 idd-close SKILL.md 的檢查程式與 Example 八列各自的檢查,測試檔帶標記 spec-example: idd-close-doc-sync / where the doc-sync sweep sits in idd-close。現行的檔案要通過;七份改壞的副本(「位置」那一句說在關閉之前、那一句沒說 issue 已經關閉、沒有「位置」那一句、Step 6.3 移到 Step 4 之前、Step 6.3 移到 Step 6.5 之後、清單裡 doc_sync_sweep 排在 publish_and_close 之前、清單裡 doc_sync_sweep 排在 distribution_sync_chain_detection 之後)各自被抓到,而且抓到的原因是那一份改壞的地方。驗證:改 SKILL.md 之前,現行的檔案不通過,說在關閉之前的那份副本做不出來(與現行檔案相同),四份改順序的副本除了順序還帶著那一句的問題。

    2. skill 文字

    • 2.1 改 idd-close Step 6.3 的「位置」那一句:寫成 issue 已關閉、closing summary 已貼出之後,在 Step 6 body sync 之後、Step 6.5 distribution sync 之前。步驟的順序與 Step 0.5 的清單不動。驗證:1.1 全部通過;doc-sync-sweep 原有的七個檢查照舊通過。

    3. 收尾

  5. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change idd-512-doc-sync-after-close

    這張改的是 skill 的文字,照那一句執行的人跑的步驟順序會不同,所以寫了規格。change idd-512-doc-sync-after-close 新增 capability idd-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:

    • 1.1 doc-sync 檢查的位置有可執行的檢查:依 requirement「The doc-sync sweep runs after the issue is closed」的 Example「where the doc-sync sweep sits in idd-close」,doc-sync-sweep 加一個讀 idd-close SKILL.md 的檢查程式與 Example 八列各自的檢查,測試檔帶標記 spec-example: idd-close-doc-sync / where the doc-sync sweep sits in idd-close。現行的檔案要通過;七份改壞的副本(「位置」那一句說在關閉之前、那一句沒說 issue 已經關閉、沒有「位置」那一句、Step 6.3 移到 Step 4 之前、Step 6.3 移到 Step 6.5 之後、清單裡 doc_sync_sweep 排在 publish_and_close 之前、清單裡 doc_sync_sweep 排在 distribution_sync_chain_detection 之後)各自被抓到,而且抓到的原因是那一份改壞的地方。驗證:改 SKILL.md 之前,現行的檔案不通過,說在關閉之前的那份副本做不出來(與現行檔案相同),四份改順序的副本除了順序還帶著那一句的問題。
    • 2.1 改 idd-close Step 6.3 的「位置」那一句:寫成 issue 已關閉、closing summary 已貼出之後,在 Step 6 body sync 之後、Step 6.5 distribution sync 之前。步驟的順序與 Step 0.5 的清單不動。驗證:1.1 全部通過;doc-sync-sweep 原有的七個檢查照舊通過。
    • 3.1 CHANGELOG 的 Unreleased 加 Fixed 條目([bug] idd-close: Step 6.3 says doc-sync runs before the issue is closed, Step 4 closes it first #512)。驗證:git diff 只有新增行,已發布版本的條目沒有改動。
    • 3.2 跑 doc-sync-sweep 與整套測試(run-all-tests.sh 與 spectra-archive-post-ic)。驗證:結束碼都是 0。

    Legend: - [x] done · - [~] skipped (may revisit) · - [-] won't fix (scope)
    idd-close will refuse to close if any - [ ] remains in this checklist.

    Changes

    Files Changed

     .claude/.idd/attachments/issue-512/_manifest.json  |   6 +
     .../.openspec.yaml                                 |   6 +
     .../proposal.md                                    |  49 ++++++
     .../specs/idd-close-doc-sync/spec.md               |  30 ++++
     .../tasks.md                                       |  12 ++
     openspec/specs/idd-close-doc-sync/spec.md          |  32 ++++
     plugins/issue-driven-dev/CHANGELOG.md              |   7 +
     .../scripts/tests/doc-sync-sweep/test.sh           | 179 +++++++++++++++++++++
     plugins/issue-driven-dev/skills/idd-close/SKILL.md |   2 +-
     9 files changed, 322 insertions(+), 1 deletion(-)
    

    改了什麼

    • idd-close Step 6.3 的「位置」那一句。 原本說這一步在結案摘要貼出之後、gh issue close 之前。現在說:issue 已關閉、結案摘要已貼出之後(Step 4 與 Step 6 body sync 之後),Step 6.5 distribution sync 之前;到這一步時 issue 已經關了,所以它不擋結案。步驟的順序、Step 0.5 的清單、Step 4 都沒有動,照步驟順序執行的人行為不變。
    • 那一句寫的是狀態,不是「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)。
    • 規格。 requirement 寫明三件事:doc-sync 檢查在 issue 關閉、摘要貼出之後才做;步驟的順序與 Step 0.5 的清單都把它排在關閉與 body sync 之後、distribution sync 之前;「位置」那一句要說 issue 已經關閉,不得說在關閉之前。Example 是一張八列的表(現行檔案,加七種改壞的情況)。
    • 測試。 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 引用的使用者原話(「最後一步」)。
    • plugin 的 CLAUDE.md、README、其他 skill、references、rules 都沒有講這一步在什麼時候做。
    • 規格裡只有 idd-pr-hitl-modes 的「idd-close honors the orchestrated directive from idd-all」提到 Step 6.3,寫的是過時文件怎麼處置,沒有寫位置,所以這次是新增 requirement,不是修改。

    先失敗的檢查與測試結果

    • 改 SKILL.md 之前跑 doc-sync-sweep:當時新加的七個檢查裡六個失敗。現行的檔案被判「那一句」不一致;說在關閉之前的那份副本與現行檔案相同,做不出來;四份改順序的副本除了順序還帶著那一句的問題。原有的七個檢查通過。改了那一句之後全部通過。
    • 之後加的五個檢查(「那一句沒說 issue 已經關閉」那一列,與封存後補的四個)一加上就通過,所以另外確認它們會失敗:把檢查程式的八個條件逐一關掉,每關一個都至少有一個檢查失敗,沒有哪個條件是沒被測到的。
    • 另外用十一種寫法試過對那一句的判斷:六種說在關閉之前或沒說已關閉的、三種正確的、同一段有兩句的、放在 code block 裡的,結果都符合預期。這些試法沒有放進測試檔。
    • doc-sync-sweep 現在 19 項通過(原有 7 項加 12 項)。
    • 整套測試:改完文字、封存之前的工作樹上,73 個 suite、0 個失敗,spectra-archive-post-ic 141 項通過。之後還有封存與補測試兩個 commit,在最後的 commit 上重跑了會讀到改動的檔案或規格目錄的 22 個 suite 與 spectra-archive-post-ic,全部通過。merge-completeness(約 22 分鐘)用它自己建的 repo,不讀這些檔案,沒有重跑。
    • 當時機器負載高(load 50 到 100),每個 suite 的時限放寬到 600 秒來跑。最慢的是 edit-run 的 168 秒(它自己的時限是 480 秒),其餘都在 180 秒以內。
    • 規格的連結檢查回 ok(Example 有帶標記的測試),封存檢查回 pass。

    Scope Compliance

    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

  6. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    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

    1. 兩處說法一致,執行的人不必自己決定順序:Step 6.3 的「位置」那一句現在與 Step 4、步驟的順序、Step 0.5 的清單說的是同一件事。
    2. 照維護者選的做法(留在關閉之後,只改那一句):步驟與清單沒有動。
    3. Step 0.5 的清單與選的做法一致:這個做法下清單本來就是對的,不需要調整。

    Findings(合併後)

    # Severity Finding Source Action
    1 LOW 對「位置」那一句的檢查比對的是字詞,不是意思。否定的寫法會通過(例如「issue 並非已關閉;在 Step 4 前執行」「issue 尚未被關閉後」),而一句意思正確、但提到「關閉以前」的話會被判不一致。漏掉的寫法都很刻意,誤判的方向是擋下而不是放過;現行的那一句判斷正確。建議加一行註解,說明這個檢查通過不等於那一句的意思正確。 agents:logic In-scope fix
    2 LOW 新的檢查讓 doc-sync-sweep 依賴 idd-close SKILL.md 的幾個寫法:Step 4 的 code block 裡有一行不縮排、以 gh issue close 開頭的指令;五個步驟的標題各只有一個;Step 6.3 有一行以「位置」開頭而且用詞在比對的清單裡。與 doc-sync 無關的編輯(把關閉指令縮排進 if、多加一個 Step 4 的標題、換一種說法)也會讓這個 suite 失敗。這正是規格要的鎖,失敗訊息會指出是哪一處;reviewer 認為這個 diff 不必改。 agents:regression Follow-up
    3 INFO 檢查程式遇到沒有預期的例外(例如 SKILL.md 不是 UTF-8)時結束碼是 1、沒有輸出,測試的函式把它讀成空字串而不是 error。相關的檢查仍然會失敗,但失敗訊息看不出是檢查程式自己壞了。 agents:logic In-scope fix
    4 INFO issue 正文提到的代價(doc-sync 與 distribution sync 的結果在摘要貼出之後才追加,不在結案那次通知裡)沿用了,但沒有寫在 Step 6.3 那一句或 proposal 的 Non-Goals。DA 查了維護者的決定留言,那裡寫著這兩步的結果照舊在貼出之後追加,所以不算缺漏;要不要在那一句補一個子句是可選的。 agents:requirements+devils-advocate In-scope fix

    查證

    第 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-close Step 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。

  7. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    Follow-up Findings Filed

    verify 第 1 輪(報告):

    Filed: #522

  8. kiki830621 commented on Nov 12, 2026

    @kiki830621
    MemberAuthor

    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

    • 維護者決定(2026-11-11):doc-sync 檢查留在 issue 關閉之後,只改那一句。
    • plugins/issue-driven-dev/skills/idd-close/SKILL.md Step 6.3 的「位置」那一句改成:issue 已關閉、結案摘要已貼出之後(Step 4 與 Step 6 body sync 之後),Step 6.5 distribution sync 之前;到這一步時 issue 已經關了,所以它不擋結案。步驟的順序、清單、Step 4 沒有動。
    • 那一句寫的是狀態,所以在 --retroactive 模式(Step 4 只貼摘要、不關閉)也成立。
    • 規格:新的 capability idd-close-doc-sync,一條 requirement 與一張八列的 Example;change idd-512-doc-sync-after-close 已封存。
    • 測試:doc-sync-sweep 加一個讀 SKILL.md 的檢查程式,比對那一句、步驟順序與清單順序,並用十一份故意改壞的副本確認每一項都會失敗。
    • CHANGELOG 加 [Unreleased] 的條目,版號沒有動。

    Verification

    • verify 第 1 輪(報告):PASS、0 blocking、3 項 in-scope(1 項 LOW、2 項 INFO)、1 項 follow-up(LOW),六個 reviewer 都完成。沒有 MEDIUM 以上的項目;四項沒有在這條 branch 上修,記在 [enhancement] doc-sync position check: LOW and INFO findings left by the verify of #512 (follow-up from #512) #522。
    • 測試:新的檢查在改那一句之前失敗(七個裡六個),改之後通過;doc-sync-sweep 現在 19 項通過。把檢查程式的八個條件逐一關掉,每一個都至少讓一個檢查失敗。
    • 本機整套測試:封存之前的工作樹上 73 個 suite、0 個失敗,spectra-archive-post-ic 141 項通過;最後的 commit 上重跑了會讀到改動的 22 個 suite,全部通過。
    • PR fix: say in one way where idd-close's doc-sync sweep sits (#512) #523 head 上的 CI(suites)通過。合併後 main 的 ecb36fb 與審過的 054c17e 是同一棵 tree;main 上的 CI 在寫這則摘要時還在跑。
    • 規格的連結檢查 ok,封存檢查 pass。
    • 結案檢查:checklist 4 項都已勾;沒有 open PR 引用這張;merge 完整性檢查乾淨;spec archive gate pass(change 封存在 ecb36fb)。

    Changes

    PR #523 以 squash 合併成 ecb36fb。 branch 上的三個 commit:

    • e8f221f fix: say in one way where idd-close's doc-sync sweep sits
    • a1a3ccf chore: archive idd-512-doc-sync-after-close
    • 054c17e test: 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 個檔案。

    沒有在這張做的

    Closing Follow-ups Filed

    Residue Acknowledgement

    residue declared as (none) at diagnose time — no acknowledgement needed

    Doc-sync 檢查

    → doc-sync: 8 files checked, no staleness detected

    這一段是 issue 關閉之後才做、事後追加的(Step 6.3)。plugin 的 CLAUDE.md 提到這一步,但沒有寫它在什麼時候做;其他七份沒有提到。

    Distribution Sync

    • Detected: plugin(issue-driven-dev;plugin 與 marketplace 在同一個 repo)
    • Choice: skip — 無人值守的 run 不發版
    • Outcome: 未發版。這次的改動在 CHANGELOG 的 [Unreleased],plugin.json 與 marketplace.json 仍是 4.0.1。發版要先有一個升版號的 commit,版號由維護者決定。這次改的是 idd-close 的一句說明文字,照步驟順序執行的人行為不變
    • At: 2026-11-12T08:00:55Z
  9. added a commit that references this issue on Nov 15, 2026
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

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions