林家維(@CWLin0518)
開發綠建材 Revit 導入工具鏈時推完的 23 張看板卡,全部 stage: done,
建立於 2026-07-30 ~ 2026-08-12。
Domain 索引回答「有哪些方法」,本頁回答「這些方法是怎麼被做出來的、當初驗在哪個 TypeId 上」。
每張卡連到它的 JSON 原始檔、它催生的 domain/skill/工具,以及當時留下的實測 ID。
tools/kanban/cards/ 底下的 23 個 JSON 檔,一張卡一個檔。
看板頁把它們渲染成欄位視圖。
這就是林家維在分享中說的「專案看板的方式,就是那個字卡」。
它跟一般專案管理的卡不同。ai/process/kanban.md 開宗明義:
「這個看板追蹤的是『這項任務對 AI agent 來說是否可以安全執行』,不只是單純的任務狀態。」
Trello/Jira 的卡問「這件事做到哪了」;這套卡問「這件事夠不夠清楚到可以交給 AI 去動我的 Revit 模型」。
每張卡有兩組布林閘門:
readiness(7 項,進場門檻):problem_clear、non_goals_clear、acceptance_testable、files_known、scope_defined、verification_contract、human_approval_recorded。不全為 true,不准交給 agent 動手。gates(6 項,出場門檻):product、ui、architecture、security、test、code_review。不全為 true,不算完成。dependsOn(硬相依):政策明定「列出的卡片全部是『完成』;只要有一張還沒完成,這張卡不能進入『Agent 執行中』」。推進流程有 12 個欄位,每欄都寫了離場條件:
完整規範見 ai/process/kanban.md,
它連 WIP 上限都定了(「若審查欄位滿了,就停止建立新的 AI 工作」)。
這 23 張卡全部是 stage: done,建立於 2026-07-30 ~ 2026-08-12。
它們記的是「那一天做了什麼、在哪個 TypeId 上驗過」,不會再更新。
而 domain 是活文件,會改版。兩者的關係是單向的:
卡片是 domain 的出生證明與證據,不是 domain 的內容來源。
方法的現況一律以 domain 為準——這是 CLAUDE.md 的既有規則(衝突時 domain 勝)。
所以真正要注意的不是「卡片改了 domain 沒跟上」(卡片不會再改),而是時間差: domain 已經前進、卡片停在原地。本頁把已知的情況以黃底標在該列上。
另一個時間差的例子不在任何卡片裡:domain/GM_parameter-schema.md 的
§6「標章效期與資料新鮮度」是 2026-08-31 才加上去的,23 張卡中沒有任何一張提到它。
延伸閱讀:Domain 索引(有哪些方法)· Skills 索引(怎麼編排)· 貢獻者 · 林家維當天的分享逐字稿 ↗
| 卡號 | 標題 | 風險 | 當時做出了什麼 | 實測留下的 ID |
|---|---|---|---|---|
| TASK-001 | 整理 TABC 1041 筆綠建材標章資料庫與 Schema 規範 | medium | GM_catalog.md |
— |
| TASK-002 | 優化 TABC 綠建材地端檢索與 Showcase 平台之 UI/UX 介面與操作體驗 | low | green-material-showcase.template.html |
— |
| TASK-013 | 檢索平台新增「加入既有 Set」、「另存/開啟專案檔」與可拖曳材料層級設定三項功能,並新增 /GMweb open 指令 | low | /GM_web、green-material-showcase.template.html |
— |
| 卡號 | 標題 | 風險 | 當時做出了什麼 | 實測留下的 ID |
|---|---|---|---|---|
| TASK-003 | 精準對映 Revit 元件類別 (Walls/Floors/Ceilings/Windows) 之綠建材共享參數規範 | medium | GM_parameter-schema.md |
— |
| TASK-004 | AI Agent 綠建材推送 Revit 需求對齊與互動式計畫擬訂機制 | medium | /GM_import、GM_generate_revit_injection_plan.py |
— |
| TASK-005.1 | 情境 1|牆體構造與塗料 Set 導入(OST_Walls)
load_shared_parameters、set_green_material_type_parameters、duplicate_element_type、get_all_materials |
high | GM_parameter-schema.md、/GM_inject |
— |
| TASK-005.2 | 情境 2|地磚與表面填充 Set 導入(OST_Floors)
load_shared_parameters、set_green_material_type_parameters、create_single_material_type、create_multi_layer_type、set_material_surface_pattern、get_element_info |
high | GM_parameter-schema.md、/GM_inject |
264193、339 |
| TASK-005.3 | 情境 3|系統家族雙階層參數寫入(Type+Material)
load_shared_parameters、set_green_material_type_parameters、get_all_materials、get_element_info |
high | GM_parameter-schema.md |
263551、264332 |
| TASK-005.4 | 情境 4|含接著劑/填縫劑的複合 Set 導入
load_shared_parameters、set_green_material_type_parameters、create_multi_layer_type、get_all_materials、get_element_info |
medium | GM_parameter-schema.md、/GM_inject |
264332、339 |
| TASK-005.5 | 情境 5|單選非模型綠建材互動式套用
duplicate_type_only、get_types_by_category、get_element_info |
high | /GM_inject、/GM_import |
339、264386 |
| TASK-005.6 | 情境 6|牆壁/地坪預設厚度推判與覆寫
create_multi_layer_type、get_element_info |
high | GM_generate_revit_injection_plan.py |
— |
| TASK-005.7 | 情境 7|門窗/獨立元件 RFA 綠建材導入
已被後續 domain 修訂超出:卡片停在 2026-08-12 的認知。
domain/GM_rfa-family-injection.md 已於 2026-08-31 升到 v1.1:當時記錄的「GreenMaterial_Certified 寫入失敗疑為 YesNo 型別限制」經追查並不成立,真因是 SharedParametersFilename 的生命週期 bug,修正後實測 0/12 → 12/12。原始觀察已在該 domain 保留為歷史紀錄。load_shared_parameters、get_element_info |
high | GM_rfa-family-injection.md、/GM_inject |
166496、168921 |
| TASK-005.8 | 情境 8|天花板系統 Set 導入(OST_Ceilings)
load_shared_parameters、set_green_material_type_parameters、create_single_material_type、create_multi_layer_type、get_all_materials、get_element_info |
medium | GM_parameter-schema.md、/GM_inject |
19847、264422、264424 |
| TASK-005.10 | 情境 10|單一元件多重綠建材 Multi-Material 導入
create_single_material_type、create_multi_layer_type、get_element_info |
high | /GM_inject |
— |
| TASK-005.11 | 情境 11|新建 Type 與覆蓋既有材質雙路徑
get_element_info |
high | /GM_inject |
339、264386、19848 |
| TASK-005.12 | 情境 12|Column/Beam 結構材質指派(柱/樑綠建材)
load_shared_parameters、set_green_material_type_parameters、duplicate_type_only、get_types_by_category、assign_existing_material、create_material、get_element_info |
medium | GM_parameter-schema.md、/GM_inject |
257746、270136、209368、270638、272397 |
| TASK-009 | [已併入 TASK-005.1] 修復綠建材 Set 導入 Revit 的 MCP 工具串接缺口,並將 /GMimport /import revit 正式 Slash Command 化
set_green_material_type_parameters、duplicate_element_type、get_all_materials |
medium | /GM_import、/GM_inject |
— |
| TASK-010 | [已併入 TASK-005.10] 新增「各別建立」情境(Scenario 2):create_single_material_type 工具與地板材料 Set 端到端實測
create_single_material_type、duplicate_element_type、get_element_info |
medium | /GM_inject |
— |
| TASK-011 | [已併入 TASK-005.10] 新增「情境三:通用多層構造」create_multi_layer_type 工具,並修正 Core Boundary/Shell Layer 判斷
create_multi_layer_type、duplicate_element_type、get_element_info |
medium | /GM_inject |
— |
| TASK-014 | 計畫引擎新增 layerComposition 覆寫解析與確定性 Mat 槽位分配規則,取代 AI 臨場判斷 | low | GM_parameter-schema.md、GM_generate_revit_injection_plan.py |
— |
| TASK-015 | 共享參數 schema 擴充為 v5(Mat1~Mat6 六槽位,64 欄位),全鏈更新並修正層順序與槽位順序混用的執行錯誤
get_element_info |
medium | GM_parameter-schema.md、GreenMaterial_SharedParams.txt |
— |
| 卡號 | 標題 | 風險 | 當時做出了什麼 | 實測留下的 ID |
|---|---|---|---|---|
| TASK-008 | 執行 Monstrare DOD 驗證合約與綠建材 Skill 端到端整合測試 | high | AGENTS.md、definition-of-done.md |
— |
卡號是 TASK-001~006、008~011、013~015,加 TASK-005.1~005.8 與 005.10~005.12。
TASK-005.9、TASK-007、TASK-012 在 main 與作者的 fork 兩邊都不存在;
另有三張卡標題自帶「[已併入 TASK-005.x]」。
這對應到他在分享中自述的「我其實到後面,我其實都自己會有點亂掉了」。 看板本身收編了,但「開發到中期卡片爆炸、如何收斂」目前沒有任何 domain 或 skill 回答它—— 這是這條工具鏈唯一尚未沉澱成方法的一題。