KANBAN INDEX 23 張卡 / 4 個 Epic

看板卡 · 開發紀錄層
方法是怎麼被做出來的

林家維(@CWLin0518) 開發綠建材 Revit 導入工具鏈時推完的 23 張看板卡,全部 stage: done, 建立於 2026-07-30 ~ 2026-08-12。 Domain 索引回答「有哪些方法」,本頁回答「這些方法是怎麼被做出來的、當初驗在哪個 TypeId 上」。 每張卡連到它的 JSON 原始檔、它催生的 domain/skill/工具,以及當時留下的實測 ID。

SECTION 01 · WHAT

什麼是看板卡

tools/kanban/cards/ 底下的 23 個 JSON 檔,一張卡一個檔。 看板頁把它們渲染成欄位視圖。 這就是林家維在分享中說的「專案看板的方式,就是那個字卡」。

它跟一般專案管理的卡不同。ai/process/kanban.md 開宗明義: 「這個看板追蹤的是『這項任務對 AI agent 來說是否可以安全執行』,不只是單純的任務狀態。」 Trello/Jira 的卡問「這件事做到哪了」;這套卡問「這件事夠不夠清楚到可以交給 AI 去動我的 Revit 模型」。

每張卡有兩組布林閘門:

推進流程有 12 個欄位,每欄都寫了離場條件:

收件匣 → 待釐清 → 待產品核准 → 待 UI Mockup → 待架構規劃 → 待任務卡
    → AI 就緒 → Agent 執行中 → 待驗證 → 待審查 → 待人工驗收 → 完成

完整規範見 ai/process/kanban.md, 它連 WIP 上限都定了(「若審查欄位滿了,就停止建立新的 AI 工作」)。

SECTION 02 · 讀之前必看

卡片是歷史紀錄,不是現行方法

這 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 索引(怎麼編排)· 貢獻者 · 林家維當天的分享逐字稿 ↗

SECTION 03 · EPIC-1

Epic-1: TABC 綠建材資料庫與法規模組化(3 張)

卡號標題風險當時做出了什麼實測留下的 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 —
SECTION 04 · EPIC-2

Epic-2: Revit 綠建材參數與材料庫 Mapping(18 張)

卡號標題風險當時做出了什麼實測留下的 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 —
SECTION 05 · EPIC-3

Epic-3: 綠建材 Skill 開發與轉譯(1 張)

卡號標題風險當時做出了什麼實測留下的 ID
TASK-006 撰寫 green-material-query SKILL.md(查詢/檢視已注入的綠建材資訊)
load_shared_parameters、get_types_by_category、get_element_info
medium /GM_query 263551
SECTION 06 · EPIC-4

Epic-4: HJPLUS 知識庫 PR 與 Monstrare 驗證合約(1 張)

卡號標題風險當時做出了什麼實測留下的 ID
TASK-008 執行 Monstrare DOD 驗證合約與綠建材 Skill 端到端整合測試 high AGENTS.md、definition-of-done.md —
SECTION 07 · 缺口

編號缺口與併卡

卡號是 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 回答它—— 這是這條工具鏈唯一尚未沉澱成方法的一題。