Skip to main content Início Criadores ynitto sandbox spec-value-finder
spec-value-finder 元仕様書(Excel/Word/PowerPoint/PDF/Markdown/txt)から記入すべき値を探すスキル。人が用意した仕様書をファイル名の部分一致で特定し、マッピング情報をもとに値を探して出典・確信度付きで記入シートに落とし込む。「仕様書に書く値を探して」「元仕様書から値を落とし込んで」「設定値を仕様書から拾って」「記入シートを埋めて」などで発動。サーバ・GPU不要。
Ir para a instalação Skills Marketplace Descubra e explore skills de IA criadas pela comunidade.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Mostrar detalhes do prompt Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
npx skills add https://github.com/ynitto/sandbox --skill spec-value-finderO comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.
Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.
Baixar Zip Baixando... Ocupações relacionadas SOC
Baseado na classificação ocupacional SOC
Explorador de arquivos
11 arquivos name spec-value-finder description 元仕様書(Excel/Word/PowerPoint/PDF/Markdown/txt)から記入すべき値を探すスキル。人が用意した仕様書をファイル名の部分一致で特定し、マッピング情報をもとに値を探して出典・確信度付きで記入シートに落とし込む。「仕様書に書く値を探して」「元仕様書から値を落とし込んで」「設定値を仕様書から拾って」「記入シートを埋めて」などで発動。サーバ・GPU不要。 metadata {"version":"1.2.0","tier":"experimental","category":"documentation","tags":["excel","word","powerpoint","pdf","specification","document-extraction","value-lookup","portable"]}
spec-value-finder
人が用意した元仕様書（Excel / Word / PowerPoint / PDF / Markdown / txt）から「記入すべき値」を探し、出典・確信度・要確認フラグ付きで記入シートに落とし込むスキル。
設計思想 : Neo4j も Table Transformer も使わない。依存は pip 一発で入る純Python系ライブラリ（openpyxl / python-docx / python-pptx / pypdfium2 / PyYAML、数MB）だけで、サーバ起動も GPU も不要。どの環境でも init 一発で動く可搬性を最優先する。
役割分担
担当 内容 スクリプト （決定的な機械作業）ファイル特定・構造化抽出・キーワード前段フィルタ・新規ファイル生成 Claude （意味的判断）候補からどれが正しい値かの確定・確信度の付与・要確認の判定 人 （承認）マッピング情報の作成/承認・最終成果物の検証
GraphRAG の自動マッチングは、人が渡すマッピング情報 （keywords による表記揺れの明示）と Claude の意味判定 に置き換えている。
モード一覧
モード 目的 init依存ライブラリのインストール（初回のみ） extractフォルダを部分一致で走査 → 元仕様書を構造化Markdown化
map-draft自然文の対応記述ファイル → マッピングファイルのドラフト生成
findマッピング × 抽出結果 → 項目ごとの候補を抽出
fill記入シート例 + 確定値 → 値を埋めた新規ファイルを生成
compare手動転記結果 + 確定値 → 突き合わせて一致/不一致を判定
scripts/
├── run.py # エントリポイント（__file__ 基準でパス解決）
├── models.py # データ構造（Cell.path = breadcrumb）
├── extract.py # Excel/Word/PowerPoint/PDF/Markdown/txt → 構造化抽出
├── mapping.py # マッピングファイルのスキーマ・検証・ドラフト
├── finder.py # キーワード前段フィルタ → 候補抽出
├── filler.py # テンプレート + findings → 新規ファイル生成
├── comparer.py # 手動転記結果 × findings の突き合わせ判定
└── requirements.txt
run.py は __file__ 基準でパスを解決するため、スキルがどこに配置されていても動く。
コマンド例は python を使用する（環境により python3）。
標準ワークフロー [init] ─→ [map-draft] ─→ 人がマッピング承認 ─→ [validate]
│
[extract] ←───────────┤
▼
[find] ─→ Claude が候補を吟味
│
findings.json 作成
▼
┌─────────────────────────┴───────────────────┐
▼ 生成したいとき 検証したいとき ▼
[fill] ─→ 人が成果物を検証 [compare] ─→ Claude が判定を吟味 ─→ 人が確認
fill は記入シートを新規生成する。compare は人が既に手で転記した記入シート を findings.json と突き合わせて転記の正しさを判定する。用途に応じてどちらか（または両方）を使う。
Step 0 — init（初回のみ） python scripts/run.py init
Step 1 — マッピング情報を用意する マッピングファイル（mapping.yaml）は「記入先の項目」と「元仕様書での探し方」を結びつける辞書。keywords が表記揺れ対策の要になる。
version: 1
source:
folder: ./specs
name_match: "HW仕様"
items:
- target: "MTU上限"
keywords: ["MTU" , "Maximum Transmission Unit" , "最大転送単位" ]
section_hint: "ネットワーク"
unit: "bytes"
type: number
note: "レイヤ2 のフレーム長"
別ファイル（Excel等）に自然文で対応記述がある場合は map-draft でドラフトを起こす:
python scripts/run.py map-draft ./対応表.xlsx --out mapping.yaml
map-draft はスカフォールドと「元記述」を出力する。Claude は元記述を読んで items を埋め、人がレビューする。確定後に検証する:
python scripts/run.py validate mapping.yaml
Step 2 — 元仕様書を確認する（任意） 全文を読みたいときは extract で Markdown 化する。
python scripts/run.py extract ./specs --name-match HW仕様 --out ./.svf-cache
--out を付けると各ファイルの .md / .json を出力。省略時は単一ファイルなら標準出力に Markdown を表示する。
Step 3 — find（候補を抽出する） python scripts/run.py find --mapping mapping.yaml --out candidates.json
各項目について、keywords に一致したセル/段落を 値・出典・breadcrumb・行文脈 付きで列挙する。source はマッピングから読むが --folder / --name-match で上書きできる。
Step 4 — Claude が候補を吟味して findings.json を作る（中核） ここがスキルの中核。find の出力 candidates.json を Claude が読み、項目ごとに値を確定する。 candidates[0] を機械的に採用してはならない。
path（breadcrumb）と section_hint が意味的に整合しているかセル一致のとき、欲しい値は一致セルそのものか、row_values の隣接セルか
unit / type がマッピングの期待と一致しているかmatched_keywords / score はあくまでヒント。最終判断は意味で行う 確信度 目安 highbreadcrumb・単位・型がすべて整合し、候補が一意 medium値は見つかるが breadcrumb か単位の確認が必要 low候補が複数競合 / 単位・型が不一致 / 候補なし
{
"items" : [
{
"target" : "MTU上限" ,
"value" : "1500" ,
"source" : "HW仕様書_v2.xlsx :: シート'Network' :: C2" ,
"confidence" : "high" ,
"needs_review" : false ,
"comment" : ""
}
]
}
confidence が high 以外、または単位・型の不一致がある項目は needs_review: true にする。候補が見つからない項目も value: "" / needs_review: true で必ず含める（人が気づけるように）。
Step 5 — fill（新規ファイルを生成する） 記入シート例（テンプレート）を複製し、確定値を埋めた新規ファイルを出力する。
python scripts/run.py fill --template 記入例.xlsx --findings findings.json --out 結果.xlsx
Excel テンプレート : 「項目」列の項目名と target を突合して各行に記入する。期待する見出し: 項目 / 値 / 出典 / 確信度 / 要確認（見出し名は --col-item などで変更可）。テンプレートに無い項目は末尾に追記される。
Word テンプレート : 本文・表中の {{項目名}} プレースホルダを値で置換する。
生成後、人が 出典 と 要確認 列を見て検証する。
Step 6 — compare（手動転記の正しさを判定する） fill の代わりに、人が既に手で転記済みの記入シート を findings.json と突き合わせて検証する。
python scripts/run.py compare --manual 手動転記.xlsx --findings findings.json \
--mapping mapping.yaml --out comparison.json
--manual には項目→値の表を含むファイルを渡す（Excel/Word/PowerPoint/Markdown の表に対応。項目 / 値 列の見出しは --col-item / --col-value で変更可）。--mapping は任意で、項目の並び順の参照に使う。
スクリプトは機械的判定（数値・正規化文字列の一致）まで行い、項目ごとに verdict を出す:
verdict 意味 match一致（数値のみ一致で表記が違う場合は needs_review が立つ） mismatch手動値とスキル値が不一致 missing_manual手動転記が空（転記漏れの疑い） missing_skillスキルが値を検出できなかった both_empty双方とも空
compare のあと、Claude は needs_review: true の項目を吟味する :
mismatch — 単なる誤りか、セマンティック等価（例: 手動「有効」/ スキル「Enabled」）かを判定するmissing_skill — マッピングの keywords が不足していないか、手動値の出典が妥当かを確認するmissing_manual — 転記漏れか、対象外の項目かを判定する そのうえで「転記が正しい項目／要修正の項目／人の最終裁定が必要な項目」に整理して人へ提示する。数値・単位の最終確認や専門的判断は人が行う。
マッピングファイル スキーマ フィールド 必須 説明 version推奨 スキーマバージョン（1） source.folder推奨 元仕様書フォルダ（再帰走査） source.name_match任意 ファイル名の部分一致パターン items[].target必須 記入先の項目名 items[].keywords必須 元仕様書での表記揺れを列挙（1個以上） items[].section_hint任意 章/シートのヒント。score にボーナス加点される items[].unit / type / note任意 Claude の確信度判断に使う
対応フォーマット（元仕様書） 種別 拡張子 抽出方式 Excel .xlsx .xlsmopenpyxl。結合セルを展開し表構造の breadcrumb を保持 Word .docxpython-docx。見出し階層 ＋ 表 ＋ 本文段落 PowerPoint .pptxpython-pptx。スライドタイトル ＋ 図形テキスト ＋ 表 PDF .pdfpypdfium2。透明テキスト層をページ単位で抽出（表構造解析はしない） Markdown .md .markdown見出し階層 ＋ パイプ表 ＋ 段落 テキスト .txt空行区切りの段落
PDF はテキスト層からの抽出のみ。スキャン画像だけで本文テキスト層を持たない PDF は抽出が空になる （OCR は行わない）。
旧形式（.xls / .doc / .ppt）は非対応。新形式に変換して使う。
記入シート例（fill のテンプレート）は Excel / Word に対応する。
エラー対処 現象 対処 No module named openpyxl / pypdfium2 等init を実行find で候補0件マッピングの keywords に表記揺れを追加。extract で実テキストを確認 PDF を extract しても段落0件 テキスト層が無い（スキャンPDF等）。本文テキスト層付きPDFか別形式に変換する 候補は出るが値がずれる row_values の隣接セルが正解。Claude が行文脈から値を選ぶfill で「項目列見出しが見つかりません」テンプレートの見出し名を --col-item 等で指定 compare で「項目表が見つかりません」手動転記ファイルに 項目 列を含む表が必要。見出し名を --col-item で指定 compare で全件 missing_skillfindings.json の target と手動転記の項目名が不一致。名称を揃える マッピング検証 NG validate のエラーメッセージに従い target / keywords を修正
