plan3d-harnesslisted
Install: claude install-skill yapeepee/agent-harnesses
# plan3d harness
管線:stage1 牆體(vision)→ normalize(程式)→ stage2 開��(vision,錨定牆)
→ stage3 房間(純程式 flood fill)+ stage3b 標註(便宜模型)
→ stage4 家具(vision,型錄 enum)→ validate → viewer/index.html 檢視。
## 常用操作
- 跑測試:`make test`
- 離線全管線:`make mock`(golden 回放,不需 API key)
- 真跑新圖:建 `jobs/<name>/source.webp`(+選配 meta.json calib),
`ANTHROPIC_API_KEY=... make run JOB=jobs/<name>`
- 驗證任何 scene:`make validate SCENE=path.json`
- 對 golden 計分:`make diff G=golden/001-2d-design/scene.json T=runs/<name>/scene.json`
- 檢視 3D:瀏覽器開 `viewer/index.html`;內嵌樣本一鍵切換,或把 scene.json 拖進視窗
## 修 prompt 的迴路
改 `prompts/stageN_*.md` → `make run JOB=...` → 看 `runs/<name>/diff_report.json`
的 missed/extra/moved → 只有改動的 stage 會重跑(content-hash 快取)。
分數史在 `runs/scores.jsonl`。
## 新增 golden
1. 手動(或半自動後人工修)解析成 scene.json,`make validate` 到 0 error
2. 放進 `golden/<name>/`:source 圖 + scene.json + meta.json(calib)+ notes.md(記錄簡化與已知警告)
3. `make mock` 確認管線邏輯對新樣本成立