mcpField
N
non-fiction-revision

non-fiction-revision

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

non-fiction-revision について

ビジネス、学術、回想録、ポピュラーサイエンスなどのノンフィクションを改稿するための診断スキルです。論旨、構成、根拠、読者の理解、出典の課題を分け、編集の波及も追跡します。

主な機能

  1. 016種類の改稿課題を診断
  2. 02論旨、構成、根拠、読者のニーズを評価
  3. 03章と主張の依存関係を整理
  4. 04改稿リスクと成功基準を評価
  5. 05変更内容とロールバックの検討事項を記録

活用シーン

  1. 01本の論証が弱く感じられる原因の特定
  2. 02章の並べ替えや中心的主張の変更計画
  3. 03根拠と出典の質の向上
  4. 04編集による連鎖的な問題への対処

インストール

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

$npx skills add https://github.com/jwynia/agent-skills --skill non-fiction-revision

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

詳細

ノンフィクション改稿の診断

目的

ノンフィクション書籍(ビジネス、自己啓発、学術、ポピュラーサイエンス、回顧録)の改稿を診断し、方向性を示します。ノンフィクションは、論旨、構成、証拠、教育的設計という複数のレベルが同時に機能します。あるレベルでの変更は、ほかのレベルにも波及します。このスキルは、どのレベルに対応が必要かを特定し、改稿による損傷を防ぎます。

クイックリファレンス

状態シグナル主な問題
NR1論旨が不明瞭、または弱く感じられる概念レベルの問題
NR2論点が論理的に積み上がっていない構成上の問題
NR3主張を裏付ける根拠が不十分証拠の問題
NR4読者から分かりにくいという声がある教育的設計の問題
NR5出典が古い、または弱い信頼性の問題
NR6変更によって新たな問題が生じている波及の失敗

複数レベルの構造

すべてのノンフィクション書籍は、次の各レベルで同時に機能します。

レベル1:概念/論旨
  • 中心となる論旨と主要な論点
  • 基礎となる前提とフレームワーク
  • 哲学的または理論的な立場
  • 全体的な目的と意図する影響
レベル2:構成/論証
  • 論理的な論証の順序と流れ
  • 章の構成と依存関係
  • 証拠の配分と裏付けのパターン
  • 読者の道筋と説得の設計
レベル3:内容/証拠
  • 具体的な証拠、事例、データ
  • 説明と補足
  • 文体、トーン、読みやすさ
  • 引用、出典、信頼性を示す要素
レベル4:教育的設計/読者
  • 学習の進行と足場づくり
  • 認知負荷の管理
  • 関与と記憶定着のための工夫
  • 実践への応用ガイダンス

重要な原則

あるレベルでの変更は、ほかのすべてのレベルにおける論証の妥当性や読者の理解に影響する可能性があります。

変更は波及します。

  • 上位へ:新たな証拠が、既存の論証を損なう可能性があります
  • 下位へ:論旨を変更すると、全体の再構成が必要になります
  • 横方向へ:章の順序を変更すると、論証の展開の流れに影響します

診断状態

NR1:論旨/中心的な論点の問題

症状:

  • 論旨が不明瞭、または明示されていない
  • 主要な論点が弱い、または説得力に欠ける
  • 中心的な主張が頻繁に異議を唱えられる
  • 書籍の目的を明確に説明しにくい
  • 結論が冒頭で示した約束を果たしていない

診断の質問:

  1. 論旨を一文で述べられますか?
  2. それを支える主要な論点は何ですか(3~5点)?
  3. 各主要な論点を裏付ける証拠は何ですか?
  4. 結論は冒頭で示した約束に沿っていますか?
  5. 論旨が誤りだった場合、何が変わりますか?

対応策:

  1. 論旨を支える現在の証拠をすべて整理する
  2. 現在の論旨の定式化に依存している章を特定する
  3. 論旨を改訂する場合、どのような新たな証拠が必要になるかを評価する
  4. 論旨の変更が読者への約束にどう影響するかを確認する
  5. 結論と行動喚起への影響を評価する

**波及に関する警告:**論旨の変更は最も危険です。章全体を無効にする可能性があります。論旨を変更する前に、すべての依存関係を整理してください。


NR2:構成/全体構成の問題

症状:

  • 論証の流れが非論理的に感じられる
  • 章同士のつながりがないように見える
  • 前提となる知識が、必要になる前に示されていない
  • 読者が理解するために前の箇所に戻らなければならない
  • 同じ論点が、発展しないまま繰り返されている

