Repository navigation
Description
Problem
Original text:這張不是使用者的原話,是執行
/idd-all的 session 在一個真實專案裡跑spec-change.py links時觀察到的。
spec-change.py links 用 git grep -F -e "spec-example: <capability> / <title>" <head> -- . 找帶標記的檔案。這個指令不進 submodule,所以標記寫在 submodule 的測試檔裡時,檢查一律回報「no tracked file outside openspec/ (and not .md) carries its marker」。
遇到的情境:規格放在主 repo 的 openspec/,被規格描述的套件是主 repo 的 submodule,測試在套件自己的 repo 裡。這種配置下,套件的每一個 Example 都不可能通過 links,不論測試檔有沒有標記。
Type
enhancement
Expected
- 標記寫在 submodule 的已追蹤檔案裡時,
links找得到它。讀的是主 repo 在<head>記錄的那個 submodule commit,不是工作樹當下的內容。 - submodule 沒有初始化或抓不到那個 commit 時,
links回報error並說明原因,不把它當成「沒有標記」。 - 說明文件(spec-on-every-issue 的規則與
spec-change.py的說明)寫明標記可以放在 submodule 裡,以及這時需要 submodule 已經取出。
Actual
marker_files()的git grep沒有--recurse-submodules,只看主 repo 自己追蹤的檔案。- 結果是
status: missing,原因寫「沒有檔案帶這個標記」。讀報告的人看不出這是工具看不到,還是測試真的沒有標記。
Impact
- 規格在主 repo、程式與測試在 submodule 的專案,verify 的規格連結這一列永遠不會通過。
- 這類專案若為了讓檢查通過而在主 repo 放一個只帶標記、不執行任何檢查的檔案,檢查就失去意義。
Repro
- 主 repo 有
openspec/specs/<capability>/spec.md,其中一條新增的 requirement 帶##### Example: <title>。 - 把含有
# spec-example: <capability> / <title>的測試檔放在一個 submodule 裡並提交,主 repo 提交 submodule 指標。 - 在主 repo 跑
python3 scripts/spec-change.py links --base <base> --head HEAD --cwd .。 - 輸出是
{"status": "missing", ...},why是「no tracked file outside openspec/ (and not .md) carries its marker」。
可能的做法(供診斷參考,未驗證)
git grep 在給定 tree 時可以加 --recurse-submodules,它會搜尋那個 tree 記錄的 submodule commit;需要確認輸出的路徑前綴在這個模式下的格式,以及 submodule 未取出時的行為。
Related
- feat: IDD 的每一張 issue 不論走哪個 tier 都要更新規格(與 Spectra 深度整合) #480(spec-on-every-issue)、[enhancement] 既有的 requirement 補上 Example 與帶標記的測試 (follow-up from #480) #487(既有的 requirement 補上 Example 與帶標記的測試)、follow-up(#480 r6): spec-change 與修正輪的四項小缺口(marker 副檔名、安裝提示、git grep 切分、修正輪 plan 留言) #495(
links的幾項小缺口) - idd-ci-gate:以 git submodule checkout 的 repo 一律回 error,/idd-all 在這類 repo 永遠停在 Phase 4.5 #535(
idd-ci-gate在 submodule checkout 的 repo 回 error):同樣是 submodule 的配置,但那張說的是 repo 本身是別人的 submodule,這張說的是 repo 底下有 submodule
Clarity Surface(idd-clarify run 2026-11-14T02:00:00Z)
| Type | Source | Question for you | Status |
|---|---|---|---|
| (none) | — | no issues detected | passed |
Linked-Context Siblings Filed
(none surfaced)
Current Status
Phase: closed(PR #572 於 2026-11-16 以 squash 合併成 28e0de2,內容與 ee3fcd9 相同;結案摘要是留言 6911419356;2026-11-16 發布為 4.2.0)
Last updated: 2026-11-16 by idd-update(結案後發布為 4.2.0)
Dashboard: #548 (comment)
Key Decisions
links自己列出<head>的 gitlink,逐一在記錄的 commit 上搜尋(含巢狀),不用git grep --recurse-submodules;每一次git grep都帶--no-recurse-submodules。- 一個 Example 有三種結果:找到標記 → 有連結;沒找到且每個 gitlink 都搜尋過 →
missing;沒找到且有 gitlink 搜尋不了 →error。維護者已確認這個讀法(留言 6878497822)。 - 第一輪之後:主 repo 找到標記就停;只在符合六個條件的目錄跑 git;在那裡跑 git 時關掉 lazy fetch、拿掉六個繼承的 git 位置變數(
GIT_DIR、GIT_WORK_TREE等)。 - 第二輪之後(留言 6878497822):兩處「checked exactly as before」改成可以檢查的句子,三個子命令用同一個方式讀頂層目錄;搜尋失敗的 submodule 底下的 submodule 照樣搜尋;git 比 2.45 舊時不在 submodule 目錄跑 git。
- 第三輪之後(留言 6885330621):物件打不開時算缺物件;submodule 的搜尋中途中止時不採用它印出的內容,一律
error。 - 第四輪之後(留言 6888927012,維護者委託協調者決定):symbolic link 的 blob 打不開也算缺物件;預設分支的 4.1.0 用合併接進來,重複的兩條 requirement 併成一條;合併前補整條分支的審查,最多兩輪。
- 第五輪之後(留言 6890121460,同一個委託):submodule 的目錄落在主 repo 自己的 git 目錄或它底下時不搜尋、不在那裡執行 git(第 2 個條件補一句,Example 第 55 列)。
- 第六輪之後(留言 6891118023,維護者:照建議修,條文改成封閉列舉,再審一輪):第 2 個條件改寫成兩個目錄的封閉列舉(
git rev-parse --absolute-git-dir與--git-common-dir在頂層印出的那兩個);submodule 自己的 git 目錄不排除、解析後等於頂層目錄的路徑照樣接受,兩件事都寫進條文(Example 第 56 到 59 列)。後兩件是協調者的選擇,維護者可以改。 - 第七輪中途(留言 6892950238):維護者決定先把這一輪跑完、不改程式,並選定席位的執行方式。
- 第七輪之後(留言 6894347661,維護者:改程式,再審一輪):第 2 個條件的前半與第 5 個條件改成比對目錄(作業系統回報的裝置與 inode),不比對路徑字串;條文的兩句照程式改寫(Example 第 60 到 63 列)。
- 同一個 change 多做的一步(留言 6894894048,協調者依委託決定):解析後落在規格目錄裡的 submodule 不搜尋,不論它的路徑叫什麼(Example 第 64、65 列)。
- 第八輪之後(留言 6909585903,維護者從選項中選定):多做的那一步留著;第八輪的後續項留在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559、分支不再改;開 draft PR 讓 Linux 的 CI 跑一次,不合併。
- CI 失敗之後(留言 6910032608,維護者從選項中選定):在分支上修第 50 列的測試前提與 Example 那一列的敘述,不再審。這只推翻「分支不再改」對這一件事的適用。
- Complexity:Spectra。九個 change 都已封存:
idd-548-links-submodule-markers(afd0021)、idd-548-links-submodule-hardening(7ad9152)、idd-548-links-search-completeness(726050b)、idd-548-links-unreadable-objects(54a9092)、idd-548-one-top-directory-requirement(8003a7b)、idd-548-fix5(59979f2)、idd-548-fix6(941f881)、idd-548-fix7(e5022f4)、idd-548-fix8(ee3fcd9)。
Verification
- 八輪:FAIL(6876450742)、FAIL(6878222878)、FAIL(6881182720)、PASS(6887766646,只審第三輪之後的修正)、FAIL(6889821186,第一次從頭審整條分支)、FAIL(6891008905)、FAIL(6893428419)、PASS(6908861611,審整條分支)。
- 第八輪:0 blocking、0 項要在分支上修、9 項後續(7 項 LOW、2 項 INFO)。閘門:clean。第七輪的四列都解決了:第 2 個條件的前半與第 5 個條件改成比對目錄,同一個目錄的另一種拼法(另一種大小寫、macOS 的另一種絕對路徑寫法、Unicode 的另一種正規化形式)不再被回
error;條文的兩句照字面成立。issue 的三點 Expected 在審查席建的輸入上都成立;整套 75 個 suite 全過,spec-change878 項。 - 這個「乾淨」的限度:裁定席的把握約七成五。條文有三處容許兩種讀法(規格目錄的路徑是一般檔案、規格目錄是 link、「上一層目錄」),照較嚴的讀法就還要各補一句。另一個模型家族的審查席把第一處評為 HIGH,裁定席重建後定為 LOW。這些都列為後續,補在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559。
- 第八個 change 多做了一步,維護者沒有點名:解析後落在規格目錄裡的 submodule 不搜尋。裁定席裁定它照字面寫明了、與程式相符、不是缺陷;留不留由維護者決定。
- 六席都交出了結果,各啟動一次,其中一席是另一個模型家族(OpenAI
gpt-6.1-sol,沒有工具)。協調者撰寫了這個 change,沒有分級。 - 測試只在 macOS 上跑過(git 2.55.0 與 2.54.0;另在區分大小寫的磁碟映像上跑過,需要兩種拼法的第 60 到 64 列在那裡略過)。
- draft PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572 的第一次 CI(ubuntu-26.04、git 2.56.1)失敗,75 個 suite 裡 2 個(留言 6909882017)。
spec-change停在第 50 列的 fixture:它的前提是空的物件檔讓git grep以 0 或 1 結束,git 2.56 起改成以 128 結束;之後的檢查在 CI 上都沒有跑到。協調者在 macOS 上用 git 2.56.0 重現,拿掉那一行前提檢查後 878 項全過,所以links的答案沒有錯,壞的是測試的前提與 Example 那一列對 git 行為的敘述。edit-run的 1 項是 [bug] edit-run: the check "the first backup id stays once" fails when two corrections land in the same second (found during #519) #534 記錄的不穩定檢查,與這條分支無關。 - 第九個 change(
6178467、ee3fcd9):第 50 列的 fixture 改成記下結束碼、不停下;Example 那一列的第一欄改成兩種情形並列。spec-change.py沒有改,與第八輪審過的e5022f4逐位元組相同。測試檔在 git 2.54.0、2.55.0、2.56.0 上都是 878 項通過。這個 change 沒有獨立讀者,也沒有 verify 輪(維護者的決定)。 - 第二次 CI(run 43828661537,head
ee3fcd9,ubuntu-26.04、git 2.56.1)通過:75 個 suite、0 個失敗。CI 不執行第 60 到 64 列(它們需要不分大小寫的檔案系統),在 git 2.56 上也沒有只有「搜尋前先問哪些物件打不開」那一步才抓得到的測試輸入。
Scope Changes
idd-implement與idd-all的文字沒有改:它們只說測試檔帶標記,沒有規定檔案在哪裡。- Example「markers in submodules」從十列加到六十五列。
- 另開的 issue:idd-verify 與 worktree:在另外的 clone 或 worktree 跑 links 時沒有取出 submodule 的說明(#548 驗證第 13 列) #554(第一輪)、spec-change.py links:主 repo 這一層的三個既有缺口(顏色設定、檔名含換行、讀不到的檔案內容) #556(第二輪;第四、六輪各補幾點)、spec-change.py:#548 第三輪 verify 留下的四件既有的事(原因文字的截取、沒有時間上限、主 repo 的 lazy fetch、archived 的 traceback) #558(第三輪)、spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559(第四輪起的小事;第五、六、七、八輪各補幾點)。
Blocking
- 沒有。這張 issue 已結案。
- 已發布為 4.2.0(2026-11-16)。
Tasks
- 第一個 change
idd-548-links-submodule-markers的六項 - 第二個 change
idd-548-links-submodule-hardening的六項,含驗收紀錄 - 第三個 change
idd-548-links-search-completeness的六項,含驗收紀錄(變異清單在留言 6881180344) - 第四個 change
idd-548-links-unreadable-objects的五項,含驗收紀錄 - 合併預設分支 4.1.0 與第五個 change
idd-548-one-top-directory-requirement - 第六個 change
idd-548-fix5的五項與第五輪的另外四項修正,含驗收紀錄 - 第七個 change
idd-548-fix6(第六輪第 1 到 3 列),含驗收紀錄 - 第八個 change
idd-548-fix7(第七輪第 1 到 4 列,加上規格目錄的那一步),含驗收紀錄 - 維護者 2026-11-16:多做的那一步留著;後續項留在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559;開 draft PR(feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572)
- 維護者 2026-11-16:CI 失敗的那一行在分支上修,不再審
- 第九個 change
idd-548-fix8(第 50 列的測試前提與 Example 的一列),含驗收紀錄;第二次 CI 通過 - 維護者 2026-11-16:合併(PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572,squash 合併,預設分支
28e0de2,分支保留) - 維護者 2026-11-16:發布為 4.2.0(預設分支
6c26645,tagissue-driven-dev-v4.2.0,marketplace 已同步)
Commits
預設分支:28e0de2(PR #572 的 squash 合併)。分支 idd/548-spec-change-py-links-submodule-missing 保留,合併前比預設分支多 47 個 commit:
ee3fcd9chore: archive idd-548-fix86178467test: row 50 of the Example "markers in submodules" runs whether git skips an empty object or ends the search on ite5022f4chore: archive idd-548-fix7a84797fdocs: acceptance record of idd-548-fix7f6fe368test: the fixture of row 58 checks where the top directory lies, not what git says about it338da27docs: the changelog entry states that a submodule lying in the spec directory is not searched9fb5cc1fix: links does not search a submodule whose directory lies in the spec directory, whatever its path is named65f7a17test: a submodule that lies in the spec directory is not searched, whatever its path is named — rows 64 and 65 of the Example "markers in submodules"e01674edocs: the changelog entry and the comment of row 57 state the two conditions as the script checks them54d1775fix: links decides conditions 2 and 5 by comparing directories, not path namesc3b5798test: links compares directories, not names, where a path spells one in another letter case — rows 60 to 63 of the Example "markers in submodules"941f881chore: archive idd-548-fix65be6f2ddocs: the task list of idd-548-fix6 is complete25fe633docs: acceptance record of idd-548-fix66f91370fix: links ends in error when git names no directory for one of the two questions20048d8test: an answer of git that names no directory is not taken for one; rows 57 to 59 show the directory searched4af6539docs: the changelog entry and the comment of row 55 state the condition as the script checks it8e5e0c1fix: links also compares the repository's common git directory, so a linked worktree that holds the main repository is covered8ebcecbtest: links compares the two git directories of the main repository and nothing else — rows 56 to 59 of the Example "markers in submodules"59979f2chore: archive idd-548-fix52bff808docs: every task of idd-548-fix5 is done5360a91docs: the acceptance record of idd-548-fix5dd8d2b9docs: the design of idd-548-fix5 records a related case it leaves alone50d01dadocs: the changelog entry says what counts as the main working tree and which answer changes with submodule.recurse onf170baatest: row 29 of the Example "markers in submodules" builds what it states; the suite stops when its temporary directory cannot be made3fac72dfix: links does not search a submodule directory inside the main repository's own git directory925062dtest: links does not run git inside the main repository's git directory — row 55 of the Example "markers in submodules"8003a7bchore: archive idd-548-one-top-directory-requirement6758b3ddocs: the changelog entry no longer lists as new what release 4.1.0 shipped0e0f153test: the top-directory block of the spec-change suite names the Example released in 4.1.0f08839fchore: merge the default branch at release 4.1.0 into the branch54a9092chore: archive idd-548-links-unreadable-objects08168c7docs: an object counts as lacking when it cannot be opened, not when it merely cannot be read to its end6c88ba8fix: links counts an object it cannot open as lacking, and ignores what a submodule's search printed before it ended earlya552f39test: links opens the objects of a submodule and does not use the output of a search that ended early — rows 50 to 54 of the Example "markers in submodules"726050bchore: archive idd-548-links-search-completenessf8fde3afix: links asks git which objects a submodule lacks instead of reading its error stream, and links, archived and preflight read the top directory alike1da57e1test: links keeps searching inside a failed submodule, ignores git's error stream and checks the git version — rows 42 to 49 of the Example "markers in submodules"7ad9152chore: archive idd-548-links-submodule-hardening57ee7e2fix: links stops at a marker found in the main repository and runs git only in a checked-out submodule66beef4test: links runs git only in checked-out submodules — rows 16 to 41 of the Example "markers in submodules"afd0021chore: archive idd-548-links-submodule-markers4e0f47bfix: links turns git's own recursion into submodules offed0bb10test: links gives the same answer when submodule.recurse is on; joined reasons, a nested submodule not checked out, a submodule under the spec directory41fea78chore: record the attachment manifest of issue 548aa067f0feat: spec-change.py links reads markers in submodules and answers error when it cannot decide9ebccfdtest: links finds markers in submodules — ten checks for the Example "markers in submodules"
Activity
kiki830621 commentedon Nov 14, 2026
Diagnosis
Type
feature(issue 的 label 是
enhancement)Root Cause / Analysis
spec-change.py的marker_files()用git grep -z -F -e <標記> <head> -- .找帶標記的檔案。給定 tree 時,git grep不進 submodule,所以標記在 submodule 的檔案裡時links一律回報missing。在一個三層的臨時 repo(主 repo → submodule → 巢狀 submodule,git 2.55.0)上量到的行為:
--recurse-submodules、給定 tree:找得到,巢狀的也找得到;輸出的路徑是<tree>:<submodule 路徑>/<檔案>。git submodule deinit),--recurse-submodules安靜略過它,exit 1,跟「沒有標記」分不出來。git 的說明寫它只搜尋「active and checked out」的 submodule,所以取出了但不是 active 的 submodule 也會被安靜略過。git grep以fatal: unable to read tree結束(exit 128);現行程式把 0 與 1 以外的結束碼當成error,這一種已經不會被讀成「沒有標記」。第 4 點決定了做法:只加
--recurse-submodules會讓「沒取出」與「沒有標記」同樣回報missing,這正是 issue 的 Expected 第二點要排除的。所以由links自己列出<head>的 gitlink(git ls-tree -r裡 mode 160000 的項目),逐一確認該目錄是自己的工作樹頂層、而且有記錄的那個 commit,再在那個 commit 上搜尋,巢狀的 gitlink 照同樣方式往下走。每一個沒辦法搜尋的 submodule 都留下路徑與原因。對 Expected 第二點的讀法(見下方 Choice Default Record):一個 Example 有三種結果。
links對這個 Example 的結果missing(現行的why文字不變)error,原因寫出是哪個 Example、哪個 submodule 路徑、為什麼搜尋不了links要回答的是「這個 Example 有沒有帶標記的檔案」。已經找到一個,答案就確定了,其他 submodule 能不能搜尋不影響;沒找到而又有地方沒看過,答案無法確定,照這支 script 的既有約定(讀不到或無法判定的一律error)回報。排除規則不變:主 repo 規格目錄底下的檔案與
.md檔不算。submodule 裡的檔案以「submodule 路徑/檔案路徑」比對.md結尾。Existing work
unknown:已合併 PR 的清單達到查詢上限(100 筆),更早的沒有查到。目前開著的五個 PR 都沒有動
spec-change.py。#547 的修正預期也會改scripts/spec-change.py(別的 subcommand),兩邊先後合併時可能要解衝突。Impact
plugins/issue-driven-dev/scripts/spec-change.py(marker_files()、cmd_links()、檔頭說明)、plugins/issue-driven-dev/scripts/tests/spec-change/test.sh、openspec/specs/spec-on-every-issue/spec.md(經 Spectra change)、plugins/issue-driven-dev/references/spec-wrapper.md、寫到標記放在哪裡的 skill 文字(idd-implement、idd-all)、CHANGELOG.md。idd-implement的 Spec close-out、idd-all的 Step 3b.6、idd-verify的規格連結那一列。只有 repo 底下有 submodule 時行為才會不同;沒有 gitlink 的 repo 結果與現在相同。Strategy
<head>記錄的 commit,含巢狀)、上表的三種結果,並加一個 Example 表。tests/spec-change/test.sh,在目前的main上要失敗):標記在 submodule;標記只在 submodule 較新的 commit;標記在巢狀 submodule;submodule 沒取出且別處沒有標記;submodule 沒取出但主 repo 有標記;記錄的 commit 不在物件庫;submodule 路徑含空白;submodule 裡的.md。spec-change.py:列舉 gitlink、逐一搜尋、無法判定時回error;同一次執行內 gitlink 清單只算一次。references/spec-wrapper.md、兩個 skill 裡講標記位置的句子、CHANGELOG。spectra-verify、封存、links(從 merge-base)、archived。Conflict Class
A_parallel_safe
改動在一個 script、它的測試與說明文件,沒有單一寫入者的共享資源;與 #547 動到同一個檔案的不同函式,屬於合併時的一般衝突。
Complexity
Spectra
links是其他 skill 呼叫的工具介面(idd-implement、idd-all、idd-verify的 spec 包裝流程),它的行為寫在 capabilityspec-on-every-issue。error的情況)。Hard-gate: triggered — 標記規則同時寫在
spec-change.py、tests/spec-change/test.sh、openspec/specs/spec-on-every-issue/spec.md、references/spec-wrapper.md與兩個 skill 的文字裡(同一個概念約六個檔案);判定已經是 Spectra,硬閘不改變它。Risks
ls-tree、cat-file、grep,沿用 script 既有的git()包裝。missing變成error;找得到的不受影響。這是想要的結果,但文件要寫明。git grep。gitlink 清單與可搜尋性在一次執行內只算一次。-z與core.quotePath=false,測試要有含空白的 submodule 路徑。Residue
(none)
Vagueness Pre-check
<head>記錄的 commit、沒取出時回error、文件要寫什麼。Choice Default Record
links什麼時候回error。error(上表的三種結果);(b) 只要<head>有任何一個 gitlink 沒辦法搜尋就回error,不論標記是否已在別處找到。kiki830621 commentedon Nov 14, 2026
📊 For Reviewer / Collaborator
現在:已結案(2026-11-16)。
spec-change.py links原本只在主 repo 找 Example 的標記,測試放在 submodule 時一律回missing;現在它也讀 submodule 記錄的 commit,看不到的時候回error。PR #572 以 squash 合併成28e0de2,結案摘要是留言 6911419356。要知道的:(1) 已發布為 4.2.0(預設分支
6c26645,tagissue-driven-dev-v4.2.0)。(2) 最後一輪 verify 審的是e5022f4;它後面的兩個 commit 只改測試檔的一列與 Example 的一列,沒有人獨立讀過,spec-change.py沒有變。(3) 各輪留給別的 issue 的項目在 #554、#556、#558、#559。你該做什麼:無。
last-updated by idd-update at → closed, 2026-11-16
kiki830621 commentedon Nov 14, 2026
Implementation Complete
Spec: change idd-548-links-submodule-markers
Spectra change
idd-548-links-submodule-markers已封存在afd0021;進度見openspec/changes/archive/2026-11-14-idd-548-links-submodule-markers/tasks.md。做了什麼
spec-change.py links自己列出<head>的 gitlink,對每一個已取出、而且物件庫裡有記錄的 commit 的 submodule,在那個 commit 上搜尋標記;巢狀的 submodule 照同樣方式往下走。找到的檔案以「submodule 路徑/檔案路徑」套用既有的兩個排除(規格目錄底下、.md結尾)。missing(why文字不變);沒找到而且至少一個 submodule 搜尋不了,整個指令回error,原因寫出 Example、submodule 路徑、是沒取出還是缺 commit。git grep都帶--no-recurse-submodules,所以使用者的 git 設定開了submodule.recurse時結果不變。這一點是封存前的spectra-verify指出、實測成立後補上的。spec-change.py檔頭的links說明、references/spec-wrapper.md一句、CHANGELOG 的 Unreleased。怎麼驗證的
--no-recurse-submodules之前,第 11、12 列的三項檢查失敗,其餘通過;加上之後tests/spec-change/test.sh497 通過、0 失敗。links的輸出與結束碼,逐位元組相同。run-all-tests.sh74 個 suite、0 個失敗;spectra-archive-post-ic141 通過。封存後的 HEAD 上正在重跑一次,結果會補在這張 issue。main的分岔點6ed8dec到afd0021:{"status": "ok", "missing": [], "reason": ""}。archived:pass。套用到規格的 requirement 與 delta 逐字相同(腳本比對)。missing,改動後回報ok,一次約 2.6 秒。誰寫的
測試、script 與文件的第一批由實作者模型(Codex)依工作單完成,協調者(Claude)在它寫不到的目錄驗收。第二批(
--no-recurse-submodules、第 11 到 15 列的檢查、fixture 失敗時的訊息)是協調者自己寫的。兩批都還沒有經過獨立審查,接著跑 verify。無人值守時取的預設
error(Diagnosis 的 Choice Default Record)。等維護者確認。Commits(branch
idd/548-spec-change-py-links-submodule-missing,還沒推)9ebccfdtest:十列的檢查aa067f0feat:links讀 submodule41fea78chore:附件清單ed0bb10test:第 11 到 15 列4e0f47bfix:關掉 git 自己的遞迴afd0021chore:封存 changeNext: verification pending
kiki830621 commentedon Nov 14, 2026
Verify: #548
審的是這張 issue 的整條分支對預設分支的 diff:
spec-change.py的marker_files()與cmd_links()、tests/spec-change/test.sh、references/spec-wrapper.md、CHANGELOG、規格spec-on-every-issue與封存的 changeidd-548-links-submodule-markers。分支只在本機,還沒有推上來。Engine
pai ensemble(parallel-ai-agents 2.26.0,profile custom):requirements、logic、security、regression 四席與 devil's advocate 用 Claude opus,另一席是 Codex(gpt-6.1-sol,xhigh)。devil's advocate 讀過前五席的結果,並自己重現了其中的主要項目。協調者另外在臨時 repo 上重現了第 1 列與第 2 列。
6 / 6 reviewers completed
Aggregate
FAIL — 2 blocking, 10 in-scope fix, 1 follow-up, 0 rejected
Reviewed:
6ed8dec5895f6c88a24aa0ecdf1e3b2b0e635bdd..afd0021434856a6fec3bde5fe2d06d63c8228a2d要求覆蓋率
2 / 3 requirements addressed
Expected 第一點(標記在 submodule 裡找得到,讀記錄的 commit)與第二點(沒取出或缺 commit 時回
error並說明原因)成立。第三點只做到一半:規格與references/spec-wrapper.md有寫 submodule 要取出,spec-change.py自己的說明沒有寫(第 10 列)。成立的部分
tests/spec-change/test.sh各有檢查,分支上 497 項全部通過。requirements 席把新的測試檔配上改動之前的 script 重跑:第 1、2、3、4、8、10、11、12、13、14 列失敗,第 5、6、7、9、15 列通過,與封存的驗收紀錄一致。links的輸出與改動之前逐位元組相同。idd-548-links-submodule-markers;links回ok;archived回 pass。.claude/scripts/tests/spectra-archive-post-ic/test.sh通過。Findings(合併後)
links會執行 commit 內容指定的指令。marker_files()把「目錄存在、git rev-parse --show-toplevel回報它自己」當成取出的 submodule,接著在裡面跑git cat-file -e。一組一般的已追蹤檔案可以排成 git 目錄的形狀(沒有.git);git 把它認成 repository、讀它的設定,在找不存在的 commit 時發動 lazy fetch,執行設定裡指定的指令。這個目錄可以放在 submodule 記錄的 commit 再記的一個 gitlink 路徑上,而 submodule 的工作樹停在另一個 commit,這正是 Example 第 4 列明文支援的狀態。devil's advocate 確認:主 repo 已經找到標記、結果是ok的時候,指令照樣執行。改動之前links只在主 repo 的頂層跑 git,所以這是這條分支帶進來的。封存的 design 寫「在 submodule 目錄裡只跑唯讀的 git 指令」,這句不成立:cat-file -e與grep會向網路抓物件並寫入物件庫。error;部分 clone 的 submodule 在遠端連不到時回error,遠端恢復後又回ok。改動之前的 script 在這些情況都回ok。封存的 design 把 submodule 裡的失敗寫成「照現行的 git grep failed 處理」,與 requirement 的這一句互相矛盾。另外,這時的原因文字帶著 git 的錯誤訊息,裡面可以有本機的絕對路徑,而這段文字會進 verify 報告。..的段(fsck 只給警告);或工作樹裡有一個指向外面的 symbolic link,而 tree 記錄的 gitlink 路徑經過它。os.path.islink只看最後一段,擋不住後者。結果是links在受檢 repo 以外的 repository 跑 git,用的是那個 repository 的設定與物件庫;原因文字還會因為那個位置上有沒有工作樹而不同。讀到的內容仍然是對的,問題在 git 在哪裡執行。rev-parse --show-toplevel的輸出用.strip()處理,連路徑結尾的空白一起去掉。路徑結尾是空白的 submodule 已經取出、記錄的 commit 也有標記,卻被回報成 not checked out。Example 第 3 列只測了中間有空白的路徑。error。它的檔案本來就不算,所有可能算數的檔案其實都讀過了,正確的結果是missing。第 15 列只測了取出的情況。rev-parse的每一種失敗都被報成 not checked out。繼承到的GIT_DIR會讓取出的 submodule 被回報成缺 commit;因為擁有者不同而被 git 拒絕開啟的 submodule、壞掉的 gitfile、不認得的 repository extension 也都標成同一個原因。issue 的 Expected 要links說明原因。status 不會因此變成錯的ok或missing,錯的是原因。git grep在錯誤輸出印出訊息、結束碼仍是 1,被當成「搜尋過、沒有標記」而回missing。改動之前也是missing,所以不是 regression,但新的 requirement 說沒讀完的不回報成缺少。spec-change.py檔頭的說明只寫「找不到而有 submodule 搜尋不了時回 error」,沒有寫 submodule 要取出、要有記錄的 commit 才搜尋得了。issue 的 Expected 第三點要求 script 的說明也寫明。.gitmodules卻沒有對應項目的路徑,讓找不到標記的 Example 回error,原因是 not checked out;references/spec-wrapper.md叫人取出 submodule,而這種路徑無法取出。idd-worktree.sh建的 worktree 跑 verify 時,沒有任何步驟取出 submodule,links會回error。這是要的結果,原因也點名了 submodule;但只有references/spec-wrapper.md提醒要先取出,idd-verify的文字沒有。不是這個 diff 的缺陷。Scope Check
改動都在 #548 的範圍內。沒有任何項目被擱置。
以下三點是說明,不列成列。
idd-verify把沒有 JSON 的輸出讀成error,references/spec-wrapper.md第 5 步規定沒有印出 JSON 就停下,所以它是往保守的方向失敗。真正被破壞的是「主 repo 已找到標記」的情況,已經在第 2 列。error。這個讀法對不對由維護者決定,這一輪沒有評。第 2 列說的是程式沒有照這個讀法做到底。接下來:依
/idd-all的規則修正第 1 列到第 12 列(新的 Spectra change,先寫測試),再跑第二輪,也是最後一輪。第 13 列另開 issue。kiki830621 commentedon Nov 14, 2026
Follow-up Findings Filed
verify 報告(留言 6876450742)第 13 列:
第 1 列到第 12 列在這條分支上修正(新的 Spectra change),修完跑第二輪。
kiki830621 commentedon Nov 14, 2026
Implementation Complete
Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening
這一則取代先前的實作摘要:第一輪 verify(FAIL,2 項 blocking、10 項要修)之後的修正都在裡面。第二個 Spectra change
idd-548-links-submodule-hardening已封存在7ad9152;進度與驗收紀錄見openspec/changes/archive/2026-11-14-idd-548-links-submodule-hardening/tasks.md。第一輪之後改了什麼
.或..的段;解開 symbolic link 之後仍在主 repo 的工作樹之內;目錄本身不是 symbolic link;目錄底下有自己的.git;git 回報它是自己工作樹的頂層;物件庫裡有記錄的 commit。前四個不成立時不在那裡跑任何 git 指令(第 1、3、9 列)。safe.bareRepository=explicit、關掉 lazy fetch、拿掉六個繼承來的GIT_*變數(第 1、6 列)。檢查不向遠端抓任何東西。rev-parse的輸出只去掉結尾的一個換行(第 2、4 列)。掛在規格目錄底下的 gitlink 略過(第 5 列)。原因最多列五個 submodule,依路徑排序,過長的路徑截斷(第 12 列)。spec-change.py檔頭寫明 submodule 要取出並有記錄的 commit 才搜尋得了(第 10 列);references/spec-wrapper.md補上檢查前先取出 submodule、部分 clone 要先備齊物件、沒有.gitmodules項目的路徑無法取出(第 11 列);CHANGELOG 的 spec-change.py links:標記在 submodule 的測試檔裡時找不到,一律回報 missing #548 條目改寫成最後的行為。括號裡的列號是第一輪報告(留言 6876450742)的列。
怎麼驗證的
afd0021):587 通過、61 失敗。其中「植入的指令沒有執行」(第 21、22、31 列)與「沒有抓取」(第 32、33 列)在舊 script 上失敗,所以這些檢查分辨得出第一輪找到的問題。配新 script:648 通過、0 失敗。afd0021的 497 項與6ed8dec的 431 項都通過,既有的檢查沒有少。6ed8dec的 script,輸出與結束碼逐位元組相同:沒有 gitlink 的 repo(這個 repo 自己的三段歷史);有 gitlink 而標記都在主 repo 的臨時 repo(含一個路徑不是合法 UTF-8 的 gitlink)。ok;形狀像 git 目錄的資料夾 →error、原因是 not checked out、指令沒有執行。GIT_INDEX_FILE:這裡只讀記錄的 commit、不讀 index,留著它不改變任何輸出,寫不出會失敗的測試;design 把它記成明文例外。run-all-tests.sh74 個 suite、0 個失敗;spectra-archive-post-ic141 通過。第一輪審過的 HEAD(afd0021)上的第二次整套測試也是 74 個 suite、0 個失敗。6ed8dec到7ad9152:{"status": "ok", "missing": [], "reason": ""}。套用到規格的 requirement 與 delta 逐字相同(腳本比對)。誰寫的、誰看過
spec-change.py的改動與文件:實作者模型(Codex)依工作單完成,協調者(Claude)在它寫不到的目錄驗收。spectra-verify之後:submodule 搜尋「結束碼 0、只符合不算數的檔案、又有檔案讀不到」時算搜尋不了的那個分支;第 36 到 41 列;第 22 列記錄 git 呼叫的檢查;判斷檔案內容在不在物件庫的輔助函式。spectra-verify讀的是補強之前的檔案,而且沒有執行測試;它的三項 warning 都重現或確認後處理了(tasks 4.1)。無人值守時取的預設
error(Diagnosis 的 Choice Default Record)。這次的「找到就停」是把這個讀法做到底,沒有換讀法。等維護者確認。Commits(branch
idd/548-spec-change-py-links-submodule-missing,還沒推)第一輪之前的六個(
9ebccfd到afd0021)不變。第一輪之後:66beef4test:第 16 到 41 列57ee7e2fix:找到就停、只在取出的 submodule 跑 git7ad9152chore:封存 changeNext: verification pending
kiki830621 commentedon Nov 14, 2026
Verify: #548 (round 2)
第二輪,也是最後一輪。審的是整條分支對預設分支的 diff,審查者另外拿到第一輪的表與第一輪之後三個 commit 的 diff。分支只在本機,還沒有推上來。
Engine
pai ensemble(parallel-ai-agents 2.26.0,profile custom):requirements、logic、security、regression 四席與 devil's advocate 用 Claude opus,另一席是 Codex(gpt-6.1-sol,xhigh)。devil's advocate 讀過前五席的結果,並自己做了變異測試與重現。協調者另外在臨時 repo 上重現了第 1 列的 (a)、第 2 列與第 4 列。
6 / 6 reviewers completed
Aggregate
FAIL — 1 blocking, 6 in-scope fix, 1 follow-up, 0 rejected
Reviewed:
6ed8dec5895f6c88a24aa0ecdf1e3b2b0e635bdd..7ad9152fa1dbd0714970754b97654c0274644a05要求覆蓋率
3 / 3 requirements addressed
issue 的三點 Expected 都成立(requirements 席逐點對照):讀記錄的 commit、搜尋不了時回
error並說明原因、說明文件寫明 submodule 要取出。成立的部分
.、留著兩個繼承的變數、主 repo 找到後繼續走訪,這六個變異分別被第 38、37、39、41、40、22 列擋下。判斷檔案內容在不在的輔助函式,對「在」與「被抓回」兩種情況都判得出來。links回ok;archived回 pass;套用到規格的 requirement 與 delta 逐字相同。tests/spec-change/test.sh648 項通過。diff 與封存的檔案裡沒有寫給審查者的指示。Findings(合併後)
cmd_links有兩處改動讓沒有 submodule 的 repo 也得到不同的結果。(a)links不再呼叫repo_top(),改成自己讀頂層目錄、只去掉結尾的一個換行:頂層目錄名稱以空白結尾的 repo,分支之前回error(原因是不實的「revision does not exist」),現在回正確的答案;archived與preflight仍用舊的repo_top(),所以同一個 repo 上三個子命令的判斷不一致。(b)except擴大到整個cmd_links:規格目錄底下有路徑不是合法 UTF-8 的 capability 時,分支之前以 traceback 結束(結束碼 1),現在回一行error、結束碼 2,原因是 Python 的例外文字。另外,主 repo 找不到標記時多跑一次列 gitlink 的指令,失敗時的原因帶 git 的錯誤訊息;design 有寫,requirement 沒有。devil's advocate 的讀法:這幾處都是把舊的錯誤修好,沒有任何先前正確的答案被改掉,錯的是 requirement 那句話,以及驗收時用來比對的 repo 沒有這類名稱,所以量不出來;他認為該改的是那句話並補 Example 的列,不是把程式改回去。依審查規則(diff 裡的行為改變沒有任何 requirement 寫明),這一列是 HIGH。marker_files()有兩處在列出 gitlink 之前就跳到下一個:git grep的結束碼不是 0 或 1,以及沒找到算數的檔案而有錯誤輸出。外層 submodule 少了一個無關的檔案內容、tree 仍讀得到,而標記在一個取出而且完整的巢狀 submodule 裡時,links回error、只點名外層;外層完整時回ok。requirement 寫 submodule 的 submodule 的檔案算數,也寫一個 submodule 找到標記就確定了,沒有任何一句或任何一列 Example 說搜尋失敗的 submodule 的子項不看。方向是保守的:只會多回error,不會給錯的ok或missing。cmd_links的if files:改成if files and not unavailable:,648 項仍然全過。另外,把錯誤輸出的檢查移到逐行比對之前(submodule 已經找到算數的檔案、同時有錯誤輸出時也算搜尋不了),648 項也全過。現行程式在兩種情況都是對的(實測回ok),缺的是測試:第一輪第 2 列那一類缺陷若在 submodule 這一層重新出現,沒有檢查會失敗。協調者的變異表只拿掉防護,沒有涵蓋這個性質。帶標記的測試沒有執行它的 Example 所寫的事,依審查規則是 MEDIUM。GIT_TRACE=1或GIT_TRACE2=1、submodule 裡有名稱像那個 commit 雜湊的分支(git 警告名稱有歧義)、有已淘汰的 grafts 檔(git 印出提示)。這時missing變成error,而原因說的是一件程式沒有檢查過的事;requirement 的括號「(something could not be read)」也是。與第 2 列合起來,一個完全健康、標記在巢狀 submodule 的 repo,在GIT_TRACE=1之下從ok變成error。design 的 Risks 把「警告也算進去」當成可接受的保守方向;regression 席認為那個理由站不住,給 MEDIUM,其餘各席與 devil's advocate 給 LOW。這個分支是協調者寫的。修法有兩種:只認 git 的error:與fatal:行;或不靠錯誤輸出,列出記錄的 commit 的每個檔案內容、確認都在物件庫裡。links依賴兩個 git 的功能而沒有檢查版本,也沒有寫明最低版本:safe.bareRepository(git 2.38 起)與GIT_NO_LAZY_FETCH(security 席查到是 git 2.45 起;script 裡另一處註解寫支援 git 2.31)。較舊的 git 會忽略它們。第 31 列只靠safe.bareRepository擋,不過它的前提(一個空的.git目錄)不可能由 commit 的內容造出來。第 32、33 列與 CHANGELOG 的「nothing is fetched into submodules」在較舊的 git 上不成立:部分 clone 的 submodule 會向它自己設定的遠端抓物件,也可能停在等候輸入帳密。design 的 Risks 提到測試會在舊 git 上失敗,但那只保護這個 repo 的 CI,不保護使用者的執行。submodule.recurse的那一步沒有失敗檢查,之後也沒有確認設定生效;script 的答案本來就不依賴這個設定,所以設定沒寫進去時這兩列照樣通過。references/spec-wrapper.md叫人在檢查前跑git submodule update --init --recursive。在別人寫的分支上,這個指令會向那條分支的.gitmodules指定的位址抓東西,文字沒有提醒這一點。color.ui或color.grep設成 always 時,每個標記都被回報成missing(輸出夾了色碼,舊 script 與新 script 都一樣);檔名裡有換行時,規格目錄底下的標記會被算進去;主 repo 裡帶標記的檔案內容讀不到時回missing,而 submodule 裡同樣的情況現在回error。Scope Check
改動都在 #548 的範圍內。沒有任何項目被擱置。
以下三點是說明,不列成列。
ok。表上取各席裡最高的評級。接下來:兩輪 verify 已經用完,這一輪之後不再自動修正,也不再開第三輪。第 1 到 7 列留在分支上等維護者決定;第 8 列另開 issue。
kiki830621 commentedon Nov 14, 2026
Follow-up Findings Filed
第二輪 verify 報告(留言 6878222878)第 8 列:
第 1 列到第 7 列留在這條分支上等維護者決定;兩輪 verify 已經用完,沒有自動修正,也沒有開第三輪。
kiki830621 commentedon Nov 14, 2026
Decision(2026-11-14,第二輪 verify 之後)
維護者在選項式提問裡選了下面四項。問題與選項的文字是協調者寫的,維護者選了其中一個選項。
error:選「標記找不到才回 error (Recommended)」。選項的說明:「現在的做法:別處已經找到標記就算通過;到處都找不到、又有 submodule 沒看過時,才回 error。」這確認了 Diagnosis 的 Choice Default Record 取的預設 (a)。接下來:推分支;第二輪的第 1 到 7 列以第三個 Spectra change 修正(先寫測試),然後跑第三輪,只審這批修正。第三輪之後不再開下一輪。
test: links keeps searching inside a failed submodule, ignores git's …
fix: links asks git which objects a submodule lacks instead of readin…
chore: archive idd-548-links-search-completeness (#548)
kiki830621 commentedon Nov 14, 2026
Implementation Complete
Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening, idd-548-links-search-completeness
這一則取代先前的實作摘要:第二輪 verify(FAIL,1 項 blocking、6 項要修;留言 6878222878)之後的修正都在裡面,方向依維護者的決定(留言 6878497822)。第三個 Spectra change
idd-548-links-search-completeness已封存在726050b;進度與驗收紀錄見openspec/changes/archive/2026-11-14-idd-548-links-search-completeness/tasks.md。第二輪之後改了什麼
括號裡的列號是第二輪報告的列。
links、archived、preflight用同一個方式讀頂層目錄,只去掉 git 加的行尾,名稱以空白結尾的目錄三個子命令的判斷一致。規格目錄底下有路徑不是合法 UTF-8 時,回固定的原因,不帶例外文字。git rev-list --objects --no-walk --missing=print,不抓取)。缺物件的 submodule 照樣搜尋,找到算數的檔案就確定;沒找到時,缺物件、搜尋以 0 與 1 以外的結束碼結束、或 tree 列不出來,才算搜尋不了。git is older than 2.45(第 5 列)。主 repo 找到標記時不檢查版本。submodule.recurse真的設成了true;第 22 列另外確認沒有列 gitlink 的呼叫,並附一個會留下這種呼叫的對照。references/spec-wrapper.md寫明取出 submodule 會連到那條分支的.gitmodules指定的位址,只在信任它時執行,並寫明最低的 git 版本;spec-change.py檔頭與 CHANGELOG 的 spec-change.py links:標記在 submodule 的測試檔裡時找不到,一律回報 missing #548 條目改成最後的行為。怎麼驗證的
7ad9152):724 通過、21 失敗。失敗的是非 UTF-8 那一列的原因、第 42、46、47 列、archived與preflight的頂層目錄兩列,也就是第二輪指出的行為。配新 script:745 通過、0 失敗。7ad9152的 648 項、afd0021的 497 項、6ed8dec的 431 項都通過,既有的檢查沒有少。6ed8dec的 script,輸出與結束碼逐位元組相同:沒有 gitlink 的 repo(這個 repo 自己的三段歷史);有 gitlink 而標記都在主 repo 的臨時 repo。GIT_TRACE=1都回missing,而且是同一行;外層缺一個無關的檔案內容、標記在完整的巢狀 submodule 裡,回ok;頂層目錄名稱以空白結尾的 repo 回ok。GIT_INDEX_FILE;submodule 的 tree 列不出來時不另外記原因。run-all-tests.sh74 個 suite、0 個失敗;spectra-archive-post-ic141 通過。封存之後的 HEAD 上tests/spec-change/test.sh再跑一次,745 通過。6ed8dec到726050b:{"status": "ok", "missing": [], "reason": ""}(這條分支的 script 與已安裝的 4.0.1 都是這個答案)。套用到規格的兩個 requirement 與 delta 逐字相同(腳本比對)。與工作單不同的兩處
error、只點名外層,所以這一列固定的是答案不變。分辨得出第二輪第 2 列的是第 42 列。預期寫錯,不是實作的問題。git grep failed:加上 git 錯誤輸出的前 200 個字元,實測設了GIT_TRACE=1時那段文字會跟著變。這個行為沒有改,requirement 現在照實寫它,並有一列 Example 與兩項檢查固定。誰寫的、誰看過
spec-change.py的改動與文件:實作者模型(Codex)依工作單完成,協調者(Claude)在它寫不到的目錄驗收。實作者的工作在寫完程式與文件之後被中途停下,沒有交回報,所以它這一部分的檢查全部由協調者重跑。7ad9152相同);第 49 列(物件在、但已損壞);第 47 列的第二種情況(讀不出的版號);「what the link check reports」裡主 repo 的 tree 讀不到的那一列與兩項檢查;requirement 裡上面說的兩句限定,以及「讀不出版號時也這樣回報」幾個字。無人值守時取的預設
error:維護者已確認(留言 6878497822)。Commits(branch
idd/548-spec-change-py-links-submodule-missing,已推,沒有開 PR)第二輪之前的九個(
9ebccfd到7ad9152)不變。第二輪之後:1da57e1test:第 42 到 49 列、頂層目錄、補強的檢查f8fde3afix:問 git 缺哪些物件、搜尋失敗後仍列 gitlink、版本檢查、頂層目錄的讀法726050bchore:封存 changeNext: verification pending
kiki830621 commentedon Nov 14, 2026
變異測試清單(第三個 change 的驗收)
第三輪 verify 的 requirements 一席指出,封存的
tasks.md只記了變異測試的總數(34 種、32 種有檢查失敗),沒有逐項的結果,而且它寫的「把性質改壞的 13 種」與 design 列的 11 種對不上。封存的檔案不再修改,所以清單補在這裡。plugins/issue-driven-dev/scripts/spec-change.py一處,在複本上執行bash plugins/issue-driven-dev/scripts/tests/spec-change/test.sh,看有沒有檢查失敗。script 與測試檔是f8fde3a、1da57e1的內容。括號裡是失敗的檢查所屬的列(Example「markers in submodules」的列號,或檢查的名稱)。
已知的不足:P13 的檢查只比對原因的長度。第三輪發現把「前 200 個字元」改成「後 200 個字元」時沒有檢查失敗(報告的第 5 列),這一種變異不在上面的清單裡。
52 remaining items
docs: acceptance record of idd-548-fix7 (#548)
chore: archive idd-548-fix7 (#548)
kiki830621 commentedon Nov 15, 2026
Implementation Complete
Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening, idd-548-links-search-completeness, idd-548-links-unreadable-objects, idd-548-one-top-directory-requirement, idd-548-fix5, idd-548-fix6, idd-548-fix7
這一則取代先前的實作摘要。第七輪 verify(留言 6893428419)確認第七個 change 本身沒有問題,但找到一個更早就有的缺陷,落在兩行程式(2 項 blocking),另有兩句條文要改。維護者 2026-11-15 的決定記在留言 6894347661:改程式,再審一輪。四項都用第八個 Spectra change
idd-548-fix7處理,封存在e5022f4,進度與驗收紀錄見openspec/changes/archive/2026-11-15-idd-548-fix7/tasks.md。這個 change 另外多做了一步,是協調者在送審前自己找到的,決定記在留言 6894894048。第七輪之後改了什麼
/System/Volumes/Data/…)因此不再被當成另一個目錄。第七輪協調者的兩個重現(上游只改大小寫之後 pull;link 的目標寫成另一種拼法)現在都回ok。error變成ok:gitlink 記在OPENSPEC/specs/sub、clone 落在規格目錄openspec/specs/sub裡(它原本回error的原因正是第 5 個條件比對名稱)。另一個形狀,路徑經過一個指進規格目錄的 link,從這條分支的第一個 change 起就回ok,前七輪沒有人建過。Example 第 15 列說放在openspec/底下的 submodule 回missing。現在第 1、2 個條件通過之後,往上走經過的目錄裡有規格目錄時,這個 submodule 不搜尋,也不算搜尋不到;兩個形狀都回missing,git 不在那個目錄執行。後一個形狀的答案因此從ok變成missing。「Submodules」一段加了三句。ok)。61:樹裡記的路徑與磁碟上的目錄只差大小寫(ok)。62:link 指到頂層目錄之外、目標用另一種大小寫(error,git 不在那裡執行)。63:第 55 列的輸入改用這種 link(error,git 不在那裡執行,而且這次是由 git 目錄的比對擋下的)。64:路徑把規格目錄寫成另一種大小寫(missing)。65:link 指進規格目錄(missing)。git rev-parse --is-inside-git-dir確認頂層目錄在 git 目錄裡。這個配置下 git 2.55.0 回 true、git 2.54.0(macOS 內附的)回 false,舊的 git 在 PATH 前面時整個測試檔停在那裡。改成直接看檔案系統。這是量檢查項數時發現的,沒有改任何對 script 行為的檢查。怎麼驗證的
c3b5798)在程式修改(54d1775)之前:在c3b5798上測試檔 859 項通過、9 項失敗,失敗的是第 60 列的三項、第 60 列改用/System/Volumes/Data拼法的兩項、第 61 列的三項、第 63 列「git 被問過那兩個目錄」的一項。第 62 列與第 63 列的其他檢查修改前後都通過:第 62 列寫的是原本就有的行為;第 63 列的答案原本就對,但原本是被字串比對擋下的。第 64、65 列的 commit(65f7a17)在規格目錄的檢查(9fb5cc1)之前:870 項通過、8 項失敗,兩列各四項。tests/spec-change/test.sh878 項通過(spectra在 PATH 上、不分大小寫的磁碟),git 2.55.0 與 git 2.54.0 各跑一次都是。整套run-all-tests.sh:跑了三次,都是 75 個 suite、0 個失敗、結束碼 0:封存前的e01674e(第二步之前)與f6fe368,以及封存之後的e5022f4。.claude/scripts/tests/spectra-archive-post-ic/test.sh:三次都是 141 項通過、0 項失敗。spectra時是 876 項(不分大小寫)與 843 項(區分大小寫)。所以這五列的「測試先寫、先失敗」只在不分大小寫的磁碟上看得到,Linux 上的 CI 看不到它們;第 65 列在任何磁碟上都執行。ok,所以前兩種變異都讓它失敗。.git項目時由第 4 個條件回 not checked out,有的時候回ok,與第七輪的 script 相同);submodule 的 git 目錄就是那兩個目錄之一時,它底下的目錄回 path leaves the repository,git 不在那裡執行。3b87909)到e5022f4:{"status": "ok", "missing": [], "reason": ""}(這條分支的 script 與已安裝的 4.1.0 都是)。archived的結果在下一則驗證報告的規格檢查(這一則貼出之後才能對它執行)。這次沒有改、仍然比對名稱的地方
--cwd只交給 git 找頂層目錄,換一種大小寫答案不變。.md的排除,照條文看的是樹裡記的名稱。主 repo 的檔案記在OPENSPEC/specs/cap/check.sh、帶標記時,從 4.1.0 起就回ok,現在也是;它取出來會落在規格目錄裡,與上面 submodule 的處理不一致。改它會改變沒有 submodule 的 repository 的答案,超出這張的第三點 Expected,記在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559。協調者另外找過答案從
error變成ok的輸入。找到的都是第 60、61 列的形狀與既有各列的組合(第 59 列的形狀經由另一種拼法;兩個 gitlink 指同一個目錄),以及上面已經處理的規格目錄那一種。已知的限制
error結束,原因文字不在 requirement 列的六種裡(與 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559 第 18 點同一類)。誰寫的、誰看過
Commits(branch
idd/548-spec-change-py-links-submodule-missing,已推,沒有開 PR)第七輪之前的三十六個(
9ebccfd到941f881)不變。第七輪之後:c3b5798test:第 60 到 63 列的 fixture 與檢查,連同這個 change 的文件(這個 commit 上第 60、61 列失敗)54d1775fix:第 2、5 個條件改成比對目錄e01674edocs:CHANGELOG 與第 57 列的註解65f7a17test:第 64、65 列(這個 commit 上兩列都失敗)9fb5cc1fix:落在規格目錄裡的 submodule 不搜尋338da27docs:CHANGELOGf6fe368test:第 58 列的 fixturee5022f4)Next: verification pending
kiki830621 commentedon Nov 16, 2026
Verify: #548 (round 8)
第八輪。維護者在第七輪之後決定「改程式,再審一輪」(留言 6894347661),這一輪就是那一輪。範圍與前幾輪相同:預設分支(4.1.0)到分支最新的 commit
e5022f4,重點放在第七輪之後的第八個 changeidd-548-fix7(實作摘要是留言 6895459368)。這個 change 除了維護者點名的修正,還多做了一步(落在規格目錄裡的 submodule 不搜尋),是協調者依委託做的決定(留言 6894894048);審查者被明白告知這一步超出點名的範圍,可以反對。Engine
六席都交出了結果,各啟動一次,沒有席位被切斷。四個 Claude 審查席(requirements、logic、security、regression)與裁定席(devil's advocate):Claude Fable 5.2、effort medium、fast mode 關,用 Claude Agent SDK 以 API key 執行,不載入協調者這一端的設定。第六席是另一個模型家族:OpenAI
gpt-6.1-sol,單次請求、沒有工具,讀整份 diff 與 head 的 script。裁定席讀過其他五席的結果之後再審,自己另外建輸入重跑。協調者撰寫了這個 change,所以不分級;協調者只提供事實紀錄:先前量測的輸出、跨模型一席三個重現步驟用三份 script 實跑的結果,以及其中一項已經記在 #556 的出處。
6 / 6 reviewers completed
Aggregate
PASS — 0 blocking, 0 in-scope fix, 9 follow-up
Reviewed:
3b87909eb6db40ea89630665a172918270b738ad..e5022f43abfd692bc69a63221f2335014414330f要求覆蓋率
3 / 3 requirements addressed
issue 的三點 Expected,requirements 一席在它建的輸入上逐點實跑,都成立。第二點有一個條文寫明的例外(落在規格目錄裡的 submodule 回
missing,不回error),這個例外在 head 比第七輪寬,見下面「多做的那一步」。成立的部分
ok(第七輪的 script 回error);link 的目標寫成另一種大小寫、/System/Volumes/Data的拼法、Unicode 的另一種正規化形式,head 都回ok(第七輪都回error)。它另外試了沒有人列過的輸入(樹裡記的是 NFD 而磁碟上是 NFC、掛載在工作目錄裡的另一個磁碟、沿路有一層沒有搜尋權限的目錄),答案都是條文寫的那一個。logic 用 30 種兩種拼法的輸入對照第七輪的 script,head 的答案每一種都是條文寫的。security 用 20 種配置,把 clone 放在不該進去的地方,再用另一種拼法指過去:每一種都回error,git 沒有在那個目錄執行。裁定席對「沒有第二種拼法能打開被拒絕的目錄」約九成的把握,對「第 1、2 列在一般使用者或 git 會產生的拼法上完全解決」約八成五。c3b5798上測試檔 859 項通過、9 項失敗,正是實作摘要列的九項;65f7a17上 870 項通過、8 項失敗,是第 64、65 列各四項;head 上 878 項全過。這個證據只能用 git 2.55.0 重現:用 macOS 內附的 git 2.54.0 時,那兩個 commit 的測試檔停在第 58 列的 fixture(之後在f6fe368修掉),head 不受影響。regression 另外交叉跑:第七輪的測試檔對 head 的 script 是 840 項全過;head 的測試檔對第七輪的 script 是 861 項通過、17 項失敗,正是上面的 9 項加 8 項。status仍是error);in_spec_directory()裡讀不到目錄時的兩個分支不在八種裡面,它在那個函式另做一種變異(規格目錄改用lstat取),878 項全過,見下表第 3 列。archived與preflight沒有任何不同。在協調者的兩個量測輸入上,git 呼叫次數與第七輪相同(標記在 submodule 時 20 次、在主 repo 時 11 次;logic 重跑得到同樣的數字,它另建的一個輸入兩份 script 都是 38 次)。那兩個問題仍然只在遇到頂層目錄之後才問、整次只問一次。答案沒有變而次數不同的,logic 列了第 63 列寫的那一種:第七輪照名稱就拒絕的路徑,head 先問那兩個問題再拒絕(14 次對 12 次)。答案變了的輸入次數也跟著不同;每一層都有兩種拼法時的增長見下表第 5 列。.gitmodules與.gitattributes沒有讓任何程式執行。主 repo 自己是部分 clone 時,一次links留下 3 行抓取紀錄,head、第七輪與 4.1.0 都一樣:來自主 repo 原本就有的呼叫,新加的那兩個問題單獨執行是 0 行。這比這條分支早,security 不列為這一輪的發現。目錄比對只呼叫realpath、stat、samefile,不開檔、不啟動程式;commit 的內容只能透過 checkout 放到磁碟上的東西(一個被追蹤的 link、另一種大小寫的路徑)影響它,security 建的這類配置,在執行期間沒有人改動工作目錄時,不是被拒絕就是被略過,git 都沒有在不該進去的目錄執行。比對與之後的 git 指令之間有時間差,與第七輪是同一種。security 用會在中途換掉 link 的 git 替身跑了三種:link 換成指進主 repo 的 git 目錄、換成指到頂層目錄之外時,head 與第七輪的 script 都回ok,帶防護的 git 指令在換過去的目錄執行了 5 次;換成指進規格目錄時,第七輪回ok(5 次),head 回missing(0 次)。所以 head 沒有比第七輪寬,有一種比較窄。security 不把它列為發現:要做到這件事,得在執行期間能改寫主 repo 的工作目錄,有這個權限的人本來就能改 repo 自己的設定。第 60 到 65 列的 fixture 中途失敗時(七種各跑一次)不會動到測試暫存目錄之外。missing,git 不在那個目錄執行。security 另外試了六種走進規格目錄的方式(例如巢狀、各層用另一種大小寫、/System/Volumes/Data、經由 link 走到規格目錄),都擋住;它也反過來找這條規則能不能被用來把該回error的變成ok,沒有找到:被略過的 submodule 只會離開搜尋,ok需要找到標記。logic 用約二十種輸入(規格目錄設在別處、規格目錄不存在、submodule 自己有openspec/、同時不符合第 1 或第 2 個條件)找「規格目錄之外的被略過」或「裡面的被搜尋」,在規格目錄是真的目錄時沒有找到。裁定席裁定這一步照字面寫明了、與程式相符、不是缺陷,而且分支有它比沒有好(約八成五):沒有它,第 5 個條件的修正自己會讓規格目錄裡的一個標記開始算數。它超出維護者點名的範圍這件事是授權的問題,由維護者確認或推翻。spec-change878 項通過;另一個 suite 141 項全過。用 git 2.54.0 跑 head 的測試檔也是 878 項全過。在區分大小寫的磁碟映像上是 845 項全過,印出略過第 60 到 64 列的說明;少跑的 33 項就是這個 repo 的 CI 會少跑的。idd-548-fix7已封存,delta 與現行 requirement 逐字相同,規格的其他部分與第七輪逐位元組相同;links從預設分支到 head 回ok(分支的 script 與 4.1.0 都是),archived回 pass。Findings(合併後)
in_spec_directory()沒有確認規格目錄的路徑是目錄。工作目錄裡的openspec被換成一般檔案、某個 gitlink 的路徑又是那個檔案的硬連結時,那個 gitlink 被當成落在規格目錄裡而略過,links回missing;第七輪的 script 回error(not checked out),4.1.0 回missing。對照(不是硬連結的一般檔案)仍回error。規格目錄是目錄時不會發生(在這個檔案系統上目錄不能有第二個硬連結)。有兩種讀法:條文把「同一個目錄」定義成作業系統回報同一個裝置與 inode,照這個定義missing是寫明的答案;認為兩個路徑都不是目錄的讀者,會說這個答案沒有被寫明。改法是一行(確認是目錄)或條文的一個子句。openspec被換成指到頂層目錄的 link 時,條文的兩句有兩種讀法:前一句說目錄「是規格目錄或在它底下」的 submodule 不搜尋,後一句說規格目錄是「遇到頂層目錄之前經過的目錄之一」;頂層目錄永遠不在經過的目錄裡,所以程式照樣搜尋(ok,與第七輪相同)。把後一句讀成前一句的定義就沒有矛盾。spec_dir寫成.之類的值三份 script 都拒絕,所以只有工作目錄與 commit 不同時才走得到。可加一個子句:規格目錄就是頂層目錄或在它之上時,沒有東西算在它底下。openspec是指到另一個目錄的 link 時,那個目錄底下一般的 submodule 從ok(第七輪)變成missing(head),4.1.0 也是missing。原因是程式用會跟著 link 走的stat取規格目錄。條文只對 submodule 的目錄說了「解析 link 之後」,沒有對規格目錄說;沒有任何一列或檢查分得出兩種讀法(改用lstat的變異 878 項全過)。實作摘要沒有列這個形狀。可在條文寫明規格目錄也是解析 link 之後的目錄,或加一列。error變成ok。實作摘要提過這類輸入會從error變成ok(第 60、61 列的形狀與既有各列的組合,含第 59 列的形狀經由另一種拼法),沒有說的是這樣算進去的標記可以落在規格目錄裡。這與已記在 #559 的「主 repo 的檔案照名稱排除」是同一個問題,只是換成 submodule 的檔案。/.vol/<裝置>/<inode>)指到頂層目錄裡的目錄時,仍然回error(path leaves the repository),與第七輪相同:realpath不會改寫這種路徑,往上走是照名稱取上一層,走不到頂層目錄。條文的「its parent directory」有兩種讀法;取名稱上的上一層時(條文接著說「不存在的目錄略過」,只有照名稱走才會遇到不存在的目錄),程式照條文做。方向是保守的;用這種寫法指進 git 目錄或規格目錄也都被拒絕。這種 link 含裝置與 inode 編號,沒辦法經由 commit 分享。ok),而且已經記在 #556 的第 2 點;跨模型一席拿到的材料沒有 #556 的全文。不是這一輪的新發現。OPENSPEC/x、沒有取出的 submodule,在不分大小寫的磁碟上回missing,在區分大小寫的磁碟上回error,同一個 commit 在兩種磁碟上答案不同。Scope Check
分支的改動都在 #548 與八個封存的 change 的範圍內。
多做的那一步超出維護者點名的範圍,已在決定留言說明。它改變的答案比實作摘要列的兩個形狀多(實作摘要列的是:link 指進規格目錄,
ok變missing;用另一種大小寫記在規格目錄裡,error變missing)。各席另外列出:巢狀一層的 link 形狀(ok變missing),以及幾種從error變成missing的輸入(gitlink 的路徑本身就是指進規格目錄的 link、用另一種大小寫記在規格目錄裡又沒有取出、經由/System/Volumes/Data指進去)。這些都是條文照字面寫的。規格目錄本身是 link 的形狀見第 3 列。以下是說明,不列成列。
openspec換成檔案或 link);第 4 列需要樹裡記了另一種拼法,或手動放一個 link。missing。它說得很清楚,這是兩種讀法裡它取的一種。338da27是 head 的前一個 commit,其實是前三個(之後的兩個只改文件與封存)。花費與執行
五席 Claude 的用戶端估計是 3.60、3.97、3.45、3.00、3.68 美元,合計約 17.7 美元,回應都是標準速度。gpt-6.1-sol 一次請求約 0.64 美元。用戶端的估計與實際扣款是否一致還沒有核對。
下一步
照維護者的決定,這一輪之後停下來回報,不論結果。head 仍是
e5022f4,沒有開 PR、沒有 verified 的 tag、沒有合併。第 1 到 7 列與第 9 列補到 #559,第 8 列已在 #556。往下由維護者決定:多做的那一步要不要留;上面三處兩種讀法要不要在合併前各補一句;以及開 PR 讓 Linux 上的 CI 跑一次。kiki830621 commentedon Nov 16, 2026
Follow-up Findings Filed
第八輪 verify 報告(留言 6908861611)的後續項目補在 #559(留言 6908886968):第 1 到 7 列與第 9 列。第 8 列(主 repo 的檔名含換行)已經是 #556 的第 2 點,沒有再補。這一輪沒有 blocking,也沒有列為要在分支上修的項目,所以沒有另外開 issue。
kiki830621 commentedon Nov 16, 2026
決定:第八輪之後
維護者 2026-11-16 對第八輪 verify 報告(留言 6908861611)的三個選擇。題目與選項文字由協調者撰寫,維護者從選項中選定。
/.vol拼法)各是一行程式或一句條文,會隨合併一起出去,之後由 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559 處理。分支維持在第八輪審過的e5022f4。合併與發布還沒有決定。
kiki830621 commentedon Nov 16, 2026
CI 結果:draft PR #572 在 Linux 上失敗(2 個 suite)
PR #572(head
e5022f4)的第一次 CI(run 43819776536;ubuntu-26.04、git 2.56.1、Python 3.12):75 個 suite 裡 2 個失敗,其餘 73 個通過。1.
spec-change:停在第 50 列的 fixture,之後的檢查都沒有跑。FATAL: spec-change suite: fixture setup failed: the search of a submodule with an empty object must end with 0 or 1。停下之前通過的檢查到第 49 列為止。git grep跳過那個檔案、以 0 或 1 結束。協調者在 macOS 上用兩個版本對同一個輸入實跑:git 2.55.0 以 1 結束(error: … unable to read);git 2.56.0 以 128 結束(fatal: loose object … is corrupt)。CI 用的是 2.56.1。links對第 50 列的答案仍是error(its recorded commit could not be read),其他各列也都通過。壞掉的是 fixture 的前提檢查,以及 Example 那一列對 git 行為的敘述:「so the search skips the file and ends with exit code 0 or 1」從 git 2.56 起不成立。2.
edit-run:1 項失敗(the first backup id stays once),253 項通過。這是 #534 已經記錄的不穩定檢查(兩次更正落在同一秒時會失敗)。這條分支沒有改
edit-run的任何檔案;預設分支與其他 PR 最近的 CI 都通過。現況:PR 是紅燈,沒有合併。維護者稍早的決定是分支不再改(留言 6909585903)。要讓 CI 通過就得改測試檔與 Example 的那一列,這與那個決定衝突,所以停在這裡等維護者。
kiki830621 commentedon Nov 16, 2026
決定:修第 50 列的測試前提,不再審
維護者 2026-11-16 對 CI 結果(留言 6909882017)的選擇:在分支上修,不再開 verify 輪。題目與選項文字由協調者撰寫,維護者從選項中選定。這個決定只推翻留言 6909585903 第 2 點裡「分支不再改」對這一件事的適用;第八輪的後續項仍留在 #559。
範圍(第九個 change,
spec-change.py不動):tests/spec-change/test.sh第 50 列:git grep在空的物件檔上以大於 1 的結束碼結束時,不再讓整個測試檔停下;印一行說明這個 git 讓搜尋自己失敗,答案的檢查照樣執行。error)不變。test: row 50 of the Example "markers in submodules" runs whether git …
chore: archive idd-548-fix8 (#548)
kiki830621 commentedon Nov 16, 2026
Implementation Complete
Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening, idd-548-links-search-completeness, idd-548-links-unreadable-objects, idd-548-one-top-directory-requirement, idd-548-fix5, idd-548-fix6, idd-548-fix7, idd-548-fix8
這一則取代先前的實作摘要(留言 6895459368)。第八輪 verify 通過之後(留言 6908861611),draft PR #572 的第一次 CI 停在 Example「markers in submodules」第 50 列的 fixture(留言 6909882017)。維護者 2026-11-16 的決定記在留言 6910032608:修測試,不再審。這一項用第九個 Spectra change
idd-548-fix8處理,封存在ee3fcd9,紀錄見openspec/changes/archive/2026-11-16-idd-548-fix8/tasks.md。前八個 change 的內容不變,見上一則摘要。第八輪之後改了什麼
git grep在這個輸入上以 0 或 1 結束,否則停下。git 2.54.0 與 2.55.0 是以 1 結束;git 2.56.0 以 128 結束,CI 用的 2.56.1 也大於 1。現在 fixture 記下結束碼,大於 1 時印一行說明,答案的檢查兩種情形都執行。另一個前提(git 把那個物件列為存在)不動,不成立時仍然停下。error,its recorded commit could not be read。requirement 的條文與其他 64 列沒有動。spec-change.py沒有改。e5022f4..ee3fcd9對這個檔案沒有差異,第八輪審過的程式就是現在的程式。怎麼驗證的
run-all-tests.sh(封存之前,改過的工作目錄):75 個 suite、0 個失敗;.claude/scripts/tests/spectra-archive-post-ic/test.sh141 項通過。links從預設分支(3b87909)到ee3fcd9回ok(這條分支的 script 與已安裝的 4.1.0 都是);測試檔在封存後的 commit 上 878 項通過。ee3fcd9)通過:75 個 suite、0 個失敗,spec-change與edit-run都在其中,post-ic 那一步 141 項通過。CI 的紀錄只印每個 suite 通過與否,不印通過的 suite 跑了幾項檢查,所以spec-change在 Linux 上的項數沒有數字。第一次 CI(run 43819776536;heade5022f4)是失敗的,見留言 6909882017。已知的限制
誰寫的、誰看過
第九個 change 的文件、規格差異與測試修改都由協調者(Claude)撰寫,沒有實作者模型,也沒有人獨立讀過。
Commits(branch
idd/548-spec-change-py-links-submodule-missing,已推,draft PR #572)第八輪審過的四十五個(
9ebccfd到e5022f4)不變。之後:6178467test:第 50 列的 fixture,連同這個 change 的文件ee3fcd9chore:封存idd-548-fix8Next
合併與發布等維護者決定。
Checklist
結案時補上(2026-11-16):Diagnosis 的 Strategy 五項,逐項對照合併後的預設分支(
28e0de2,內容與分支的ee3fcd9相同)。先前九則實作摘要都沒有這一段。plugins/issue-driven-dev/scripts/tests/spec-change/test.sh。改了行為的七個 change,各自的 tasks.md 都記有新測試配舊 script 時失敗的項目;第五個 change 只搬標記、第九個 change 只改 fixture,沒有這一步。plugins/issue-driven-dev/scripts/spec-change.py:列舉 gitlink、逐一搜尋、無法判定時回error。plugins/issue-driven-dev/references/spec-wrapper.md、plugins/issue-driven-dev/CHANGELOG.md。idd-implement與idd-all裡講標記的句子 — 沒有改。第一個 change 的 design 把其他 skill 的文字劃在範圍外;這兩句只說測試檔帶標記,沒有說標記要在哪一個 repository,合併後仍然成立。links從預設分支到分支 head 回ok;archived通過。spectra-verify— 只有前兩個 change 在封存前跑過,第三到第九個 change 的封存紀錄裡沒有它。第三到第八個 change 的內容由第三到第八輪 verify 讀過;第九個 change 的紀錄有spectra validate,沒有人獨立讀過。(2026-11-16 更正:這一項原本寫第三到第八個 change 跑的是spectra validate,封存紀錄裡查不到;也把「第二到第八輪」改成「第三到第八輪」。)feat: spec-change.py links reads markers in submodules and answers er…
kiki830621 commentedon Nov 16, 2026
Closing Summary
Problem
spec-change.py links只在主 repo 找 Example 的標記(spec-example: <capability> / <Example title>)。測試放在 submodule 的專案,每一個 Example 都被回報成missing,連結檢查因此過不了;訊息說的是「沒有標記」,實際上是檢查沒有看那裡。Root Cause
marker_files()對<head>的樹跑git grep。git 搜尋一棵樹時不會走進 gitlink,程式也沒有另外列出 gitlink,所以 submodule 裡的檔案從來沒有被讀過。檢查沒有看過的地方卻回missing,把「看不到」說成了「沒有」。Solution
links自己列出<head>的 gitlink,逐一在記錄的 commit 上搜尋,含巢狀。一個 Example 有三種結果:找到標記是有連結;沒找到而且每個 gitlink 都搜尋過是missing;沒找到而且有 gitlink 搜尋不了是error,原因點名那個 Example 與路徑。GIT_DIR、GIT_WORK_TREE、GIT_INDEX_FILE、GIT_OBJECT_DIRECTORY、GIT_ALTERNATE_OBJECT_DIRECTORIES、GIT_COMMON_DIR);目錄的比對看作業系統回報的裝置與 inode,不看路徑名稱。plugins/issue-driven-dev/scripts/tests/spec-change/test.sh有對應的檢查。九個 Spectra change 都已封存。Verification
3b87909..e5022f4:0 項 blocking、0 項要修、9 項留給別的 issue。idd-548-fix8):只改測試檔第 50 列的前提檢查與 Example 那一列的敘述,spec-change.py沒有變。這個 change 沒有人獨立讀過,是維護者的決定(留言 6910032608)。e5022f4)失敗,spec-change停在第 50 列的 fixture(git 2.56 起,空的物件檔讓git grep以 128 結束);第二次(headee3fcd9;ubuntu-26.04、git 2.56.1)通過,75 個 suite、0 個失敗。28e0de2):結案時還在跑(run 43830800147);結果記在下面的 Distribution Sync。28e0de2,它的樹與ee3fcd9的樹相同。合併後的三項檢查:分支的內容都落在預設分支上;九個 change 在28e0de2上都已封存;links從3b87909到28e0de2回ok(已安裝的 4.1.0 與合併後的 script 各跑一次)。Changes
28e0de2feat: spec-change.py links reads markers in submodules and answers error when it cannot decide(PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572,squash;分支idd/548-spec-change-py-links-submodule-missing上的 47 個 commit,分支保留)plugins/issue-driven-dev/scripts/spec-change.py(+292 −25)plugins/issue-driven-dev/scripts/tests/spec-change/test.sh(+1006 −7)openspec/specs/spec-on-every-issue/spec.md(+88 −1)plugins/issue-driven-dev/CHANGELOG.md(+44)、plugins/issue-driven-dev/references/spec-wrapper.md(+3)結案時的狀態
[Unreleased],已發布的版本仍是 4.1.0。要不要發布、用哪個版本號,由維護者決定。idd-implement與idd-all裡講標記的句子沒有改(兩句都沒有說標記要在哪一個 repository);spectra-verify只在前兩個 change 封存前跑過,第三到第九個 change 的封存紀錄裡沒有它。Residue Acknowledgement
residue declared as
(none)at diagnose time — no acknowledgement needed更正於 2026-11-16:
spectra-verify那一句原本寫第三到第九個 change 跑的是spectra validate,封存紀錄只有第九個 change 記了它,已改成查得到的說法;links那一項改成合併後重跑的結果;Solution 原本寫拿掉繼承的GIT_*變數,程式拿掉的是列出的六個,已改。Distribution Sync
issue-driven-dev,這個 repository 的 marketplace 列出的一個 plugin)28e0de2上 1 項檢查,通過(run 43830800147;75 個 suite、0 個失敗;ubuntu-26.04、git 2.56.1)6c26645(chore: release 4.2.0)的 CI 通過(run 43849981801;75 個 suite、0 個失敗);tagissue-driven-dev-v4.2.0打在6c26645;marketplace 的版本與這台機器安裝的版本都是 4.2.0chore: release 4.2.0