前言¶

土方算量是工程側的常規活，但口徑之爭一直存在。現場習慣用南方 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