mcpField
P
prose-mechanics

prose-mechanics

github.com/rhavekostクリエイティブ・メディア20258 回インストール今日更新
リポジトリ

prose-mechanics について

prose-mechanicsは、構成が固まった小説やノンフィクションの原稿を仕上げる作者向けの診断スキルです。文章単位の問題を監査して報告し、自動修正は行わず作者の判断に委ねます。

主な機能

  1. 01対象を絞った文章監査を順番に実行
  2. 02文法、文体、一貫性を確認
  3. 03重要度と箇所別に問題を報告
  4. 04セッションをまたいで監査状況を記録
  5. 05scriptoriumによる監査処理にも対応

活用シーン

  1. 01投稿前の完成間近の原稿を推敲
  2. 02章をまたいで未解決の文章課題を追跡
  3. 03構成編集後に文単位のパターンを確認

インストール

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

$npx skills add https://github.com/rhavekost/author-toolkit --skill prose-mechanics

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
audit-tracker-template.md
references/
accessibility-audit.md
active-passive-audit.md
adverb-audit.md
cliches-audit.md
crutch-words-audit.md
dialogue-tags-audit.md
echoes-audit.md
filter-words-audit.md
frequency-audit.md
invented-term-consistency-audit.md
parallel-structure-audit.md
pov-consistency-audit.md
pronoun-clarity-audit.md
sentence-length-variance.md
sentence-starters-audit.md
show-vs-tell-audit.md
sticky-sentences-audit.md
references/exemplars/active-voice/
agent-restored-01.md
references/exemplars/deep-pov/
filter-removal-01.md
references/exemplars/dialogue-tags/
invisible-tag-01.md
references/exemplars/echoes/
varied-diction-01.md
references/exemplars/frequency/
lexical-range-01.md
references/exemplars/fresh-language/
cliche-replacement-01.md
references/exemplars/glue-words/
tightened-sentence-01.md
references/exemplars/readability/
grade-consistency-01.md
paragraph-break-01.md
references/exemplars/sentence-openers/
varied-starts-01.md
references/exemplars/sentence-variance/
mixed-rhythm-01.md
references/exemplars/verb-choice/
adverb-removal-01.md

詳細

文章の技術面

完成間近の原稿を対象に、文単位の文章品質を診断する監査です。各監査では、特定の観点に絞って確認し、問題箇所の報告を作成します。著者は報告を確認して修正を適用してから、次の監査に進みます。フィクションにもノンフィクションにも対応します。

セッションの継続性

監査作業は複数のセッションにわたって反復して行います。Claude はセッション間の記憶を保持しないため、監査トラッカーを永続的な状態管理に使用します。

  • セッション開始時: プロジェクトディレクトリ内の audit-tracker.md を読み込みます(存在しない場合は、assets/audit-tracker-template.md をコピーします)。どの章に対してどの監査を実施済みか、未実施の監査は何かを確認します。
  • セッション終了時: 実施した監査、指摘した内容、解決した内容をトラッカーに記録します。作業を中断した箇所も記録します。
  • 未解決の質問を提示: 過去の監査で指摘され、著者がまだ対応していない問題があれば、セッション開始時に一覧にして、ユーザーが対応するかどうかを判断できるようにします。

基本概念

監査は診断であり、編集ではありません。各監査では、特定の種類の問題だけを確認し、指摘箇所の一覧を作成して終了します。それぞれの指摘が実際に問題なのか、どのように修正するのかは、監査ではなく著者が判断します。

使用する場面

このスキルは、次の用途に適しています。

  • ✅ 完成済みまたは完成間近の原稿(フィクションまたはノンフィクション)の文単位の監査
  • ✅ 投稿、問い合わせ、出版前の最終的な仕上げ
  • ✅ 構成編集を経ても残る、文章上の機械的な問題の発見
  • ✅ 構成編集が終わった後の fiction-workshop または narrative-nonfiction の作業を補完

使用しない場面

このスキルは、次の用途には適していません。

  • ❌ 初期の執筆段階。監査は生成ではなく、改稿のためのものです。
  • ❌ 構成編集の作業。代わりに fiction-workshop または narrative-nonfiction を使用してください。
  • ❌ まだ構成が固まっていない原稿。削除予定の文章を監査することになります。
  • ❌ 目視で確認するほうが監査を実行するより速い、単一の場面や短い文章
  • ❌ 監査の前提が当てはまらない、大幅な文体上の逸脱(例:実験的な文章)

監査パス

監査は一度に1つずつ、順番に実行してください。順序が重要です。先に行う監査によって、後の監査が検出する内容が変わるためです。推奨する順序は、まず頻度ファミリー(つなぎ言葉の設定に反映されるため)、次に機械的な監査、最後に意味的な監査(判断コストが高く、これから手直しする文章には実行しないでください)です。

