Files
meta/references/wp01-todo-corrections.md
jiantw83 b8b5737bc3 docs(wp01-baseline): 新增定案規格與待辦校正兩份參考文件
What:新增兩份文件。wp01-baseline-decisions.md 收錄十項技術定案(雜湊分隔符、計畫名稱正規化、跨存取庫工作包編號起算、PLAN_CONTENTS 存取庫欄格式、工作日誌週次雜湊、舊日誌拆頁、輸出原則 lint 化範圍、CPM 圖涵蓋範圍、不監看時的相依判定、PR 疊包上限),並補上五個未註冊存取庫(code、doc、persona、shared、code-review)去向決議:全部不納入 marketplace 正本,維持獨立系統。wp01-todo-corrections.md 收錄 TODO.md 十五項狀態過期校正與五項數字更新。

Why:分析階段裁定的規格內容原本只寫在分析頁全文裡,後續工作包每次要引用都得回頭翻找。整理成獨立文件,附出處與具體例子,工作包可以直接引用,不必重新確認脈絡。另外,TODO.md 本身不在任何 git 存取庫底下,沒有分支也沒有 PR 可走,校正意見沒有地方能落地,只能整理成清單交使用者手動核對。

How:定案文件逐項附出處(對應分析頁或測試計畫段落)與可驗證的具體例子,方便日後照抄核對。待辦校正文件依「狀態過期」與「數字更新」分兩節整理,開頭寫明無法走 PR 的原因,並註明資料來源是同一輪盤點、以各存取庫 origin/develop 為準逐一核對得出。

Who:WP-01 定案規格交付包。
2026-09-08 09:08:36 +08:00

3.7 KiB

TODO.md 狀態校正清單

為什麼這份不走 PR

/root/plugins/TODO.md 不在任何 git 存取庫底下。/root/plugins 本身不是 git 存取庫,.git 底下只有空的 info/。沒有存取庫,就沒有地方可以開分支、送 commit、開 PR。

因此這份校正只能整理成清單,交給使用者參考。實際的檔案修改要靠使用者手動打開 TODO.md,對照下面的編號逐行更新。

這份清單分兩節:第一節是十五項狀態校正,第二節是五項數字更新。兩節的來源都是同一輪盤點(2026-09-07,分析頁「核對結果:TODO.md 有 15 項狀態過期」與後面那段五項數字敘述),11 個存取庫各自以 origin/develop 為準逐一核對得出。

第一節:十五項狀態校正

15 項待辦裡,TODO.md 記的狀態跟實際狀態對不上。其中六項(F-06、W-04、R-04、G-02、G-03、G-07)是「早就做完卻還記著未動工」——照舊表動工會做白工,這六項要優先改。其餘九項是「部分完成」,TODO.md 記著未動工,實際已經做了一部分,剩下的落差寫在證據欄裡。

編號 TODO.md 原記 實際狀態 證據
F-06 [ ] 未動工 已完成 hooks/comment-scope.sh:91 已含三種頁型
W-04 [ ] 未動工 已完成 hooks/templates/error-contents.md:13 起已是條列
R-04 [ ] 未動工 已完成 wire-cli.sh:1394-2270,十類 140 條自我斷言,五支 CLI 各有路徑
G-02 [ ] 未動工 已完成 issue.sh:81-88 只列既有標籤,90-103 對不到就回 4
G-03 [ ] 未動工 已完成 issue.sh:202-204 空集合就不寫進 payload
G-07 [ ] 未動工 已完成 wiki-to-issue/SKILL.md:25 完成條件已要求回報實際標籤
W-02 [ ] 未動工 部分完成 wiki-contents.sh:268-293 的 format 子命令已是共用轉檔唯一實作
W-05 [ ] 未動工 部分完成 wiki-contents.sh:168-174 取不出鍵就中止(不猜已在),差頁型對照表
W-06 [ ] 未動工 部分完成 check-contents-format.sh 已在,但驗的是暫存檔,不是真實頁面
F-04 [ ] 記六種缺庫 部分完成 站台已有 10 個 knowledges/ 庫,只缺 LEARN、ERROR、REPORT、TOOLING、MAINTAIN 五種
F-05 [ ] 未動工 部分完成 gitea.sh:70 已指名要設哪個變數並回 3。新缺失:那句訊息是英文,還沒改成中文
N-08 [ ] 未動工 部分完成 migrate-wiki.sh 已在,且認兩代舊演算法,差第 150 行 WANT 沒有「計畫名稱」候選鍵
A-11 [ ] 未動工 部分完成 analyze/SKILL.md:43 內文已要求每則待辦寫出驗收依據,缺的只有程式化擋關
R-01 [ ] 未動工 部分完成 三段抽出一段(deploy-verify.md),剩兩段仍逐字重複,其中一段 23 行四份相同(skill-new/SKILL.md:68-90 的「結束碼」路由表)
F-03 [ ] 記帶過期清單 部分完成 plugins/jsc 兩份 marketplace 與正本 diff 為空,已於 2026-09-01 手動對齊。「過期」這個說法不成立,但去向仍未定

第二節:五項數字更新

以下五項是 TODO.md 裡記的數字跟現況對不上,不牽涉狀態欄,只是數字本身要改。

項目 TODO.md 原記 實際數字
wire-cli.sh 總行數 2629 行 2860 行
implement/SKILL.md 總行數 113 行 162 行
skill-check 的 description 字元數 819 字元 1318 字元
delegate-spec.tsv 裡 probe 欄未接線(pending)支數 7 支 8 支
jsc-assist 的 jsc.requires 項數 4 項 5 項