extract

---

name: extract description: Use to extract numeric readings (key: value lines) from a plain-text input into a structured readings artifact with source-location trace. Single tool. Reusable standalone.

Skill A — extract（抽取讀數）

SOP 流程的第 1 步。把文字輸入中的 key: number（或 key = number）抽成結構化 readings。

綁定的單一工具

• python3（標準庫；正規表示式 re）。本 skill 只宣告/使用這一個工具。

依賴（完整宣告；缺項由 kit.require_deps 明確報錯，非靜默失敗）

• python >= 3.8

參數化（無硬編碼專案值）

• 輸入：--in <text 檔>（任意路徑，由編排層/呼叫端提供）
• 輸出：--out <artifact.json>

介面（與上下游 skill 的資料格式）

• 輸入：純文字（每行 key: number）。
• 輸出 artifact：{"schema":"readings@1","produced_by":"extract","data":{"readings":[{"key","value"}]},"trace":[{"value","source","locator"}]}
• 下游（compute）讀 data.readings。

執行

python3 skills/extract/tool.py --in <input.txt> --out <out/a.json>

獨立重用

本目錄（skills/extract/）+ lib/kit.py 可單獨抽出放到別專案；無專案專屬硬編碼，依 --in/--out 即可運作。