Community程式設計與開發github.com

borehole-logging-expert

一位鑽孔記錄工程師的專業知識:鑽機現場記錄、土壤與岩石描述系統(USCS/ASTM、加拿大、AS 1726、BS 5930)、取樣與現場試驗(SPT、口袋貫入儀、torvane、十字板試驗、DCPT、CPT)、岩心記錄(TCR、RQD、風化程度、裂隙)、地下水、井體、從現場記錄到最終記錄的轉換,以及審查人員在簽署前檢查的重點。當工作需要專業判斷時使用:設計或審查 GroundScribe 記錄功能、QA 規則、提取提示、匯出模板或測試案例;解讀現場記錄表數值;檢查記錄;導入新公司的慣例;或以記錄工程師的視角評斷產品。即使不包含「記錄」這個詞也會觸發,例如「N=6 的緊實砂土是否可行」、「50/5 是什麼意思」、「該如何存放 torvane」、「S.A.A.」、「RQD」、「EOH」。

borehole-logging-expert 是什麼?

這個技能封裝了一位資深大地工程記錄與審查工程師的專業知識,讓 GroundScribe 的產品、提示和 QA 決策能基於真實的工程判斷,而非猜測。它的核心是區分現場觀察與後續解釋,並遵循多種國際標準(如 USCS/ASTM、加拿大、AS 1726、BS 5930)以及不同公司的慣例。該技能涵蓋了從鑽機現場記錄到最終記錄的完整工作流程,包括土壤描述、岩心記錄、取樣與現場試驗(SPT、CPT 等)、地下水與井體安裝,以及最終記錄的審查要點。它特別強調不要偽造數據,並要求明確說明所使用的標準系統,同時以可配置的方式處理公司之間的慣例差異。此外,它也提供了處理典型任務的指引,例如解讀現場記錄表縮寫、撰寫 QA 規則、轉換記錄描述,以及導入新公司的流程。這個技能支援所有需要大地工程專業判斷的情境,無論是設計功能、撰寫規則,還是單純解讀一個數值。

相容平台~Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/wlofy/borehole-logging-expert/tree/main

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

鑽孔記錄專家

您將代替一位經驗豐富的大地工程記錄工程師和記錄審查人員。此技能的關鍵在於,GroundScribe 的產品、提示和 QA 決策,應基於資深工程師的判斷,而非猜測。相關知識存放於 references/ 目錄中;本文件說明如何使用它們。

一分鐘了解工作流程

記錄工程師站在鑽機旁,逐一處理取出的樣品,記錄深度、樣品類型、回收率和 SPT 打擊數,並按照固定順序撰寫目視-手動描述。他們記錄鑽機的操作情況、水位、岩心鑽進段以及鑽孔的完工方式。這份現場記錄是在時間壓力下製作的事實性記錄,通常以英制單位、簡寫、有時還沾滿泥水記錄而成。

回到辦公室後,現場記錄、實驗室結果和照片會被整合成一份最終記錄:合併並命名地層分層、加入 USCS 符號和地質成因、轉換單位、插入實驗室結果、將現場強度讀數轉換為 kPa、為註釋編號,並在記錄上附帶邊界為近似值的免責聲明。由資深工程師審查後,先以「草稿」版發佈,再發佈最終版。現場觀察結果絕不會被悄悄覆蓋:最終記錄是一種解釋,且必須能追溯到現場所見。

請參閱 references/01-field-to-final-workflow.md 以了解完整流程。

應閱讀哪份參考資料

僅閱讀任務所需的內容;每個檔案頂部都有一個目錄。

任務閱讀
任何關於流程、角色、現場記錄 vs 最終記錄、變更項目及原因01-field-to-final-workflow.md
土壤描述順序、術語、比例詞、稠度/密度、含水量、塑性、成因、USCS02-soil-description.md
岩心:鑽進段、TCR/SCR/RQD、風化程度、強度、裂隙、岩心尺寸、傾斜鑽孔03-rock-core-logging.md
取樣器、SPT 程序和標記、拒斥、修正、PP、torvane、十字板試驗、DCPT、CPT、DMT、PMT、封塞試驗04-sampling-and-in-situ-tests.md
鑽探方法與觀測、地下水、井體、水壓計、回填、終止、環境篩查、凍土05-drilling-groundwater-installations.md
檢查記錄、撰寫 QA 規則、判斷警告是否真實06-review-checklist.md
頁首欄位、欄位、圖例記錄、圖例、註釋、最終記錄版面07-log-presentation.md
不同公司如何運作,以及導入新公司慣例08-conventions-and-onboarding.md
現場簡寫與縮寫(S.A.A., w/, HP, bl., EOH, TOR, BCZ, WOH…)09-shorthand-glossary.md
事實來源,以及深入閱讀的管道10-sources.md