診断の質問:

  1. 各章の論理的な前提条件は何ですか?
  2. 知識は積み上がっていますか、それとも繰り返されていますか?
  3. 後の章に依存する論点はありますか?
  4. 論理を崩さずに章の順序を入れ替えられますか?
  5. つなぎの部分で論理的なつながりが説明されていますか?

対応策:

  1. 章同士の関係を示す依存関係マップを作成する
  2. 主要な論点ごとに論理的な前提条件を特定する
  3. 構成全体を通じて読者の知識がどう積み上がるかを整理する
  4. 読者の理解に必要な条件に照らして、別の順序を検証する
  5. 事例が引き続き文脈に適していることを確認する

**波及に関する警告:**章の順序を変えると、相互参照や前後の参照すべてに影響します。内部の引用をすべて追跡してください。


NR3:根拠/裏付けの問題

症状:

  • 主張に裏付けがなく、曖昧に感じられる
  • 「証拠はこれです」ではなく、「信じてください」という印象がある
  • 根拠はあるものの、主張と結び付いていない
  • 主張ごとに裏付けの質にばらつきがある
  • 重要な論拠が弱い基盤に依存している

診断の質問:

  1. それぞれの主要な主張は、どのような種類の根拠に裏付けられていますか?
  2. 根拠の基準は全体を通して一貫していますか?
  3. 最も裏付けが弱い主張はどれですか?
  4. 根拠は実際に主張の内容を証明していますか?
  5. 反論には対応していますか?

介入策:

  1. 主要な主張ごとに根拠の質を監査します
  2. より強い、または異なる裏付けが必要な主張を特定します
  3. 新たな根拠が既存の論拠に与える影響を評価します
  4. 引用形式と情報源の質に一貫性があるか確認します
  5. 根拠を追加すると論拠の強さが変わるかを評価します

連鎖的な問題への警告: ある主張に強い根拠を加えると、読者が期待する根拠の基準が上がり、意図せずほかの主張を弱めることがあります。


NR4:教育/理解の問題

症状:

  • 読者から分かりにくいという声が上がる
  • 複雑な概念が導入されるのが早すぎる
  • 例が理解を助けず、かえって混乱を招く
  • 実践への応用が不明確
  • 想定読者が内容についていけない

診断の質問:

  1. 読者は通常、どこで理解につまずきますか?
  2. 専門用語は使う前に定義されていますか?
  3. 例は読者の経験に合っていますか?
  4. 認知負荷は分散されていますか、それとも最初に集中していますか?
  5. 読者は学んだことを応用できますか?

介入策:

  1. 各章における認知負荷の分布を図にします
  2. より適切な足場づくりが必要な概念を特定します
  3. 例の有効性と関連性を評価します
  4. 実践的なガイダンスが実行可能か確認します
  5. 複雑さの段階的な高まりが適切か評価します

連鎖的な問題への警告: 簡略化によって、論拠を支えるニュアンスが意図せず失われることがあります。分かりやすさと正確さのバランスを取りましょう。


NR5:信頼性/情報源の問題

症状:

  • 情報源が古いと感じられる
  • 引用のパターンに一貫性がない
  • 著者の権威性が疑問視される
  • 時代に合わない例が使われている
  • 専門家の名前を挙げずに「専門家によれば」としている

診断の質問:

  1. 最も古い情報源はどれくらい前のものですか?
  2. 情報源はその分野に適していますか?
  3. 引用形式は全体を通して一貫していますか?
  4. 専門家の名前を挙げていますか、それとも一般的な表現にとどめていますか?
  5. 読者が当然期待する情報源で、欠けているものはありますか?

介入策:

  1. 情報源の新しさと質を監査します
  2. より新しい裏付けが必要な主張を特定します
  3. 引用形式と詳しさを統一します
  4. 漠然とした専門家への言及を具体的な引用に置き換えます
  5. その分野で参照が期待される主要な情報源を追加します

連鎖的な問題への警告: 情報源を更新すると、根拠が実際に示している内容が意図せず変わることがあります。新しい情報源が同じ結論を裏付けているか確認しましょう。


NR6:連鎖的な破綻

症状:

  • 修正によって新たな問題が生じる
  • ある章の変更が別の章を損なう
  • 根拠の更新によって論拠が無効になる
  • 構成の変更によって新たな混乱が生じる
  • 作業が前に進まないように感じられる

診断の質問:

  1. 連鎖的な問題のきっかけとなった最初の変更は何ですか?
  2. どの依存関係が把握されていませんでしたか?
  3. 安定したロールバック地点はありますか?
  4. アイデアを試すための、実行可能な最小限の変更は何ですか?
  5. 問題は局所的ですか、それとも全体に及んでいますか?

