# Element Coloring

> 元素上色工作流程：根據參數值對 Revit 元素進行顏色標記與視覺化。觸發條件：使用者提到上色、顏色標示、color code、highlight、視覺化標記、參數上色。工具：get_category_fields、get_field_values、query_elements_with_filter、override_element_graphics、clear_element_override、unjoin_wall_joins、rejoin_wall_joins。

- Skill: `shuotao/element-coloring` (Agent Skill)
- Install (CLI): `npx skillmds@latest add shuotao/element-coloring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shuotao/element-coloring/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/element-coloring

---


# 元素上色工作流程

執行前請先讀取 domain/element-coloring-workflow.md 了解完整流程與注意事項。

## Prerequisites

1. 視圖類型：平面圖用切割樣式、立面圖用表面樣式
2. 分類參數的確切名稱（用 `get_category_fields` 確認）
3. 與使用者討論顏色方案

## Workflow

### 步驟 1：清除舊覆寫
`clear_element_override` 清除目標元素的現有顏色

### 步驟 2：取消牆接合（如果上色對象是牆）
`unjoin_wall_joins` 避免接合導致顏色顯示不正確

### 步驟 3：查詢並分類
1. `get_category_fields` 確認參數名稱
2. `get_field_values` 取得參數值分佈
3. `query_elements_with_filter` 依參數值篩選元素

### 步驟 4：依分類上色
`override_element_graphics` 對每組元素套用對應顏色

### 步驟 5：恢復接合
`rejoin_wall_joins` 恢復牆體幾何接合

---

## 規範類型 → 染色策略對應（2026-05-22 補，L-027）

當染色目的是「視覺化合規 FAIL」時，**染色策略不能跨規範類型通用**，必須先判斷規範類型：

| 規範類型 | 範例 | 染色策略 |
|---------|------|----------|
| **(A) Wall-anchored** | §45/§110 外牆開口距地界線 | **直接染 violation 牆段**——從 `check_exterior_wall_openings` 回的 violatingOpenings 拆出唯一 wallId，依 status 染色（Fail 紅 / Warning 黃） |
| **(B) Room-anchored** | §41 採光、§101/§188 排煙、停車淨高 | **不能直接染 Room（L6 silent no-op）**，需 proxy：染 FAIL 房的 hosting walls（從 `get_room_daylight_info` 拿房間 Openings 的 HostWallId 集合） |

**判斷流程**：染色前先讀對應 domain 檔（fire-rating-check.md / daylight-area-check.md / smoke-exhaust-review.md 等）→ 看規範是「對牆下限制」還是「對房間下限制」→ 走對應策略。

詳見 `domain/tool-capability-boundary.md` L8、`domain/lessons.md` L-027。