新增 WP-01 十項定案規格與 TODO.md 校正清單文件 #79

2026-09-08T01:17:49Z

jiantw83 commented

2026-09-08 01:17:49 +00:00

PR 描述

摘要

需求描述：這是 jsc 技能組（跨 11 個 jsc-{domain} 存取庫）待辦總表分析的交付、交接工作包。產出十項技術定案規格，以及五個未註冊存取庫（code、doc、persona、shared、code-review）的去向決議。另外整理 TODO.md 十五項狀態校正清單。
計畫名稱：無
計畫頁：無
分析頁：https://gitea.jsc.idv.tw/knowledges/ANALYZE/wiki/ANALYZE_0F1898406BE708ADBBD6DF66AFB16F3D0D8ACA0C#wp-01-定案規格交付包

變更內容

檔案	為什麼改
`references/wp01-baseline-decisions.md`	把分析頁裡十項定案規格整理成一份文件，讓後續十個以上工作包能直接引用定案內容，不必回頭翻找分析頁全文。
`references/wp01-todo-corrections.md`	TODO.md 不在任何存取庫底下，無法走 PR 修正，只能整理成一份校正清單，交使用者自行對照。

設計重點

每項定案都附出處與具體例子，方便後續工作包對照驗收。
F-01 決議把「不納入正本」這件事，對 delegate-spec.tsv 與 TODO.md 兩份不同表格各自的影響分開講清楚，不混為一談。
待辦校正清單分兩節：一節是狀態過期（欄位記著未動工，實際已完成或部分完成），一節是數字更新（單純數字對不上，跟狀態欄無關）。

測試結果

這是純文件工作包，沒有自動化測試。
改用既有檢核腳本當紅綠燈：swagger-detect.sh 判定本存取庫不支援 Swagger（結束碼 1），已跳過 API 文件稽核。
jsc-review:code-review 六組壞味道審查已跑過，抓到兩筆中等嚴重度發現（兩份文件內容重複）與八筆低嚴重度發現。中等嚴重度已修正，低嚴重度依判斷各自處理或保留原因。
另有一次事實查核，逐項比對 origin/develop 實際內容，抓到兩處錯誤：一處是 delegate-spec.tsv 誤判，一處是行數應為 23 行、原寫 32 行。兩處都已訂正。

前置 Push Request

無

# PR 描述 ## 摘要 - 需求描述：這是 jsc 技能組（跨 11 個 jsc-{domain} 存取庫）待辦總表分析的交付、交接工作包。產出十項技術定案規格，以及五個未註冊存取庫（code、doc、persona、shared、code-review）的去向決議。另外整理 TODO.md 十五項狀態校正清單。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：https://gitea.jsc.idv.tw/knowledges/ANALYZE/wiki/ANALYZE_0F1898406BE708ADBBD6DF66AFB16F3D0D8ACA0C#wp-01-定案規格交付包 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/wp01-baseline-decisions.md` | 把分析頁裡十項定案規格整理成一份文件，讓後續十個以上工作包能直接引用定案內容，不必回頭翻找分析頁全文。 | | `references/wp01-todo-corrections.md` | TODO.md 不在任何存取庫底下，無法走 PR 修正，只能整理成一份校正清單，交使用者自行對照。 | ## 設計重點 - 每項定案都附出處與具體例子，方便後續工作包對照驗收。 - F-01 決議把「不納入正本」這件事，對 `delegate-spec.tsv` 與 TODO.md 兩份不同表格各自的影響分開講清楚，不混為一談。 - 待辦校正清單分兩節：一節是狀態過期（欄位記著未動工，實際已完成或部分完成），一節是數字更新（單純數字對不上，跟狀態欄無關）。 ## 測試結果 - 這是純文件工作包，沒有自動化測試。 - 改用既有檢核腳本當紅綠燈：`swagger-detect.sh` 判定本存取庫不支援 Swagger（結束碼 1），已跳過 API 文件稽核。 - `jsc-review:code-review` 六組壞味道審查已跑過，抓到兩筆中等嚴重度發現（兩份文件內容重複）與八筆低嚴重度發現。中等嚴重度已修正，低嚴重度依判斷各自處理或保留原因。 - 另有一次事實查核，逐項比對 `origin/develop` 實際內容，抓到兩處錯誤：一處是 `delegate-spec.tsv` 誤判，一處是行數應為 23 行、原寫 32 行。兩處都已訂正。 ## 前置 Push Request - 無

jiantw83 added 1 commit 2026-09-08 01:17:50 +00:00

docs(wp01-baseline): 新增定案規格與待辦校正兩份參考文件 b8b5737bc3

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 定案規格交付包。

admin merged commit f047bdd49d into docs/wp01-baseline-decisions/main

2026-09-08 01:24:13 +00:00

admin deleted branch docs/wp01-baseline-decisions/delivery-spec

2026-09-08 01:24:13 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/meta#79