| name | proofreading-agent |
| description | 日本語記事の校閲エージェント。誤字脱字、文法、表現の一貫性、読みやすさをチェックし、修正提案をインライン注釈で出力する。 「校閲して」「文章をチェック」「誤字脱字を確認」「記事をレビュー」等のリクエストで発動。 |
| triggers | ["校閲して","文章をチェック","誤字脱字を確認","記事をレビュー","推敲して","校正して","proofreading-agent"] |
トリガーワード
「校閲して」「文章チェック」「誤字脱字」「推敲」「校正」
Proofreading Agent - 日本語記事校閲エージェント
日本語記事を体系的に校閲するエージェントです。コピーエディティングの「Seven Sweeps」手法にインスパイアされ、日本語コンテンツに最適化した Five Sweeps で記事を多角的にレビューします。
Five Sweeps（5段階校閲）
校閲は以下の5段階で実施します。各スイープは独立して実行でき、特定のカテゴリに集中したレビューも可能です。
1. 正確性チェック（Accuracy）
文字レベルの誤りを検出します。
- 誤字脱字: 漢字の変換ミス、タイプミス
- 送り仮名の誤り: 「行なう」→「行う」、「落し穴」→「落とし穴」
- 同音異義語の誤用: 「以外」と「意外」、「対象」と「対称」
- 固有名詞の表記ミス: 製品名、人名、組織名の正確性
2. 文法チェック（Grammar）
文法的な正しさを検証します。
- 主述のねじれ: 主語と述語の不一致
- 助詞の誤用: 「は」と「が」、「に」と「へ」の使い分け
- 敬語の統一: 尊敬語・謙譲語・丁寧語の混在
- 係り受けの誤り: 修飾語と被修飾語の関係
- 時制の不一致: 過去形と現在形の混在
3. 一貫性チェック（Consistency）
記事全体を通した表記の統一性を確認します。
- 表記揺れ: 「サーバー」と「サーバ」、「ユーザー」と「ユーザ」
- 語尾の統一: 「です・ます」調と「だ・である」調の混在
- 数字表記: 全角と半角の混在、「3つ」と「三つ」
- 記号の統一: 括弧の種類、句読点（、。と，．）
- 略語の統一: 初出でのフルスペル表記
4. 読みやすさチェック（Readability）
文章の読みやすさを評価します。
- 一文の長さ: 80文字を超える文の検出
- 難読漢字: 一般読者に難しい漢字の使用
- 冗長表現: 「することができる」→「できる」
- 二重否定: 「ないわけではない」→「ある」
- 受身形の多用: 能動態への書き換え提案
- カタカナ語の乱用: 日本語で十分伝わる箇所の指摘
5. 構成チェック（Structure）
記事全体の構成と論理展開を確認します。
- 段落の論理的つながり: 前後の段落間の接続
- 重複内容: 同じ情報の不要な繰り返し
- 情報の過不足: 説明不足の箇所、不要な情報
- 見出しの階層: 見出しレベルの適切さ
- 導入と結論の整合性: 冒頭の問題提起と結論の対応
Usage
python scripts/proofreading_agent.py --input article.md --output review.md
python scripts/proofreading_agent.py --input article.md --sweep accuracy
python scripts/proofreading_agent.py --input article.md --sweep grammar
python scripts/proofreading_agent.py --input article.md --sweep consistency
python scripts/proofreading_agent.py --input article.md --sweep readability
python scripts/proofreading_agent.py --input article.md --sweep structure
python scripts/proofreading_agent.py --input article.md --style style_profile.yaml
python scripts/proofreading_agent.py --input article.md --severity high
python scripts/proofreading_agent.py --test
Parameters
| Parameter | Required | Default | Description |
|---|
| --input | Yes* | - | 校閲対象のファイルパス（Markdown/テキスト）。--test 時は不要 |
| --output | No | output/review_{timestamp}.md | 校閲結果の出力先 |
| --sweep | No | all | 実行するスイープ: all, accuracy, grammar, consistency, readability, structure |
| --style | No | - | スタイルプロファイル（YAML）のパス |
| --severity | No | medium | 表示する最低重要度: low, medium, high |
| --test | No | false | テストモード（サンプルテキストで API 不要の動作確認） |
スタイルプロファイル（YAML）
記事の種類に応じたルールをカスタマイズできます。
name: "技術ブログ"
tone: "です・ます"
terminology:
preferred:
- { term: "サーバー", reject: ["サーバ"] }
- { term: "ユーザー", reject: ["ユーザ"] }
- { term: "インターフェース", reject: ["インタフェース", "インターフェイス"] }
domain_terms:
- "API"
- "SDK"
- "CI/CD"
rules:
max_sentence_length: 80
number_style: "半角"
punctuation: "、。"
Output Format
インライン注釈
原文中の該当箇所に直接注釈を挿入します。
これはサーバ[校閲: 「サーバ」→「サーバー」（理由: 表記揺れ。記事内で「サーバー」が主要表記）]で動作する
アプリケーションです。データを保存することができます[校閲: 「保存することができます」→「保存できます」（理由: 冗長表現）]。
サマリーレポート
校閲結果の末尾に統計情報を出力します。
---
## 校閲サマリー
### 検出件数
| カテゴリ | 件数 |
|---------|------|
| 正確性（誤字脱字） | 3 |
| 文法 | 2 |
| 一貫性（表記揺れ） | 5 |
| 読みやすさ | 4 |
| 構成 | 1 |
| **合計** | **15** |
### 読みやすさスコア: 72/100
- 平均文長: 42文字（適切）
- 難読漢字率: 3%（やや高い）
- 冗長表現: 4箇所
### 重要度別
| 重要度 | 件数 |
|--------|------|
| HIGH | 3 |
| MEDIUM | 8 |
| LOW | 4 |
### 最重要修正 Top 5
1. [HIGH] L12: 「以外」→「意外」（同音異義語の誤用）
2. [HIGH] L34: 主語と述語が一致していない
3. [HIGH] L56: 「サーバ」と「サーバー」の表記揺れ（計5箇所）
4. [MEDIUM] L23: 一文が120文字を超えている
5. [MEDIUM] L45: 「することができる」→「できる」
読みやすさスコア算出
読みやすさスコア（0-100）は以下の要素から算出します。
| 要素 | 配点 | 基準 |
|---|
| 平均文長 | 30点 | 40文字以下: 30点、60文字以下: 20点、80文字以下: 10点、それ以上: 0点 |
| 漢字含有率 | 20点 | 20-35%: 20点、35-45%: 15点、それ以外: 10点 |
| 冗長表現率 | 20点 | 0%: 20点、冗長表現の割合に応じて減点 |
| 段落の適切さ | 15点 | 1段落あたり3-5文: 15点、それ以外: 減点 |
| 接続詞の適切さ | 15点 | 段落間の接続が明確: 15点 |
Requirements
- API キー: GEMINI_API_KEY または GOOGLE_API_KEY（環境変数または .env）
- Python パッケージ: google-genai, pyyaml, python-dotenv
Related Skills
- document-processor: PDF/PPTX/Excel の統合処理
- pptx-analyzer: PowerPoint スライド構造解析
- screenshot-analyzer: スクリーンショットから情報抽出
