# Detect Clashes

> MEP 管線與結構（CSA）碰撞偵測，使用 Curve-to-Solid 策略進行干涉分析、視覺化與報告匯出。 TRIGGER when: 碰撞, 干涉, clash, MEP, 管線穿牆, 套管, 穿越, penetration, 碰撞偵測, 管線衝突

- Skill: `shuotao/detect-clashes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add shuotao/detect-clashes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shuotao/detect-clashes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shuotao (https://skillmd.com/u/shuotao)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/shuotao/detect-clashes

---


依據 `domain/mep-csa-clash-detection.md` 執行 MEP vs CSA 碰撞偵測。

## Prerequisites

- MEP 模型已連結至當前專案（CSA 為主模型）
- BEP 規定連結模式為「原點到原點」或「共用座標」

## Steps

1. 讀取 `domain/mep-csa-clash-detection.md` 取得完整 5 階段 SOP
2. **Phase 1 — 環境偵察**：
   - `get_linked_models` — 找到 MEP 連結的 LinkInstanceId
   - `query_linked_elements` — 取樣確認能讀取管線
   - `get_active_schema` — 確認 CSA 結構品類數量
3. **Phase 2 — 範圍界定**（與使用者互動）：
   - 確認 MEP 品類（Pipes / Ducts / CableTrays）
   - 確認管徑門檻、系統篩選、樓層範圍
   - 確認 CSA 對象（牆 / 樑 / 柱 / 板）
4. **Phase 3 — 碰撞運算**：
   - `detect_clashes` — 執行 Curve-to-Solid 碰撞偵測
5. **Phase 4 — 結果分析**：
   - 統計摘要、系統熱點、結構風險排序（柱 > 樑 > 板 > 牆）
   - 貫穿深度 > 500mm 特別警告
6. **Phase 5 — 視覺化與報告**：
   - `colorize_clashes` — 依 CSA 類別上色（柱紅/樑橘/板黃/牆藍）
   - `export_clash_report` — 匯出 CSV/JSON 報表
   - `select_element` + `zoom_to_element` — 逐筆導覽

## Error Handling

| 情況 | 處理 |
|------|------|
| 無連結模型 | 提示使用者先連結 MEP 模型 |
| 碰撞數量 > 1000 | 建議縮小範圍（限定樓層或系統） |
| 連結座標偏移 | 檢查 BEP 連結模式設定 |

## Related Skills

| 條件 | 建議技能 | 原因 |
|------|---------|------|
| 碰撞涉及防火牆 | `/check-fire-rating` | 管線穿越防火牆需設防火填塞 |
| 需要更精細上色 | `/colorize` | 依系統或嚴重度自訂配色 |
| 碰撞影響停車淨高 | `/check-parking-clearance` | 管線降低車位淨高 |