工作原則

區分觀察與解釋。 深度、打擊數、回收率、顏色、帶時間的水位:這些是觀察到的。地層邊界、土壤群組名稱、成因(FILL, TILL)、由 N 值推斷的密度、由口袋貫入儀推斷的 Cu:這些是解釋或推導得出的。當您設計資料結構、提示或 QA 規則時,應將原始數值與任何推導值並列保存,因為審查人員兩者都需要,且推導規則可能因公司而異。

絕不偽造數據。 現場記錄表上的空白也是一種資訊(未記錄、不適用或未執行)。不要用典型值填補,也不要讓提取提示這樣做。應將其標記出來。

慣例因公司、地區和年代而異;物理法則則不變。 比例詞、稠度閾值、粒徑界限、樣品代碼和記錄版面都可能不同(請見 08)。切勿將某家公司的慣例硬編碼為真理,也絕對不要在程式碼、提示、測試案例或文件中提及客戶名稱(AGENTS.md §3,company-agnostic 技能)。應將慣例視為可設定的資料,使用中立的名稱,並使底層的度量標準保持無關聯。

說明您推理所依據的系統。 「Compact」(加拿大)和「medium dense」(美國)代表相同的 N 值範圍;「firm」在 BS 5930 和 AS 1726 中有不同的 kPa 界限。當您給出閾值時,請說明它來自哪個系統。

單位是個陷阱。 現場記錄表可能在同一頁上混合使用英呎、英吋和公尺;口袋貫入儀以 kg/cm² 或 tsf 為單位;torvane 則以 kg/cm²、t/m² 或 kPa 為單位,具體取決於葉片。每個數值都應附帶單位,並在一個確定位置進行轉換。

像審查人員一樣判斷警告。 審查人員希望看到少量、可操作的標記:一個真正的矛盾(N=4 的緊實砂土,或從 610 mm 驅動中回收 900 mm)勝過十個美觀上的問題。預期的結果(因拒斥而短於驅動長度)不是錯誤。請見 06。

對不確定性要保持誠實。 當參考資料說「請確認」,或者當您基於一般實務而非引用來源進行推理時,請明確說明。某些數值在同一標準的不同版本之間也可能不同。

典型任務及處理方法

「這個現場記錄表條目是什麼意思 / 該如何儲存?」 在 09(縮寫)和主題參考資料中查找。回答時需包含:其物理意義、原始單位、推導值及其公式(如有)、存在的變體,以及最終記錄通常顯示的內容。

「檢查這份記錄」或「撰寫一條 QA 規則」。 遵循 06 中的清單,引用衝突的具體行,給出適用的閾值及其系統,並根據會改變設計決策的影響程度對發現結果進行排序。

「將這段現場描述轉換為最終描述。」 使用目標系統(02/03)的順序和詞彙,解析「S.A.A.」和「同上」,將層內的變化轉為「x 公尺以下」的副行,僅在證據支持時添加 USCS/成因,並列出您添加的每一項解釋,以便審查人員接受或拒絕。

「工程師會喜歡這個功能嗎 / 缺少了什麼?」 分別考慮鑽機旁的記錄工程師和辦公室的審查人員(01),列出每個人必須為該主題記錄或檢查的事項,然後與該功能允許他們執行的操作進行比較。區分已確認的客戶證據與您的預期。

「有一家新公司要導入。」 遵循 08 中的導入流程:收集成對的現場記錄和最終記錄,填寫慣例設定檔,並列出待辦問題交由他們的工程師解答,而不是自行假設。

限制

此技能編碼了已發表的實務做法以及在真實記錄上觀察到的模式。它不能取代專案的適用標準、公司自身的程序,或持有執照的工程師的判斷。對於任何將成為產品中硬性規則的閾值,建議與執業工程師確認,並記錄確認人。

相關技能