引用つきレビュー要約（良い点・悪い点をレビューIDで裏づけ）

Review summary with quotes: pros and cons backed by review IDs

手元のレビュー（CSV・JSON・テキスト）を、良い点・悪い点・テーマ別に要約します。すべての指摘にレビューIDつきの原文引用を付け、評価分布も出します。引用が本当に原文にあるかをスクリプトで検証します。

Claude Hermes Agent Codex CursorMIT（改変・再配布・商用利用可）Python

できること

お客様レビューを「それっぽい要約」ではなく、根拠つきでまとめます。存在しないレビューや引用は作りません。

CSV・TSV・JSON・JSONL・テキスト（空行区切り）を読み込み、ID・評価・本文・日付を自動で判別（IDがなければ R1, R2… を付与）
評価の分布と平均、肯定・中立・否定の件数
日本語と英語のキーワード表で、価格・品質・初期不良・サイズ・使いやすさ・音・配送・説明書・サポートなど14のテーマを集計し、各テーマのレビューIDと原文の一文を引用
書き上げた要約の「"引用" [ID]」がすべて元のレビューに実在するかを検証し、見つからない引用や存在しないIDがあればエラーで知らせる

使い方

python scripts/review_themes.py analyze reviews.csv --out themes.json --md themes.md
python scripts/review_themes.py verify summary.md --reviews reviews.csv

テーマのキーワードは references/themes.json をコピーして商品に合わせて増やし、--themes で指定できます。見本は examples/ にあります。

必要な環境

Python 3（標準ライブラリのみ）
Claude、Codex、Hermes Agent、Cursor などのエージェント

注意点

キーワードによる集計なので、言い換えや否定文（「うるさくない」など）は取りこぼしや誤判定があります。エージェントが引用を読んで判断します。
レビューの取得（スクレイピング）は行いません。利用規約の範囲で用意したデータを使ってください。
要約に投稿者の個人情報は含めません。公開する場合の引用ルールは各サイトの規約に従ってください。

English description

Summarize user-supplied reviews (CSV, JSON or text) into pros, cons and themes, every point backed by verbatim quotes with review IDs, plus a rating distribution and a quote checker.

What it does

Summarizes customer reviews with evidence instead of guesswork. It never invents reviews or quotes.

Reads CSV, TSV, JSON, JSONL or plain text (blank-line separated) and detects ID, rating, text and date columns (assigns R1, R2... when IDs are missing)
Rating distribution and mean, plus positive / mixed / negative counts
Counts 14 themes (price, quality, defects, size, ease of use, noise, delivery, instructions, support and more) with Japanese and English keyword lists, listing review IDs and verbatim sentence quotes per theme
Verifies that every "quote" [ID] in the finished summary really exists in the cited review and fails loudly on missing quotes or unknown IDs

How to use

python scripts/review_themes.py analyze reviews.csv --out themes.json --md themes.md
python scripts/review_themes.py verify summary.md --reviews reviews.csv

Copy references/themes.json, add product-specific keywords and pass it with --themes. Samples are in examples/.

Requirements

Python 3 (standard library only)
An agent such as Claude, Codex, Hermes Agent or Cursor

Caveats

Keyword counting misses paraphrases and can count negations ("not noisy"); the agent reads the quotes before concluding.
It does not scrape reviews; use data you are allowed to use.
Reviewer personal data is kept out of the summary. Follow each platform's rules when quoting publicly.

インストール方法

ダウンロードしたZIPを展開します（中に review-summary-with-quotes/ フォルダと SKILL.md があります）。
フォルダごと、使うエージェントのスキル置き場にコピーします。
- Claude：~/.claude/skills/（プロジェクト単位なら .claude/skills/）
- Hermes Agent：~/.hermes/skills/
- Codex：~/.agents/skills/／Cursor：~/.cursor/skills/
- Claude アプリ（claude.ai）：「カスタマイズ → スキル」からZIPをアップロード
エージェントを再起動し、スキル一覧に表示されることを確認します。

Windows・Mac 別、エージェント別のインストール手順