介入策:

  1. 実装を中断し、影響範囲を評価します
  2. 最後に安定していた状態を特定します
  3. 想定上のものではなく、実際の依存関係を洗い出します
  4. 連鎖的な問題のコストに見合う変更かどうかを検討します
  5. 続行する場合は、変更を管理するためのチェックポイント方式を設けます

ロールバックの基準:

  • 論理の基本構造が崩れる
  • 根拠の要件を満たすことが不可能になる
  • 変更によって解決される問題よりも、信頼性の問題が多く生じる
  • 読者の理解が著しく損なわれる

変更前の手順

変更を実施する前に、必ず次の作業を行います。

1. 変更レベルを特定する
  • 概念(論旨、主要な論拠、フレームワーク)
  • 構造(章の順序、論旨の流れ、構成)
  • 内容(根拠、例、説明)
  • 教育(提示方法、足場づくり、応用)
2. 依存関係を把握する

変更ごとに、以下を記録します。

  • 前提条件:この変更が機能するために、何を維持する必要がありますか?
  • 依存する要素:後続のどの主張が、この要素に依存していますか?
  • 根拠:どの裏付けが必要になり、または不要になりますか?
  • 理解度:読者の学習の流れにどのような影響がありますか?
3. 変更の波及リスクを評価する
  • 低:変更は独立しており、依存関係はありません
  • 中:ほかの2~3要素の更新が必要です
  • 高:複数の章または中核となる主張に影響します
  • 重大:書籍の基盤となる構成を脅かします
4. 成功基準を定める

変更する前に、評価方法を決めておきます。

  • 論理的一貫性:議論の流れは保たれていますか?
  • 根拠の妥当性:主張は引き続き裏付けられていますか?
  • 読者の理解度:読者は引き続き内容を追えますか?
  • 信頼性:権威性は保たれていますか?

変更記録テンプレート

# Revision: [Brief Description]

## Change Type
- [ ] Conceptual  - [ ] Structural  - [ ] Content  - [ ] Pedagogical

## Rationale
[Why this change improves the book]

## Dependency Analysis
- Prerequisites affected:
- Dependent elements:
- Evidence changes needed:
- Comprehension impacts:

## Cascade Risk Level
- [ ] Low  - [ ] Medium  - [ ] High  - [ ] Critical

## Success Criteria
- Logical coherence check:
- Evidence adequacy standard:
- Reader comprehension benchmark:

## Implementation Status
- [ ] Initial change complete
- [ ] Dependencies updated
- [ ] Cross-references revised
- [ ] Cascade effects resolved

## Outcome
[Complete after implementation]

ノンフィクションの種類による違い

学術・研究
  • 方法論の一貫性が最も重要です
  • 文献レビューは最新の状態に保つ必要があります
  • 査読での批判を想定します
  • 貢献を明確にすることが不可欠です
ビジネス・セルフヘルプ
  • 実用性を何よりも重視します
  • 事例は現代に即したものにします
  • 実践の手引きが必要です
  • ROI/メリットを明確にします
ポピュラーサイエンス
  • 内容を単純化しすぎず、わかりやすくします
  • 研究の最新性が重要です
  • 類推は実際に理解の助けになるものにします
  • 教育的な内容と興味を引く内容のバランスを取ります
回想録・個人的な物語
  • 事実の正確さと説得力のある物語を両立します
  • 感情の真実味を保ちます
  • プライバシーの境界を尊重します
  • 個人的な体験を普遍的なテーマにつなげます

アンチパターン

終わりのない改稿の連鎖

ある箇所を直すと別の箇所が崩れ、それを直すとまた別の箇所が崩れます。書籍が安定した状態に到達しません。

**対策:**必要最小限の変更を定めて実施し、次の変更に進む前に安定させます。

根拠への依存

議論の質を高めないまま、情報源を次々に追加します。量で弱点を覆い隠しています。

**対策:**根拠は量より質を重視します。質の高い研究1件は、質の低い研究10件に勝ります。

わかりやすさの罠

正確さが損なわれるまで単純化します。読者は理解できますが、誤った内容を学んでしまいます。

**対策:**複雑さを取り除くのではなく、段階的に説明します。細かなニュアンスへと導きます。

主題の逸脱

小さな変更が積み重なり、書籍が当初の意図とは異なることを主張するようになります。

**対策:**結論が序文で約束した内容と今も一致しているか、定期的に確認します。


連携ポイント

受け入れ側:

  • researchから:新たな根拠を集めるとき
  • revisionから:全体的な改稿方針を検討するとき

引き渡し側:

  • prose-styleへ:構成上の問題を解決したあと
  • fact-checkへ:根拠を検証するとき

補完関係:

  • research:根拠の収集
  • revision:フィクションの改稿(並行するスキル)

コメント