jiantw83andClaude Opus 5
821261ad9d
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>
2.4 KiB
2.4 KiB
分析：{計畫名稱}
{PLAN 頁絕對網址}、{REPO 頁絕對網址} 由
jsc-gitea/tools/gitea.sh wiki-url取得。 跨頁型連結一律用絕對網址：不同頁型可能落在不同存取庫，[[頁名]]只在同一個 wiki 內解析。
- 頁名：
ANALYZE_{HASH} - HASH：
{HASH} - 對應計畫：[PLAN_{HASH}]({PLAN 頁絕對網址})
- 存取庫：
{owner}/{repo} - 來源分支：
origin/{使用者確認的分支}（head sha：{sha}，取自遠端） - 狀態：未完成
- 建立時間：{yyyy-MM-dd HH:mm:ss}
現況摘要
- 工作目錄：{關鍵檔案與結構摘要}
- 複用來源：[REPO_{HASH}]({REPO 頁絕對網址})（commit sha：
{sha}） - 複用決策：{複用哪些方法、端點、為什麼；不複用的原因}
未決項
| 項目 | 影響 | 預設處理 | 待決定者 |
|---|---|---|---|
| {項目} | {不決定會怎樣} | {暫定做法} | {誰} |
工作分解結構（WBS）
WP-01 固定是交付、交接工作包，獨立成一包，不與實作合併；用到它規格的實作工作包相依於它。
交付型別於實作階段開工時確認（API 文件、由使用者輸入）。
資料來源欄記錄範例資料的出處：真實：{source} 或 推論：無來源。
PR 欄記錄該工作包的 PR 連結與編號；PR 未合併前不得開始下一個工作包。
| 編號 | 工作包名稱 | 交付 | 交付型別 | 相依 | 工時(h) | 天數 | 資料來源 | 工作證 | PR | 狀態 |
|---|---|---|---|---|---|---|---|---|---|---|
| WP-01 | {交付、交接：規格與介面定義} | 是 | API 文件 | - | {h} | {d} | 真實：{source} | 未完成 | ||
| WP-02 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 真實：{source} | 未完成 | ||
| WP-03 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 推論：無來源 | 未完成 |
- 關鍵路徑：{WP-01 → WP-02 → ⋯⋯}，總天數 {d}
- 實作候補：{WP-02、WP-03、⋯⋯}
待辦事項（TDD）
WP-01 {交付、交接工作包名稱}
- 盤點端點與參數：{對象}
- 產出規格與範例資料（標明真實、推論）
- 與使用者確認交付內容並產出交付文件
WP-02 {工作包名稱}
- 撰寫 {對象} 的測試：{預期行為}
- 實作 {對象} 使測試通過
- 重構 {對象} 並保持測試綠燈