Leo
5d762440b7
- status.md：T0.5–T5 實作完成、PR #3/#4 拆分、issue #2 close、下次 merge 順序 + 部署待驗 - mistakes.md：① 功能 PR 別混 template 遷移（拆 PR）② 跨 repo 契約漂移先查總管裁定別自決 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
29 lines
1.8 KiB
Markdown
29 lines
1.8 KiB
Markdown
# CC 已知誤解 + 避坑方法
|
||
|
||
> 做新功能前讀一遍。
|
||
> 格式：每條必須有症狀 + 正確做法 + 原因。
|
||
|
||
---
|
||
|
||
## 快速檢查清單（做任何事前）
|
||
|
||
- [ ] 有對應 SDD 嗎？沒有 → 停手
|
||
- [ ] 這次修改會影響哪些模組？有沒有連帶破壞？
|
||
- [ ] 驗收標準是什麼？有客觀證據嗎？
|
||
|
||
---
|
||
|
||
## 誤解記錄
|
||
|
||
⚠️ MISTAKE: 功能 PR 混進 template 1.9.x 知識庫遷移（system-dev/ + .claude/）
|
||
症狀: 開功能分支時順手把 wiki-init / template 遷移的 system-dev/、.claude/ 一起 commit 進同一筆，PR 同時含「功能改動」+「基建遷移」。
|
||
正確做法: 功能與基建分兩個 PR。功能 PR 只留 src/tests/contracts/config/SDD-tasks；template 遷移（system-dev/ + .claude/ + SDD 位置搬移）獨立成筆、本 repo 自行 merge。從乾淨分支重建：reset 回 main → 只 stage 核心 → force-with-lease 蓋功能 PR；遷移另開分支。
|
||
原因: ① 淹沒真正改動、審查難 ② 多 repo 同跑 1.9.x 遷移會撞衝突（graph 撞過）③ 可能夾私稿。system-dev/ 該進 git，但走自己一筆、不混功能、別 gitignore 它。
|
||
日期: 2026-06-26
|
||
|
||
⚠️ MISTAKE: 抓到跨 repo 契約漂移時自己拍板對齊方向
|
||
症狀: 發現 graph 部署端 .strict() Zod 比凍結 contract 窄（會 422 新欄位）→ 想直接決定 ingest 該送哪個版本。
|
||
正確做法: 契約是雙邊事 → 先查總管在相關 issue 的裁定（graph#1 已裁「contract 是 SSoT、實作追它、graph receiver 補對齊、ingest 不退」），照裁定做、別自決。跨 repo 修正要先問人。
|
||
原因: contract 是凍結單一真相源（三守則）；單邊擅自退讓或改 contract 會破壞雙邊共識。見 [[envelope-契約]]。
|
||
日期: 2026-06-26
|