#監査分類実行方法検出対象
1能動態/受動態ハイブリッド「Run active/passive audit on...」正当化されていない受動態、隠れた行為者
2並列構造意味的「Run parallel-structure audit on...」文法的な並列の崩れ
3文の長さのばらつき(ファイル:sentence-length-variance.md)決定的「Run sentence-variance audit on...」単調なリズム、狭い長さの範囲
4読みやすさ(ファイル:accessibility-audit.md)決定的「Run readability audit on...」学年レベルの急上昇、段落の肥大化
5反復決定的「Run echoes audit on...」100語以内での単語の反復
6頻度決定的「Run frequency audit on...」原稿全体にわたる単語の過剰使用
7つなぎ言葉決定的「Run crutch-words audit on...」著者固有の過剰使用語
8フィルター語決定的「Run filter-words audit on...」felt/saw/heard/realized/noticed/watched
9副詞監査決定的「Run adverb audit on...」-ly の密度、会話文と地の文の比較
10会話タグハイブリッド「Run dialogue-tags audit on...」said-bookism、副詞で修飾されたタグ
11粘着性の高い文決定的「Run sticky-sentences audit on...」つなぎ語の密度
12文頭決定的「Run sentence-starters audit on...」文頭パターンの反復
13時制の一貫性ハイブリッド「Run tense-consistency audit on...」意図しない時制の切り替わり
14創作語の一貫性決定的「Run invented-term-consistency audit on...」大文字・小文字/綴りの揺れ
15クリシェハイブリッド「Run cliches audit on...」使い古された表現
16代名詞の明確さ意味的「Run pronoun-clarity audit on...」曖昧な先行詞
17描写と説明意味的「Run show-vs-tell audit on...」感情を名指しする表現と、ドラマとして描く表現
18視点の一貫性意味的「Run pov-consistency audit on...」視点の飛び移り、知識の矛盾
19AI らしい表現ハイブリッド「Run ai-isms audit on...」avoid-ai-writing のリストと照合

実行中の監査に一致する参照ファイルのみを読み込んでください。セッションの開始時にすべての参照ファイルを事前に読み込まないでください。コンテキストの予算を無駄にします。セッションの途中で監査を切り替える場合は、新しい参照ファイルを読み込み、以前のファイルは対象外として扱ってください。

検出結果の形式

各監査では、../../references/finding-schema.json に準拠する検出結果を出力します。 audit、technique、severity(note/suggestion/warning)、location (file/line/quote)、issue、exemplar(任意)、confidence (deterministic/judgment)を含めてください。検出結果は重大度ごとにまとめ、exemplar の参照があれば references/exemplars/<ref>.md を参照して解決してください。

エンジンフック

監査を実行する前に、command -v scriptorium を確認してください。コマンドが成功した場合:

  • 決定的な監査: scriptorium prose audit <name> <chapter> を実行し、その JSON を信頼できる情報源として扱ってください。検出結果を手作業で再導出しないでください。
  • ハイブリッド監査: scriptorium prose prepare <name> <chapter> を実行してコードで検出された候補を取得し、監査の参照ファイルに従ってそれぞれを判定してから、scriptorium prose submit-findings <state> --findings-file <file> を実行してください。
  • 意味的な監査: scriptorium prose prepare <name> <chapter> を実行してください(候補はなく、生の章に対する純粋な判断のみです)。埋め込まれた指示に従って判定し、その後 submit-findings を実行してください。

scriptorium が利用できない場合は、参照ファイルの検出ルールに直接従って、会話形式で監査を実施してください。これは監査の完全な仕様であり、簡略版の代替手段ではありません。

ワークフロー

各監査では、次の手順に従います。

  1. 範囲: 監査する章または箇所を確認します。ユーザーがより広い範囲を指定しない限り、一度に1章を監査します。

  2. 監査を実施する: 関連するリファレンスファイルに記載された特定のパターンに注意しながら、文章を読みます。ほかの種類の問題は探さず、確認する観点を絞ります。

  3. 問題箇所のレポートを作成する: 指摘した箇所ごとに、次の情報を出力します。

    • ファイル名とおおよその位置
    • 指摘したテキスト(短い抜粋)
    • 指摘した理由(該当する検出パターン)
    • 修正案を1つか2つ(必須ではなく、選択肢として提示)
  4. 停止して著者のレビューを待つ。 修正を自動で適用しないでください。どの指摘が実際の問題で、どれが文体上の選択なのかは、著者が判断します。

  5. 承認された修正を適用する: 著者が確認した指摘のみ、str_replace を使って必要最小限の編集を行います。それ以外はコメントせず、そのままにします。

  6. トラッカーを更新する: 実施した監査、その対象の章、指摘内容、解決した内容を記録します。

  7. 次の監査へ進む。 同じ手順を繰り返します。

よくある間違い

