docs(sdlc): 同步文件與參考資料

What:更新 README、AGENTS.md、templates 與 references,讓文件敘述與實際行為一致。

Why:稽核發現多處文件與程式行為分歧,違反「每個意義只有單一真實來源」。

How:以實際程式行為為準改寫敘述,重複的規則收成單一來源並以一行指引指過去。

Who:jsc-meta:skill-check 例行稽核(2026-08-25)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-25 14:58:54 +08:00
co-authored by Claude Opus 5
parent b78f7e8b3f
commit 821261ad9d
10 changed files with 79 additions and 87 deletions
+8 -8
View File
@@ -15,7 +15,7 @@
- 工作目錄:{關鍵檔案與結構摘要}
- 複用來源:[REPO_{HASH}]({REPO 頁絕對網址})(commit sha:`{sha}`)
- 複用決策:{複用哪些方法/端點、為什麼;不複用的原因}
- 複用決策:{複用哪些方法、端點、為什麼;不複用的原因}
## 未決項
@@ -27,15 +27,15 @@
## 工作分解結構(WBS)
`WP-01` 固定是交付/交接工作包,獨立成一包,不與實作合併;用到它規格的實作工作包相依於它。
交付型別於實作階段開工時確認(API 文件/由使用者輸入)。
資料來源欄記錄範例資料的出處:`真實:{來源}` 或 `推論:無來源`。
`WP-01` 固定是交付、交接工作包,獨立成一包,不與實作合併;用到它規格的實作工作包相依於它。
交付型別於實作階段開工時確認(API 文件、由使用者輸入)。
資料來源欄記錄範例資料的出處:`真實:{source}` 或 `推論:無來源`。
PR 欄記錄該工作包的 PR 連結與編號;PR 未合併前不得開始下一個工作包。
| 編號 | 工作包名稱 | 交付 | 交付型別 | 相依 | 工時(h) | 天數 | 資料來源 | 工作證 | PR | 狀態 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| WP-01 | {交付/交接:規格與介面定義} | 是 | API 文件 | - | {h} | {d} | 真實:{來源} | | | 未完成 |
| WP-02 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 真實:{來源} | | | 未完成 |
| WP-01 | {交付、交接:規格與介面定義} | 是 | API 文件 | - | {h} | {d} | 真實:{source} | | | 未完成 |
| WP-02 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 真實:{source} | | | 未完成 |
| WP-03 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 推論:無來源 | | | 未完成 |
- 關鍵路徑:{WP-01 → WP-02 → ⋯⋯},總天數 {d}
@@ -43,10 +43,10 @@ PR 欄記錄該工作包的 PR 連結與編號;PR 未合併前不得開始下
## 待辦事項(TDD)
### WP-01 {交付/交接工作包名稱}
### WP-01 {交付、交接工作包名稱}
- [ ] 盤點端點與參數:{對象}
- [ ] 產出規格與範例資料(標明真實/推論)
- [ ] 產出規格與範例資料(標明真實、推論)
- [ ] 與使用者確認交付內容並產出交付文件
### WP-02 {工作包名稱}