菜单
data/audio_interfaces.xlsx の製品スペックを公式製品ページと自動照合する tools/verify パイプラインの運用スキル。「スペック照合」「製品データを検証」「照合を再開/続き」「未照合の再試行」「照合レポート生成」「xlsx 更新後の再照合」「カタログの正確性チェック」など、製品データの検証・照合状態の確認・中断からの復旧・レポート生成に関する依頼では必ずこのスキルを使う。照合という言葉がなくても「データが公式と合っているか確認して」の類いはこのスキルの対象。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/semnil/audio-interface-compare-site --skill verify-products命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | verify-products |
| description | data/audio_interfaces.xlsx の製品スペックを公式製品ページと自動照合する tools/verify パイプラインの運用スキル。「スペック照合」「製品データを検証」「照合を再開/続き」「未照合の再試行」「照合レポート生成」「xlsx 更新後の再照合」「カタログの正確性チェック」など、製品データの検証・照合状態の確認・中断からの復旧・レポート生成に関する依頼では必ずこのスキルを使う。照合という言葉がなくても「データが公式と合っているか確認して」の類いはこのスキルの対象。 |
tools/verify/ パイプラインで xlsx 全機種を公式製品ページと照合する。設計の詳細と結果スキーマは tools/verify/README.md を先に読むこと。以下は運用判断の要点。
node tools/verify/validate-results.js # 健全性検証 + 未完了 ids 算出
work/state.json の nextIds が再実行対象 (未照合 + 検証で無効化されたもの)。missingIds が空になれば照合完了で、failed (ボット保護等) が残るのは正常--retry-failed / --include-partial を付ける (対象の旧結果は results-retired/ へ退避され nextIds に載る)work/ が無い・空なら初回: node tools/verify/export-products.js から始めるWorkflow ツールで起動する (node では実行しない):
Workflow({
scriptPath: "<リポジトリ絶対パス>/tools/verify/workflow.js",
args: { workDir: "<リポジトリ絶対パス>/tools/verify/work", ids: <state.json の nextIds>,
concurrency: 8, model: "sonnet", effort: "high" }
})
work/results/product-NNN.json (エージェントが書き込むチェックポイント)。ワークフローの戻り値は進捗の要約にすぎないconcurrency (既定 1 = 直列) / model / effort (既定セッション継承) は任意。並列時の中断・上限・下位モデルのリスク特性は README「中断耐性の設計」が正本全項目スキャン (第 1 段) の validate が完了して mismatch が残ったら、そのまま操作者に見せず精査を挟んで偽陽性を排除する (実測: 高確度 28 件中 13 件が偽陽性、精査コストはスキャンの 5% 程度):
node tools/verify/export-contested.js # 争点抽出。既知 hold/単位差は自動除外、価格は隔離
Workflow({
scriptPath: "<リポジトリ絶対パス>/tools/verify/recheck-workflow.js",
args: { workDir: "<リポジトリ絶対パス>/tools/verify/work",
ids: <work/contested-index.json の配列>,
concurrency: 2, model: "<第 1 段と別モデル>", effort: "high" }
})
work/rechecks/product-NNN.json のチェックポイント。中断したら contested-index.json から rechecks/ に無い ids を差し引いて再起動するnode tools/verify/partition-rechecks.js # verdict 仕分け + 質問下書きを出力
xlsx_correct は自動 hold — 質問しない (偽陽性として決着)page_correct / judgement_required のみ AskUserQuestion で操作者に確認する。機種単位でグルーピングし最大 4 問/バッチ、各質問に原文引用 + 修正候補を含め、選択肢は「修正適用 / 変更なし」を基本にする (このセッション実績のフロー)ROUND<N> → corrections-round<N>.json) に記録する。idx は行削除でシフトするため、ラウンドごとに「何行時点の rows-full.json 基準か」をコメントに残すKNOWN_HOLDS に (brand, model, column) で追加する。export-contested と build-report が次サイクルから自動除外するnode tools/verify/lint-columns.js で列間矛盾をエージェントなしで検出できるaborted: true (連続失敗の打切り) や利用制限エラーで終わったら、制限解除後に「validate → nextIds で再起動」するだけ。それ以外の復旧操作は不要results-invalid/ に退避され nextIds に入るので、個別の手当ては不要failed が残るのはボット保護によるもので正常。再挑戦は --include-partial や nextIds への手動追加で行い、それでも取れないサイトは failed のままレポートに「未照合」と明示する手順は README 末尾の記載どおり (work/results/ を work/results-archive-<日付>/ へ退避してから export に入る)。旧結果の削除はしない (退避のみ)。
node tools/verify/build-report.js # → リポジトリ直下 product-page-verification-report.md
work/removals.json) の機種名は保存時の brand/model で表示し、現行行との照合も名前で行う。行削除後の再生成では該当エントリが「削除済み (適用済み)」セクションへ移る (保存 idx は行削除・追加で並びがずれるため表示にも除外にも使わない — 2026-07 に旧 idx 参照で削除予定表の全機種名がずれて表示される事故が起きた)work/corrections-edited.json から差し込まれる (無い項目は「—」) ため、高確度の相違が出たら先に下記の修正候補作成を済ませてからレポートを生成するwork/review-state.json ({ highReviewedUntilIdx, lowReviewedUntilIdx, missingReviewedUntilIdx }) に保存する。レポートは到達済み範囲の相違行を確認済みとして省き、未確認分だけを表示する (認知負荷の削減)work/missing-pending.json に保留として出力する。レポートは保留分のみ表に描画し、操作者判断を待つmissing: true + unreviewed でレポートの「空欄追記の候補 — 未確認」に表示され、review-state.json の missingReviewedUntilIdx の更新で確定するwork/corrections-gen.py に蓄積する。corrections-edited.json はこのスクリプトの生成物で、手で直接編集しないpython3 tools/verify/work/corrections-gen.py # corrections-edited.json ほかを再生成
node tools/verify/build-report.js # レポート再生成 (未確認分のみ表示)
node tools/verify/apply-corrections.js tools/verify/work/corrections-edited.json # dry-run で整合検証
REMOVALS に理由と出典を記録するproposed: "")x to y (例 -18 to +70)。レンジ未公表 (幅のみ公称) は単一値。下限 −∞ はマニュアル記載どおり −∞ to +58 の例外表記-XXX.XdB (0.XXXXX%) の併記 (片方のみ公称なら換算して補い note に明示)/ 区切り (例 Android/iOS/macOS/Windows)相違が数百件規模の初回サイクルでは、第 2 段の代わりに propose-corrections + レポートの一括レビュー経路も使える (通常は上記の精査 → 質問解決を使う)。いずれの経路でも、照合で確定した誤りは xlsx に反映して初めて完了となる。ただし同意なしに xlsx を書き換えない:
node tools/verify/propose-corrections.js # mismatch (high) から修正案 work/corrections-proposal.json を生成
# proposal の proposed はページ記載の生テキスト。これを上記のセル書式規約に合わせた
# 「修正後セル値」に編集し、work/corrections-gen.py 経由で work/corrections-edited.json を生成する:
# [{ idx, brand, model, column, confidence?, current, proposed, note?, hold?, unreviewed?, missing? }]
# - proposed: 修正後セル値。"" は空欄化
# - note: レポート表示用の補足 (測定条件・丸め等)
# - hold: 反映を保留する理由 (例: 行重複で列修正では解消しない)。hold 付きは apply でスキップされる
# - unreviewed: 操作者の確認待ち。apply でスキップされ、review-state の境界更新で外れる
node tools/verify/apply-corrections.js tools/verify/work/corrections-edited.json # dry-run
# → 変更点 (機種/列/旧値→新値) を全件列挙して操作者に提示し、同意を得る
node tools/verify/apply-corrections.js tools/verify/work/corrections-edited.json --apply # 同意後のみ
node tools/verify/export-products.js # 変更行の旧照合結果が自動退避される → 該当行を再照合して整合確認
行の削除を伴う統合 (重複行の解消など) は、corrections の --apply → tools/apply-product-changes.js での行削除 → export の順で行う。削除を先にすると以降の行の idx がずれ、corrections の idx が無効になる。
新列 (RCA Input/Output 等) を使う corrections がある場合は、さらにその前に列追加 (node tools/add-rca-columns.js --apply) を実行する。列が無いと apply-corrections が「列が見つからない」で中断する。
work/corrections-gen.py