間違い発生する理由修正方法
すべての監査を同時に実施する一度に徹底的に確認しようとする監査ごとに確認する観点が異なります。まとめて実施すると、著者が対応できないほどの大量の指摘が生じます。一度に1つずつ実施します。
機械的に修正を適用する指摘を診断ではなく指示として扱う指摘にはすべて個別の判断が必要です。受動態の指摘が、適切な受動態である場合もあります。指摘を提示し、選択は著者に委ねます。
監査を行単位の編集として扱う診断と改訂を混同する監査では問題の候補を特定し、行単位の編集ではそれを解決します。まず監査を行い、その後に行単位の編集を行います。同時には行いません。
草稿が安定する前に監査する「進めながら磨く」という習慣章の削除や順序変更が続いている場合、文章の監査に費やした労力は無駄になります。構成が安定するまで待ちます。
レポート作成を省くその場で修正して効率化しようとするレポートこそが成果物です。レポートによって、著者自身がパターンを見抜けるようになります。これが監査の長期的な価値です。
順序を変えて監査する都合やユーザーからの依頼各監査の結果は、次の監査で指摘される内容に影響します。ユーザーが別の順序を希望する場合は、後続の監査を再実施する必要が生じる可能性を伝えます。
構成の検討中に監査する行単位の文章上の問題と構成上の問題を取り違える文章上の技術的な問題は、構成が固まった後に扱うものです。章の目的が明確でないなら、問題は文章ではありません。まず構成を検討するスキルを使います。

セルフチェック:うまく進められていますか?

監査を正しく実施できているか、次のチェック項目で確認します。

監査を始める前:

  • 原稿の構成は安定していますか(大幅な削除や順序変更が残っていませんか)?
  • 以前の構成検討とキャラクターに関する作業は完了していますか?
  • 監査の範囲(対象の章、箇所)は明確に定義されていますか?

監査の実施中:

  • 関連するリファレンスファイルのパターンだけを使っていますか?
  • 修正を直接適用するのではなく、問題箇所のレポートを作成していますか?
  • 監査の範囲外の問題に気づいても、対応を見送っていますか?

レポートの作成後:

  • 著者は監査のリファレンスを読み返さなくても、各指摘に対応できますか?
  • 指摘ごとに短い抜粋と修正案を記載しましたか?
  • 次の監査に進まず、停止してレビューを待ちましたか?

修正の適用後:

  • 必要最小限の変更にのみ str_replace を使用しましたか?
  • 著者が確認しなかった指摘は、再度取り上げずに見送りましたか?
  • セッションを終える前にトラッカーを更新しましたか?

次の監査に進む前:

  • 現在の監査の指摘はすべて処理済みですか(適用、却下、または注記付きで保留)?
  • 著者が続行を希望していることを確認しましたか?

いずれかのチェック項目に「いいえ」と答えた場合は、続行せず、その問題を解決してください。

停止ポイント

各監査には明確な終了点があります。そこで停止してください。次の監査へ自動的に進んだり、監査の対象範囲をひそかに広げたり、執筆者の明示的な確認なしに修正を適用したりしないでください。

ツール/フェーズ次の場合に停止その後
能動態/受動態監査依頼された範囲について、問題の指摘レポートを提出した執筆者のレビューを待ちます。修正を適用しないでください。次の監査を開始しないでください。
並列構造監査問題の指摘レポートを提出した同上です。差異の監査へ進まないでください。
文の長さのばらつき監査標準偏差の数値と指摘箇所を含む、問題の指摘レポートを提出した待ちます。ばらつきへの修正は波及するため、確認が重要です。
可読性監査FK グレード、段落の長さ、専門用語の指摘を含む、問題の指摘レポートを提出した待ちます。構造上の懸念が見つかっても、発達的編集へ切り替えないでください。指摘して停止します。
承認済み修正の適用執筆者が確認した指摘すべてを str_replace で解決したトラッカーを更新します。確認なしに次の監査を開始しないでください。
監査の順序執筆者が延期した、または後続の監査で原稿に構造的な作業が必要だと判明した停止します。トラッカーに記録します。構造面の作業には fiction-workshop または narrative-nonfiction に切り替えるよう、執筆者に勧めます。
セッション停止ポイントに達した、またはコンテキストウィンドウが埋まりかけているaudit-tracker.md を更新し、sessions/ にメモを作成して停止します。

執筆者から停止ポイントを越えて続行するよう明示的に依頼された場合(例:「明らかな修正だけ適用して」)は、続けてもかまいません。ただし、対応する指摘と見送る指摘を明記し、範囲の変更が見えるようにしてください。

コマンド早見表

目的コマンド
監査シーケンスを開始する「[chapter] の文章技法の監査を実行して」
能動態/受動態のみ「[chapter] の能動態/受動態監査を実行して」
並列構造のみ「[chapter] の並列構造監査を実行して」
文のばらつきのみ「[chapter] の文のばらつき監査を実行して」
可読性のみ「[chapter] の可読性監査を実行して」
監査状況を確認する「[chapter] ではどの監査を実行した?」

ファイル

  • references/active-passive-audit.md - 文レベルの態と主体性
  • references/parallel-structure-audit.md - リスト、比較、列挙における文法的な並列性
  • references/sentence-length-variance.md - 段落のリズム診断
  • references/accessibility-audit.md - 可読性のスコアリングと構造上のアクセシビリティ
  • assets/audit-tracker-template.md - 監査の実行と結果を記録するプロジェクトごとのトラッカー

コメント