---
name: Extract
slug: extract-2
category: Data
description: "Extract parses plain-text lines like key: number into a structured readings artifact with source-location trace. Use it when you need a simple, reusable first-step extractor for downstream processing."
github: "https://github.com/s0912758806p/agentic-sop-to-work/tree/main/plugins/agentic-sop-kit/kit/skills/extract"
language: Python
stars: 206
forks: 21
install: "npx degit https://github.com/s0912758806p/agentic-sop-to-work/tree/main/plugins/agentic-sop-kit/kit/skills/extract ~/.claude/skills/extract"
installs_to: ~/.claude/skills/extract
source_path: plugins/agentic-sop-kit/kit/skills/extract/SKILL.md
collection_size: 11
category_size: 762
collection_url: "https://dirskills.com/collections/s0912758806p/agentic-sop-to-work"
added: 2026-09-05T05:29:06.654Z
last_synced: 2026-09-05T05:29:06.654Z
canonical_url: "https://dirskills.com/skills/extract-2"
---

# Extract

Extract parses plain-text lines like key: number into a structured readings artifact with source-location trace. Use it when you need a simple, reusable first-step extractor for downstream processing.

**Install:**

```bash
npx degit https://github.com/s0912758806p/agentic-sop-to-work/tree/main/plugins/agentic-sop-kit/kit/skills/extract ~/.claude/skills/extract
```

## README

# 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` 即可運作。