datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

DDC 技能集合：面向 AI 編碼助手

是什麼 – 精選的 238 個「技能」（每個為一個包含問題描述、程式碼範本與所需工具的 SKILL.md 檔案），讓 AI 編碼助手（Claude Code、Cursor、Copilot 等）能為常見的建築公司工作流程（成本資料庫搜尋、BIM/IFC 轉 Excel、報告生成、AI 驅動分析）產生即用型指令碼。

為何重要 – 建築公司擁有大量資料（Excel 概算、BIM/IFC 模型、PDF、現場照片），但通常處於孤島狀態且需手動處理。這些技能將這些資料轉化為自動化管道、儀表板與 AI 驅動分析，而無需使用者自行撰寫範本程式碼。

主要類別

類別	典型內容	何時開始
1_DDC_Toolkit	生產就緒工具：CWICR 成本資料庫、CAD 轉 Excel 轉換器、KPI 儀表板	需要立即可用的工具
2_DDC_Book	與免費《資料驅動的建築》一書章節對應的技能（資料成熟度、估算、機器學習）	希望有結構化學習路徑
3_DDC_Insights	n8n 工作流程範本、AI 代理編排、現場報告機器人	尋求快速工作流程自動化
4_DDC_Curated	文件生成（PDF/Excel/DOCX/PPTX）與品質檢查指令碼	需要報告或文件範本
5_DDC_Innovative	電腦視覺缺陷檢測、數位雙生、ESG 與歐盟 AI 法案檢查、生成式設計	準備嘗試 AI/ML
6_OpenConstructionERP	可接入開源 OpenConstructionERP 平台的指令碼（成本基準、BOQ、4D/5D 排程、投標）	基於現有 ERP 建構

典型工作流程

1. 審計 – 執行 data-silo-detection 列出所有資料來源。
2. 分類 – 使用 data-type-classifier 標記結構化、半結構化或非結構化資料。
3. 連接 – 部署 etl-pipeline 或 CAD 轉換器（ifc-to-excel、rvt-to-excel）。
4. 自動化 – 使用 n8n-daily-report 或 KPI 儀表板設定定期報告。
5. 分析 – 應用 ML 技能如 cost-prediction 或 schedule-forecaster。

如何使用一個技能

# 克隆倉儲
git clone https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction.git

# 在 AI 助手開啟技能資料夾（例如 Claude Code）
cd DDC_Skills_for_AI_Agents_in_Construction/1_DDC_Toolkit/CWICR-Database/semantic-search-cwicr/

# 助手讀取 SKILL.md，產生程式碼，你審查/調整後執行它。

README 中提供最小範例（etl-pipeline），展示一個基於 pandas 的簡單提取-轉換-載入指令碼。

先決條件

• Python 3.9+（大多數技能為 Python 指令碼）
• 可讀取 SKILL.md 並輸出程式碼的 AI 編碼助手
• 基本 Python 知識與對自有資料檔案的存取權限
• 可選：Docker（用於 n8n 工作流程）、PostgreSQL/SQLite 資料庫、LLM 基礎技能所需的 OpenAI API 金鑰

常見相依性安裝

pip install pandas openpyxl ifcopenshell pdfplumber

適合查看此專案的人

• 建築公司高階主管 / 運營經理 – GETTING_STARTED.md 提供非技術性概述與優先順序問題清單。
• 開發者 / IT 領導 – 可選擇任意技能，讓 AI 產生程式碼，再整合至現有系統。
• 研究人員 – 「Innovative」資料夾包含實驗性 AI/ML 管道（缺陷檢測、數位雙生），可進一步擴展。

文件與支援

• GETTING_STARTED.md – 高階入門指南
• OPTIMIZER_GUIDE.md – 充分發揮 AI 助手的技巧
• IMPROVEMENT_ROADMAP.md – 貢獻者如何新增技能
• 免費多語言書籍《資料驅動的建築》（31 種語言）解釋每個技能背後的原理。

授權 – 工具與技能採用 MIT 授權；CWICR 資料庫採用 CC BY-NC 4.0（非商業用途），另有獨立商業授權。

---

總結 – 此倉儲是一個實用工具箱，連接 AI 編碼助手與建築業複雜、資料密集的現實世界，讓公司能以最少的手動編碼實現估算、報告、BIM 資料萃取，甚至高階 AI 分析的自動化。