前言¶
土方算量是工程侧的常规活,但口径之争一直存在。现场习惯用南方 CASS 的方格网法:格面积乘四角平均高差,坐标列序东坐标在前,h 等于自然高减设计高,正为挖、负为填。人工算要逐个格网抄数、核对,一旦输入点位或设计面有调整,整轮重算成本高。这个项目解决的问题很明确:让通用 Agent 按 CASS 口径完成土方计算,本机跑完直接出台账和自检报告,不联网。
这是什么¶
「土方算量」是一个社区发布的通用 Skill(SKILL.md 格式),坐标 @user_b2e0f551/earthwork-calc-cn,分类为 professional,无需 API Key。当前版本 1.0.6。它把 CASS 方格网口径固化为计算规则,覆盖从原始数据到成果交付的全流程,全程本机计算。
核心功能¶
按官方简介,能力分四层。
口径层。 默认且强制采用 CASS 口径:主算法是 CASS 惯例式格面积乘四角平均高差;坐标列序东坐标在前;高差 h 等于自然高减设计高,正为挖、负为填。这是区别于其他土方工具的主要点——口径不可选,按 CASS 惯例执行。
算法层。 覆盖五种算法:场地平整、平场标高、土方平衡、基坑放坡、清淤换填,另有两期土方、断面法与外委成果复核。按工程阶段看,前期用场地平整/平场标高定设计面,中期用基坑放坡、清淤换填算单体工程量,后期用两期土方对前后两期数据,断面法用于线性工程,外委成果复核用于核对第三方提交的算量结果。
输入层。 支持四种输入:散点、DXF、角点表、断面表。散点对应实测高程点,DXF 对应设计面或轮廓,角点表对应方格网角点高程,断面表对应断面法数据。
输出层。 三样成果:零公式静态数值的 Excel 台账(数值直接写死,无公式依赖,改数据不会引发公式错链)、方格网成果图、13 项自检报告。自检报告用于交付前自查,覆盖数据完整性和计算一致性的常见检查项。
安装与启用¶
官方页面未给出独立的安装命令。已抓取资料中 source 字段为 community,requires_api_key 为 false,说明属于社区 Skill、调用不需要密钥。按 SkillHub 的通用方式,通过官方地址获取后在宿主 Agent(Cursor、Codex CLI、Claude Code 等支持 SKILL.md 的环境)中启用即可。各宿主的具体启用入口不同,以各自文档为准,此处不做臆测。
典型用法¶
资料没有提供可复现的示例数据,下面按官方简介描述的流程梳理一次典型使用。
1、准备输入。按项目阶段选算法,再准备对应输入。场地平整用角点表或散点;基坑放坡用散点加设计面(DXF 或角点表);断面法用断面表。输入里的坐标列序按 CASS 惯例,东坐标在前。
2、触发计算。在 Agent 对话中说明算法类型和输入文件,Agent 按 CASS 口径执行。本机完成计算,无网络请求。
3、核对成果。打开输出的 Excel 台账核对各格网的挖填量,查看方格网成果图确认格网划分与填挖区域分布,再逐项过 13 项自检报告。需要复核外委成果时,用外委成果复核算法把对方数据和本机结果对一遍。
适用场景与注意¶
适合两类场景:一是常规土方量计算,尤其是已按 CASS 惯例出成果、需要快速重算或复核的场景;二是 Agent 工作流中的算量环节,作为数据处理后的一个标准化步骤。
需要注意:
- 口径是强制的 CASS 口径,不接受其他口径参数。如果项目合同指定其他算法口径,成果口径需另行核对。
- 输入数据质量直接决定结果。散点密度、角点表的格网边长、DXF 设计面的高程定义方式,都需要在计算前确认,本 Skill 不做自动纠偏。
- 13 项自检报告是必要交付物,算完不看等于没有校验环节。
- 成果是静态数值 Excel,后续在 Excel 里改设计高不会触发重算,改动需回到 Skill 重新跑。
结语¶
这个 Skill 的价值在于口径固化:CASS 惯例的格网法、东坐标在前、正挖负填,全部写死在规则里,开发者不用再和 Agent 解释算量口径。五种算法加四种输入覆盖了常见土方场景,零公式台账加自检报告可以直接进交付流程。全程本机计算,适合对数据不出本机有要求的项目。
官方地址:https://api.skillhub.cn/user_b2e0f551/earthwork-calc-cn