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.yaml 说明它是谁、能做什么、由什么触发
intent.md 告诉模型什么情况下应该调用它
runtime.py 真正执行计算或处理流程
回归算例 用一个你手算过的例子验证结果正确
id: seis mic-load
domain: load-boundary
name:
zh: 地震荷载 en: Seis mic Load
triggers: 地震荷载 / 抗震 / seis mic
capabilities: load-generation
inputSchema: seis micIntensity, siteClass, designGroup
上手路径
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。
当前最缺
这些领域是 StructureClaw 走向"能出成果"的关键缺口,也是你最能发挥工程经验的方向。把你日常做的计算用自然语言告诉 AI,让它帮你变成一个可复用的 Skill:
code-check · 规范检查
现有 4 个规范检查 Skill(GB50010/50011/50017/JGJ3),但覆盖面远远不够。梁挠度验算、裂缝宽度验算、柱轴压比校核、层间位移角检查——这些你在审图时天天遇到的东西,都还没做。每一条规范条文都可以变成一个 Skill。
result-postprocess · 设计后处理
分析结果出来之后怎么办?内力组合、包络图、最不利工况筛选、配筋估算、构件验算汇总——这些"算完之后怎么用"的环节,目前完全是空的。而这恰恰是你最有经验判断力的地方。
report-export · 计算书生成
从模型和结果自动生成结构计算书——荷载汇总表、内力图、配筋结果、验算结论。你写过多少份计算书?把那份经验沉淀下来,让 AI 帮你标准化输出。