StructureClaw周報：技能規范已就緒，期待您的智慧

StructureClaw Weekly · 2026-04-13

會算結構，
就能為 StructureClaw 貢獻一個 Skill。

StructureClaw 的技能規范已經落定。你不一定要熟悉 Python，也不一定要會搭程序框架。只要你熟悉規范、理解計算邏輯、會判斷結果對不對，你就已經具備了貢獻一個 Skill 最核心的能力。

基礎設施已就緒 · 技能規范已落定 · 社區貢獻正式開放

為什么現在適合加入

過去一段時間，我們優先做的不是堆功能，而是把底層規則立起來

坐標體系統一了

建模、分析、3D 可視化全部對齊到global-z-up。新貢獻的 Skill 不再需要處理坐標歧義，直接寫計算邏輯就行。

歷史包袱清掉了

4616 行死代碼、7 個廢棄模塊、Redis 本地依賴——全部移除。新人讀到的每一行代碼都是活的、在用的。

技能架構定好了

每個 Skill 以skill.yaml清單文件為唯一入口，運行時自動發現、加載和調度。貢獻者只需要填模板，不需要理解整個系統。

核心定位

你貢獻的不是代碼，而是結構工程知識

在 StructureClaw 里，一個 Skill 的核心不是炫技代碼，而是把結構工程里的確定性知識，整理成機器可調用、可驗證、可復用的流程。

比如項目里已經跑通的地震荷載 Skill，本質上不是"寫 400 行 Python"，而是明確：輸入是什么、按哪本規范算、中間有哪些關鍵參數、輸出應該長什么樣、怎樣用一個算例驗證它算對了。

這些事情，恰恰是結構工程師最擅長的。

為什么說結構工程師反而有優勢？

工程知識是核心資產，代碼只是載體。

一個荷載計算 Skill 的核心是"按 GB50011 底部剪力法算地震力"——算總重、算特征周期、算 α?、算底部剪力、倒三角形分配。這些你都會手算，只是換了一種表達方式。

驗證靠單元測試，也靠工程判斷。

AI 生成的代碼算得對不對，你拿手算結果一比就知道。七度設防、II 類場地，底部剪力應該是多少——你有直覺，AI 沒有。你是最好的評審者。

交付標準

一個 Skill 最少需要交付什么

貢獻 Skill 的本質，不是"寫一堆代碼"，而是"把你的工程方法整理成一個可執行模塊"。最小交付物就這幾樣：

skill.yaml說明它是誰、能做什么、由什么觸發

intent.md告訴模型什么情況下應該調用它

runtime.py真正執行計算或處理流程

回歸算例用一個你手算過的例子驗證結果正確

id: seismic-load

domain: load-boundary

name:

zh: 地震荷載 en: Seismic Load

triggers: 地震荷載 / 抗震 / seismic

capabilities: load-generation

inputSchema: seismicIntensity, siteClass, designGroup

一個真實可用的 Skill，不需要從"復雜系統"起步，而是可以從一個你非常熟悉、可驗證、可復用的工程計算出發。

上手路徑

第一次貢獻，從這四步開始

1. 說清楚你想做什么

打開 Claude Code 或 Cursor，把輸入、規范依據、計算流程、輸出形式講清楚。比如：

我想寫一個地震荷載 Skill。

按 GB50011-2010 底部剪力法，輸入設防烈度、場地類別、設計地震分組，算底部總剪力后，按倒三角形分布到各層節點。參考 dead-load。

2. 參考現有 Skill 生成骨架

AI 會參照dead-load、wind-load等已有 Skill 的結構，自動生成skill.yaml、intent.md和runtime.py。你要做的只是確認公式和參數取值是對的。

3. 用你熟悉的算例驗證

拿一個你手算過的例子去對結果。比如"5 層框架，七度設防、II 類場地、第二組，總重約 5000kN，底部剪力應該在 400kN 左右"——對不對得上，一眼就知道。不對就讓 AI 改，改到對為止。

4. 補文檔、跑測試、提 PR

AI 還能幫你跑測試命令、生成 commit、甚至寫 PR 描述。你只需要審一遍，確認沒問題就行。把它變成項目里別人也能復用的一個 Skill。

當前最缺

當前最優先征集的 3 類 Skill

這些領域是 StructureClaw 走向"能出成果"的關鍵缺口，也是你最能發揮工程經驗的方向。把你日常做的計算用自然語言告訴 AI，讓它幫你變成一個可復用的 Skill：

code-check · 規范檢查

現有 4 個規范檢查 Skill（GB50010/50011/50017/JGJ3），但覆蓋面遠遠不夠。梁撓度驗算、裂縫寬度驗算、柱軸壓比校核、層間位移角檢查——這些你在審圖時天天遇到的東西，都還沒做。每一條規范條文都可以變成一個 Skill。

result-postprocess · 設計后處理

分析結果出來之后怎么辦？內力組合、包絡圖、最不利工況篩選、配筋估算、構件驗算匯總——這些"算完之后怎么用"的環節，目前完全是空的。而這恰恰是你最有經驗判斷力的地方。

report-export · 計算書生成

從模型和結果自動生成結構計算書——荷載匯總表、內力圖、配筋結果、驗算結論。你寫過多少份計算書？把那份經驗沉淀下來，讓 AI 幫你標準化輸出。

全景

14 個技能域的現狀：哪些已跑通，哪些等你來認領

已跑通

structure-type · analysis · code-check

17

可擴展

validation · report-export · load-boundary · visualization · section

18

待認領

code-check 擴展 · result-postprocess · report-export

先把一個確定的小能力做對，再逐步擴展成一個技能域。這是更適合當前階段的路徑。

StructureClaw 現在最缺什么？

不是會搭框架的人，而是愿意把工程經驗沉淀下來的人。代碼可以交給 AI 輔助完成，但規范判斷、參數邊界、算例驗證，這些必須來自真正懂結構的人。

現在就參與

進群討論QQ交流群：776925110

查看貢獻指南CONTRIBUTING_CN.md · AGENTS.md

開始第一個 PRFork → 參考 seismic-load → 寫你的 Skill

如果你會算結構，
你就已經可以開始貢獻一個 Skill 了。

代碼讓 AI 來寫，公式你來定，算例你來驗。

最后補充一句，這個公眾號文案（包括排版），除了這句話，都是AI做的。

--- End ---

相關文章（結構龍蝦每周都有新進展）

(2026-03-18)

(2026-03-23)

(2026-03-30)

(2026-04-08)

---End---

建筑結構生成式智能設計軟件：

3分鐘視頻演示剪力墻結構智能設計完整操作流程

1分鐘視頻建筑戶型平面生成與編輯流程

相關研究

學術報告視頻

專著

人工智能與機器學習

---結構智能設計

---其他土木工程領域人工智能研究

城市災害模擬與韌性城市

高性能結構與防倒塌

26. 新論文：抗震&防連續倒塌：一種新型構造措施