mcpField
W
writing-revision

writing-revision

github.com/lyndonklクリエイティブ・メディア18786 回インストール9 週間前に更新
リポジトリ

writing-revision について

草稿を体系的に推敲したい人向けのライティング改稿スキルです。冗長さの削減、認知負荷の軽減、文章のリズム改善を別々の工程で行います。

主な機能

  1. 013段階の改稿ワークフロー
  2. 02冗長表現と語数の削減
  3. 03認知負荷の確認
  4. 04文のリズム改善
  5. 05各工程の分析ファイル作成

活用シーン

  1. 01意味を保ちながら草稿を推敲
  2. 02草稿を10～25％短縮
  3. 03読み返しが必要な文の特定
  4. 04文章の流れと文の多様性の改善

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lyndonkl/claude --skill writing-revision

インストール後、Claude Code で/writing-revisionを入力して読み込まれたか確認します。

同梱ファイルresources/evaluators/rubric_revision.jsonresources/revision-guide.md

詳細

文章の推敲（3パス方式）

目次

関連スキル： 構成を計画するには writing-structure-planner、記憶に残るメッセージを作るには writing-stickiness、公開前の最終確認には writing-pre-publish-checklist を使用します。

基本原則

  1. 各パスで焦点を1つに絞る：一度にすべてを直そうとせず、各パスで1つの側面に取り組みます
  2. 10～25％削る：キングの公式――第2稿は第1稿から10～25％削ったものです
  3. すべての単語に役割を持たせる：役に立たない単語は削除します
  4. 初読が正しい読み方になるようにする：読者が文を読み返す必要があってはいけません（Pinker）
  5. リズムが読者を引き込む：文の長さに変化をつけ、力強く締めくくることで、読み進めてもらえます

ワークフロー

このチェックリストをコピーして、進捗を記録します。

Three-Pass Revision:
- [ ] Pass 1: Cut clutter (analyze -> improve)
- [ ] Pass 2: Reduce cognitive load (analyze -> improve)
- [ ] Pass 3: Improve rhythm (analyze -> improve)

始める前に： resources/revision-guide.md を確認し、3パス方式の全体像、例、変換の全手順を確認してください。

各パスでは、まず草稿全体を分析し、分析結果を現在のディレクトリ内の分析ファイルに出力してから、そのファイルを読んで改善します。これにより、抜け漏れなく確認できます。

パス1：冗長さを削る（Zinsser/King）

目標： 単語数を10～25％削ります。すべての単語に役割を持たせます。

ステップ1.1 - 分析：草稿全体を読みます。writer-pass1-clutter-analysis.md という分析ファイルを作成し、副詞（-lyで終わる単語）、修飾語（very、really、quite、somewhat）、受動態、弱い動詞（is、are、was、were、has/have/had）、前置き表現、陳腐な表現をすべて特定します。単語数を計算し、10～25％削減する目標を設定します。

ステップ1.2 - 改善：分析ファイルを読みます。草稿全体を見直し、改善します。副詞を70％削除し、修飾語を取り除き、受動態を能動態に変え、弱い動詞を動作を表す動詞に置き換え、前置き表現をなくし、陳腐な表現を削除します。単語数が10～25％削減の目標を満たしていることを確認します。残った単語すべてに役割があることを確かめます。

詳しい例については、resources/revision-guide.md - Pass 1 を参照してください。

パス2：認知負荷を減らす（Pinker）

目標： 読みやすく、すらすら読める文章にします。初読が正しい読み方になるようにします。

ステップ2.1 - 分析：草稿全体を読みます。writer-pass2-cognitive-load-analysis.md という分析ファイルを作成し、読者を一時的に誤解させる文（garden-path sentences）、埋もれた主題、主語・動詞・目的語が7語以上離れている箇所、曖昧な代名詞、途切れたトピックの連鎖、読み返しが必要な文など、すべての問題を特定します。

ステップ2.2 - 改善：分析ファイルを読みます。草稿全体を見直して改善します。読者を一時的に誤解させる文を修正し、各文の冒頭でトピックを示し、主語・動詞・目的語を近づけ、代名詞を明確にし、トピックの連鎖を修復し、複雑すぎる文を分割します。つまずく箇所がないか、声に出して読み上げて確認します。

詳しい例については、resources/revision-guide.md - Pass 2 を参照してください。

パス 3：リズムを整える（Clark）

目標： 文の長さに変化をつけ、力強い結びで、読者を引き込む流れを生み出します。

ステップ 3.1 - 分析：原稿全体を読みます。writer-pass3-rhythm-analysis.md という分析ファイルを作成し、次の点を分析します：各段落の文の長さ（実際の長さを列挙）、単調なパターン（似た長さの文が5文以上連続している箇所）、各文の最後の単語（弱い結びに印を付ける）、ゴールドコインの配置（間隔が空いている箇所を特定）、抽象度の階段を活用できる箇所（具体 -> 一般 -> 具体）、変化に乏しいセクション。

ステップ 3.2 - 改善：分析ファイルを読みます。原稿全体を見直し、長い文のあとに強調のための短い文を加え、弱い文末を力強い言葉に置き換え、ゴールドコインの瞬間を（特に中盤に）散りばめ、抽象度の階段を取り入れ、文の長さに意図的な変化をつけます。流れを確認するために音読します。短文・中文・長文がバランスよく混在していることを確認します。

詳しい例については、resources/revision-guide.md - パス 3 を参照してください。

resources/evaluators/rubric_revision.json を使って評価します。最低基準：平均スコア >= 3.5。

パスの概要

パス焦点手法目標
パス 1冗長さZinsser/King単語数を10-25%削減
パス 2認知負荷Pinker読み返し不要
パス 3リズムClark長さに変化をつけ、力強い結びにする

ガードレール

要件：

  1. 意味を保つ：削除や再構成を行っても、著者が意図した意味を損なわないようにします
  2. 改善の前に分析する：必ず最初に分析ファイルを作成し、その結果に基づいて改善します
  3. 全体を対象にする：各パスでは最初の数段落だけでなく、原稿全体を分析します
  4. 削減量を測定する：パス 1 では実際の単語数の削減量を記録します（目標は10-25%）
  5. 音読する：パス 2 と 3 のあとに音読し、つまずく箇所やリズムを確認します

よくある落とし穴：

  • 1回のパスですべてを直そうとする（各パスでは1つの焦点に絞る）
  • 冒頭の段落だけを見直し、途中で手を抜く
  • 削りすぎて文章の個性が失われる
  • 実際の単語数の削減量を記録しない
  • 分析の段階を飛ばして、すぐに編集を始める

クイックリファレンス

主なリソース：

必要な入力：

  • 修正する原稿テキスト（どの段階でも可）
  • ユーザーの意図または中心的なメッセージ（分かる場合）
  • 制約（目標の単語数、希望するトーンなど）

生成される出力：

  • 各パスの分析ファイル（冗長さ、認知負荷、リズム）
  • 単語数の削減量を記録した修正版の原稿
  • 各パスで行った変更の概要

コメント

Markdown 対応