| 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 明確報錯,非靜默失敗)
參數化(無硬編碼專案值)
- 輸入:
--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 即可運作。