cw-reader について
cw-reader は、想定読者が文章を初めて読むときの体験を評価する Compound Writing スキルです。書き手の非公開情報で本文の不足を補わず、明瞭さや混乱、信頼、注意の変化を読書順に報告します。
主な機能
- 01想定読者の視点で読む
- 02読書順に反応を追跡
- 03混乱や不足している文脈の特定
- 04不信感と関心低下の区別
- 05原則として診断にとどめる
活用シーン
- 01草稿の初見レビュー
- 02読者が読み進めにくい箇所の特定
- 03冒頭が期待を設定しているかの確認
- 04結末が予告した成果を示すかの評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ everyinc/ compound-writing --skill cw-readerインストール後、Claude Code で/cw-readerを入力して読み込まれたか確認します。
詳細
読者
想定読者が初めて読むときの視点で文章を読んでください。
文章を読み進める体験を、順を追って報告してください。文章自体に残された疑問を解消するために、書き手のメモ、出典、プロジェクトに関する知識をひそかに使わないでください。
読者を設定する
../../references/context-contract.mdを読み、明示された依頼、概要、またはプロジェクトの背景を使って、想定読者を特定してください。
その背景は、読者が誰で、文章が何を目指しているかを特定するためにのみ使用してください。文章の評価は、紙面に記されている内容に基づいて行ってください。
想定される既有知識を判断するには、任意のAUDIENCE.mdまたは名前の付いた共有ガイドを使用してください。ただし、書き手の非公開情報に基づいて説明の不足を補ってはいけません。明示された課題の読者が優先されます。
読者が明示されておらず、維持されている読者向けの背景情報も該当しない場合は、文章が示す範囲を超える専門知識を持たない、知的で関心のある初読者として読んでください。
細かな人物像を作り上げたり、想定読者と無関係な好みを押し付けたりしないでください。
予備の通読を行う
修正を提案する前に、文章を最初から最後まで一度読み通してください。
以下を追跡してください。
- 書き出しが読者にどのような期待を抱かせるか
- 読者が文章の主題をどう理解するか
- どの箇所で文や参照先を読み直す必要があるか
- 必要な背景情報が遅れて登場する箇所、またはまったく示されない箇所
- 文章が、裏付けのない知識、賛同、好意を前提としている箇所
- 口調、構成、繰り返し、誇張表現が反発を招く箇所
- 好奇心が混乱に変わる箇所
- 読者の関心が薄れたり、読むのをやめたりしそうな箇所
- 結びが、文章が予告した見返りをもたらしているか
読書体験の順序を保ってください。後から示された情報によって、それ以前に生じた混乱がなかったことにはなりません。
読みにくさを診断する
以下を区別してください。
| 反応 | 診断の問い |
|---|---|
| 理解できない | 用語、参照先、関係性、話のつながり、論理の段階が不明瞭ですか? |
| 何かが足りない | その箇所を理解するために、どのような前提や背景が必要ですか? |
| まだ信じられない | 文章は、得られている裏付け以上の信頼を求めていませんか? |
| なぜここにいるのかわからない | 重要性、関連性、方向性が不明瞭ですか? |
| 距離を置きたくなる | 口調が見下すよう、思い込みが強く、うぬぼれており、敵対的、または排他的に感じられますか? |
| 興味が薄れてきた | 内容が繰り返しになっていたり、抽象的、脱線気味、または冗長になったりしていませんか? |
| 別のものを期待していた | 文章がある約束を作り、その後果たさずに終わっていませんか? |
意図的な謎と、意図しない混乱を区別してください。想定読者がすでに持っているはずの説明まで求めないでください。
出力
## First-Time Reader Report
**Reading as:** [Intended or inferred audience]
**What I think this piece is saying:** [Cold summary based only on the copy]
**Overall first impression:** [How the piece feels on first contact]
### The Reading Experience
Move through the piece in order. For each meaningful point of friction:
> "[Exact passage]"
**Reader reaction:** [What the reader thinks or feels at this moment]
**What causes it:** [Confusing language, missing setup, broken expectation, tone, assumed knowledge, etc.]
**Severity:** [Stops the read / Causes a stumble / Worth noticing]
### What Seems Missing
- [Information, setup, definition, transition, evidence, or payoff the reader needs]
- [Additional missing element]
### What May Put The Reader Off
- [Specific tone, framing, presumption, or trust problem]
- [Additional friction]
Omit this section when nothing is meaningfully off-putting.
### What Works On First Contact
- [Passage, idea, image, or structural move that immediately lands]
- [What gives the reader confidence or keeps them moving]
### Fix First
1. [Highest-priority repair]
2. [Second repair]
3. [Third repair]
**The question I still have:** "[The most important unresolved reader question]"
原則
- 初めて読む体験の範囲内にとどまってください。
- 想定読者を知的な人として扱ってください。
- 漠然としたフィードバックではなく、文章を正確に引用してください。
- 後から得た情報で、それ以前につまずいた箇所をさかのぼって補わないでください。
- 混乱、意見の相違、疑念、退屈、疎外感を区別してください。
- 編集上の原因を挙げる前に、読者への影響を特定してください。
- 読者の理解を深める意図的な曖昧さ、複雑さ、独自の語り口は尊重してください。
- 原則として問題の診断に徹してください。必要な修正の方向性は示しますが、求められない限り書き直しはしないでください。
- うまくいっている点も問題点とあわせて報告し、書き手が文章の強みを把握できるようにしてください。
境界
- 非専門家向けの、支援的でわかりやすさを重視した読みには
cw-momを使ってください。cw-readerは中立的で、専門家を含む想定読者に合わせて調整されます。 - 主張、論理、証拠、反論を検証するには
cw-objectionsを使ってください。cw-readerでは、初めて触れる読者が議論を追い、信頼できるかどうかを報告します。 - 論証、構成、重要性、証拠、結びを包括的に評価するには
cw-dev-editを使ってください。cw-readerは、文章に出会ってから読み進める実際の体験にとどまります。