首页/文章/ 详情

StructureClaw周报:技能规范已就绪,期待您的智慧

4月前浏览1183

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: seis mic-load

domain: load-boundary

name:

zh: 地震荷载  en: Seis mic Load

triggers: 地震荷载 / 抗震 / seis mic

capabilities: load-generation

inputSchema: seis micIntensity, siteClass, designGroup

一个真实可用的 Skill,不需要从"复杂系统"起步,而是可以从一个你非常熟悉、可验证、可复用的工程计算出发。            

上手路径

第一次贡献,从这四步开始

1. 说清楚你想做什么

打开 Claude Code 或 Cursor,把输入、规范依据、计算流程、输出形式讲清楚。比如:

我想写一个地震荷载 Skill。

按 GB50011-2010 底部剪力法,输入设防烈度、场地类别、设计地震分组,算底部总剪力后,按倒三角形分布到各层节点。参考 dead-load。

2. 参考现有 Skill 生成骨架

AI 会参照 dead-loadwind-load 等已有 Skill 的结构,自动生成 skill.yamlintent.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 帮你标准化输出。


来源:陆新征课题组
振动非线性化学建筑python消防BIM理论Opensees材料科普数字孪生控制试验
著作权归作者所有,欢迎分享,未经许可,不得转载
首次发布时间:2026-04-21
最近编辑:4月前
地震那些事
博士 抗震防灾数值模拟仿真
获赞 84粉丝 73文章 672课程 0
点赞
收藏
作者推荐

结构龙虾再进一步:统一多端入口,让协作真正跑起来

StructureClaw / Weekly Update / 2026-03-30多端入口统一技能体系骨架搭建第一个进步是使用入口的统一。Windows、Linux 的常用流程已经基本统一到 sclaw。第二个进步是技能体系的骨架搭建。现在不只大类收拢了,连面向结构设计流程的理解路径也开始清楚起来。这周的关键词:统一入口、蓝图更清楚、流程更顺、欢迎协作。What Changed如果把这周的变化说得更直白一点,就是 “更容易用” 和 “更容易一起做” 这两件事,终于开始同步推进了。先说最直接的一件事 多端入口已经基本统一到 sclaw现在 Windows 和 Linux 的常用启动、检查、日志、停止等流程,已经能围绕同一套命令面来理解,不再是“换个系统就像换了个项目”。这周同时补上了 Windows / Linux 的 Node 自动安装脚本,也把 Windows 的 Docker 路径收拢进统一命令面。对新同学来说,这比多一个功能点更有用,因为它直接决定了你能不能顺利把项目跑起来。如果你现在就想上手,可以直接这样跑入口统一之后,多端启动终于能讲得很简单了。下面这套流程,基本就是现在最推荐的新同学起步方式。第一步:先把 Node.js 装好如果你还没有安装 Node.js,可以直接用自动安装脚本:bash ./scripts/install-node-linux.shWindows PowerShell 首次安装建议用管理员权限:powershell -ExecutionPolicy Bypass -File ./scripts/install-node-windows.ps1第二步:推荐本地流程装好以后,通常按这三步就够了:./sclaw doctor./sclaw start./sclaw statusWindows PowerShell 下也有对应命令:node .\sclaw doctornode .\sclaw startnode .\sclaw statusnode .\sclaw logs all --follownode .\sclaw stop再说这周真正重要的另一个变化 这次不按仓库目录顺序讲,而是按更接近结构设计实际推进的顺序来讲。这样看这 14 类技能,会更容易理解它们各自是在流程里干什么的。01. data-input负责把 CAD、Revit、BIM、图像、PDF 等外部资料接进来,先把输入打通。02. structure-type负责识别结构类型、抽取关键参数,并决定后续模型怎么组织。03. section负责截面定义和选型,处理常规、桥梁和不规则截面这些问题。04. material负责材料强度等级、本构假设和参数归一化这些基础设定。05. load-boundary负责荷载、工况和边界条件,把结构受力场景描述清楚。06. an alysis负责把模型真正送进分析流程,完成计算和运行时支撑。07. result-postprocess负责整理和解释分析结果,把不同软件的结果转成可继续使用的信息。08. code-check负责按规范做校核,覆盖常见国标和具体条文对应的检查逻辑。09. validation负责做结构数据校验、兼容性检查和结果归一化,保证流程不跑偏。10. design负责给出设计建议、分析策略和默认参数决策,帮流程往前推进。11. drawing负责把结果往出图接口和绘图流程上接,服务后续工程表达。12. report-export负责把过程和结果整理成计算书、报告等可交付内容。13. visualization负责把模型和结果做成图形可视化,方便检查、展示和沟通。14. general负责 memory、planning、读写文件、shell 等通用能力,给全流程打底。Why It Matters这件事重要,不是因为目录看起来更整齐了,而是因为以后讨论需求、补技能、做评审、分任务、接贡献时,大家终于可以按同一条工程流程来对齐理解。各个技能大类负责人已经确定这意味着 StructureClaw 后续的技能建设,不再只是“谁有空谁补一点”,而是开始进入按大类持续维护、持续积累、持续接力的状态。项目往前走,靠的不是一次性冲刺,而是这种能长期工作的分工结构。如果你想参与,现在反而更容易切进来了入口统一了,说明你更容易把项目跑起来;技能顺序更清楚了,说明你也更容易知道自己该往哪一段流程补。无论你想补的是某个 skill、某份文档、某条测试链路、某个外部软件接口,还是单纯拿真实问题来提反馈,我们都欢迎。现在 StructureClaw,比前几周更适合协作了。来源:陆新征课题组

未登录
还没有评论
课程
培训
服务
行家
VIP会员 学习计划 福利任务
下载APP
联系我们
帮助与反馈