pylabrobot

pylabrobot 技能概覽

pylabrobot 能做什麼

pylabrobot 技能幫你用 Python 規劃並執行實驗室自動化，採用硬體無關的介面。當你需要一個統一的工作流程層來處理液體移液、讀板機、幫浦、加熱搖床、培養箱、離心機，以及類似設備，而不是為每家廠商各寫一套腳本時，這項技能就特別有用。

誰適合使用

如果你正在跨多台儀器建立或維護自動化實驗流程，或者想先模擬、驗證一個 protocol 再跑到真實硬體上，pylabrobot 技能會很適合你。對重視可重現性、deck/resource 管理，以及跨平台 Python 控制的團隊來說，它也是很強的選擇。

它的優勢在哪裡

pylabrobot 的主要優勢，是能在不同實驗室設備之間提供一致的控制。這讓它比起只針對單次提示詞、又牽涉狀態、deck 版面配置與多步驟執行的複雜流程更合適。如果你只需要一個簡單、只跑 Opentrons 的 protocol，直接用廠商原生方式通常會更簡單。

如何使用 pylabrobot 技能

安裝並先查看正確檔案

先用這個目錄的 pylabrobot install 流程安裝，接著第一個打開 scientific-skills/pylabrobot/SKILL.md。由於這個 repo 沒有額外的 references/、resources/ 或 scripts/ 資料夾，真正的主要依據就是 skill 文件本身，以及文件裡連結出去的 repo 參考內容。

先把目標轉成可用的 prompt

要把 pylabrobot usage 用好，最重要的是一開始就把實驗任務、硬體與限制講清楚。差的需求會像是「寫一個 protocol」。更好的寫法是：「為 Hamilton STAR 的 96 孔 plate 分裝建立一個 pylabrobot workflow，包含 tip 追蹤、deck map 假設，以及 dry-run 模擬路徑。」你的設備清單和流程階段越具體，模型就越不需要猜。

先讀 workflow，再開始寫 code

先從 overview、when to use、core capabilities 和 liquid handling 這幾段看起。這些內容會釐清你需要的是 resource setup、protocol simulation、device-specific integration，還是只要一個通用的 Python 骨架。如果你的任務涉及讀板或周邊設備，先看這些段落，再提出實作需求。

要求做決策，不只是吐出結果

最好的 pylabrobot guide 型 prompt，會要求那些會影響執行品質的決策：deck 版面假設、labware 定義、tip 處理方式、體積範圍，以及模擬檢查。比如：「假設使用 384 孔 destination plate、一次性 tips，並且 deck 版面已預先驗證；請標出哪些步驟應該先模擬。」這樣產出的內容，對 pylabrobot for Workflow Automation 會更可執行、更有行動性。

pylabrobot 技能常見問答

pylabrobot 只適用於單一機器品牌嗎？

不是。pylabrobot 的核心價值就是廠商無關的自動化。它是為了跨不同設備類型的流程，或需要在多台設備之間共用同一層 Python 控制而設計的。

它比一般 prompt 更好嗎？

在真正的實驗室自動化工作上，通常是的，因為 pylabrobot 技能提供了更清楚的資源、執行流程與模擬框架。一般 prompt 也能產生程式碼，但更容易漏掉實驗室特有的限制，或省略關鍵的設定細節。

什麼情況下不該用它？

如果你只需要一個很簡單、廠商專屬的 protocol，而且官方 SDK 已經足夠好用，就不必特地用 pylabrobot。對範圍很窄、只做 Opentrons 的工作來說，原生 protocol 的做法通常更快也更簡單。

它適合初學者嗎？

如果你能把 workflow 分成幾個階段，並且願意先定義硬體假設，那它對初學者是友善的。如果你還不清楚 deck 版面、labware 或設備限制，它就沒那麼友善，因為這些輸入對正確輸出很重要。

如何改善 pylabrobot 技能

先補齊實驗室細節

提升品質最大的關鍵，是先把 device model、labware 名稱、體積範圍、樣本數，以及這次是實跑還是模擬說清楚。比如說，「用 Hamilton STAR 將 20 µL 從 96 孔 source plate 轉移到 384 孔 assay plate」就比「做一個 transfer script」有用得多。

要求輸出時就考慮失敗情境

pylabrobot 常見的失誤包括：resource 假設太模糊、tip 策略錯誤，以及 plate 幾何定義不清楚。請模型明確指出它做了哪些假設、哪些內容必須手動設定，並把只適用於模擬的檢查和真正可上機的步驟分開。

先模擬，再走到執行

第一輪先拿來驗證版面與邏輯，之後再針對 dead volume、部分填充、洗液步驟，或多設備交接這類邊界情況微調。對 pylabrobot usage 來說，最好的流程通常是：先起草、再模擬、再檢查 resource mapping，最後才把流程加固到可實際操作的儀器上。

在不同需求之間沿用同一套結構

當你找到一個有效的 prompt 模式後，就固定順序：目標、儀器、labware、體積、狀態限制，最後是輸出格式。這種一致性，會讓 pylabrobot skill 更容易套用到相關的自動化任務，也能讓每次產出的程式碼更穩定。