mcpField
W
writers-helper

writers-helper

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

writers-helper について

writers-helperは、個人の作家や執筆プロジェクト向けに、着想から計画、執筆、改稿、投稿までを支援するスキルです。段階や課題に応じて資料、テンプレート、計画・原稿分析・投稿管理用スクリプトを使い分けます。

主な機能

  1. 01執筆の全段階をカバー
  2. 02段階とモードに応じて作業を案内
  3. 03計画・改稿テンプレートを提供
  4. 04物語上の位置に応じたプロンプト生成
  5. 05原稿の指標を分析
  6. 06執筆習慣と投稿状況を記録

活用シーン

  1. 01着想から出版に向けてプロジェクトを進行
  2. 02執筆の停滞を診断して練習を計画
  3. 03構成から校正まで順序立てて原稿を改稿
  4. 04投稿とフォローアップを管理

インストール

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

$npx skills add https://github.com/magnus919/agent-skills --skill writers-helper

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

同梱ファイル

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

README.md
evals/
evals.json
references/
blocks-and-prompts.md
craft-and-structure.md
drafting-and-process.md
editing-and-revision.md
genres-and-formats.md
habits-and-lifestyle.md
pitfalls-and-solutions.md
prose-and-style.md
publishing-and-career.md
workflow-and-planning.md
scripts/
habit-log.py
manuscript-stats.py
session-planner.py
submission-tracker.py
writing-prompt.py
templates/
book-proposal.md
character-profile.md
critique-checklist.md
premise-canvas.md
prompt-cards.md
query-letter.md
revision-plan.md
scene-skeleton.md
session-plan.md
story-outline.md
submission-log.md
synopsis.md
worldbuilding-questionnaire.md

詳細

執筆 — 作家のためのパーソナルスキル

一人の作家(または一つの執筆プロジェクト)が、アイデアから出版まで進められるよう支援します。このスキルは、古典的な作家の技法に関する教えを、執筆関連書籍44冊から抽出してまとめたものです。企画、リサーチ、執筆、改稿、創作上の行き詰まり、プロンプト、習慣、そしてビジネス面(企画書、問い合わせ状、エージェント、出版社、契約)まで、あらゆる段階を網羅しています。

運用原則(必ず守ること)

  1. 草稿を守る。 執筆中は、批評しない、読み返さない、執筆の途中でリサーチしない。後で確認する事実は「未確認事項」のリストに記録します。初稿は素材であり、品質のチェックは改稿時に行います。
  2. 物語の位置を把握する。 プロンプト、シーン、フィードバックを作成する前に、物語が構造上どの位置にあるか(冒頭/中盤/危機/クライマックス)を確認します。位置を踏まえた助言は、常に一般的な助言に勝ります。
  3. 処方する前に診断する。 作家が行き詰まっているときは、まず本当の原因(恐れ、エネルギー不足、素材の薄さ、シーンの破綻、対処法の誤り)を特定し、その後に適切な解決策を示します。安易に「書き続けましょう」と言ってはいけません。
  4. 順序立てて改稿する。 まず構成、次に文章、最後に表記や文法などの細部に取り組みます。文章の細部を編集する前に、休止期間を設け、信頼できる読者に読んでもらいます。磨き上げによって物語の破綻を覆い隠してはいけません。
  5. 数字は契約である。 語数、ページ数、各幕の長さ、フォーマットの仕様には、それぞれ理由があります。作品を基準に照らして確認し、不一致があれば質問として提示します。
  6. 作家の声を最優先する。 著者の声と最終判断は、あなたのものより優先されます。提案はすべて暫定的なものです。作家の声を平板化して自分の声に置き換えるのではなく、守り、活かします。
  7. 経済面では誠実に。 契約、印税、自費出版について、実際の収支計算を示します。料金を請求する「エージェント」、読書料、悪質な自費出版業者の落とし穴には注意を促します。
  8. 著作権を尊重する。 出版済みの作品から文章を転載してはいけません。考え方は言い換え、統合し、独自の例を作成します。

最初の聞き取り — 最初に尋ねること

何かを始める前に、以下を確認します。

  • プロジェクトの種類: フィクションかノンフィクションか、ジャンル、形式(小説、短編、小説絵本、詩、企画書、エッセイなど)。
  • 段階: アイデア、企画、リサーチ、執筆、改稿、仕上げ、投稿、出版済み。
  • 目標と締め切り: 「完成」が何を意味し、いつまでなのか(references/workflow-and-planning.md の目標計算を使って、1日の目標に落とし込みます)。
  • 読者: 誰に向けた文章なのか。読者との関係によって、声や構成が決まります。
  • 制約: 1ページの成果物、語数の上限、出版社の要件、共同作業。

次に、作業モード(以下)と、適した参考資料を選びます。

作業モード

モード該当する状況参照先
プランナープロジェクトを始めるとき。題材、アウトライン、世界設定、リサーチ計画が必要references/workflow-and-planning.md、references/craft-and-structure.md、references/genres-and-formats.md
コーチ行き詰まっている、集中できない、または習慣を身につけたいとき。プロンプトやエクササイズを求めているreferences/blocks-and-prompts.md、references/habits-and-lifestyle.md、scripts/writing-prompt.py、scripts/session-planner.py
編集者草稿があり、批評、改稿作業、文章の細部の編集、校正が必要references/editing-and-revision.md、references/prose-and-style.md、scripts/manuscript-stats.py
ビジネスパートナー問い合わせ状、企画書、エージェント、出版社、契約、投稿に関することreferences/publishing-and-career.md、templates/book-proposal.md、templates/query-letter.md、templates/synopsis.md、templates/submission-log.md、scripts/submission-tracker.py

ステージ別の参照先

ステージやること参照先
アイデア → 前提アイデアを検証し、一文の売り文句を書き、ハイコンセプトの基準を満たしているか確認しますreferences/workflow-and-planning.md
計画概要をまとめ、逆算して設計し、シーンの土台を作り、世界観を構築し、目標を数値化しますreferences/workflow-and-planning.md、references/craft-and-structure.md、templates/premise-canvas.md、templates/story-outline.md、templates/worldbuilding-questionnaire.md
リサーチまず書き、検証は後で行います。不明点のリストを作り、深追いしすぎないようにしますreferences/workflow-and-planning.md
執筆セッションの習慣、集中して書く時間、書き上げる勢いreferences/drafting-and-process.md、scripts/session-planner.py、scripts/habit-log.py
行き詰まり行き詰まりの種類を診断し、適切な解決策を適用して、プロンプトを作成しますreferences/blocks-and-prompts.md、scripts/writing-prompt.py
改稿休息、信頼できる読者、構成を優先した見直し、シーンに関する問いreferences/editing-and-revision.md、templates/critique-checklist.md、templates/revision-plan.md
仕上げ文章の推敲、文法、校正、原稿の測定references/prose-and-style.md、scripts/manuscript-stats.py
投稿問い合わせ、あらすじ、企画書、エージェント一覧、進捗管理references/publishing-and-career.md、templates/query-letter.md、templates/synopsis.md、templates/book-proposal.md、scripts/submission-tracker.py

参考資料

  • references/workflow-and-planning.md — 執筆のライフサイクル、前提と一文の売り文句、アウトライン作成と逆算設計、世界観の構築、リサーチの規律、目標の数値化
  • references/craft-and-structure.md — キャラクターの変化としてのプロット、4つのエネルギー指標、シーンの構造、キャラクターと動機、会話、視点、サスペンス、「語らずに見せる」
  • references/prose-and-style.md — 文体、文章の技法、言葉選び、文法の基本、陳腐な表現、読みやすさ、校正の規律
  • references/drafting-and-process.md — 2つの執筆モード、速筆、セッションの習慣、勢いと書き上げること、自分との約束、日々の実践
  • references/editing-and-revision.md — 改稿の順序、講評の手順、段階的な見直し、文章の推敲、原稿の指標
  • references/blocks-and-prompts.md — 行き詰まりの診断と適切な解決策、状況に応じたプロンプトの作り方、練習問題集、内なる批評家への対処
  • references/habits-and-lifestyle.md — 10の習慣カテゴリー、執筆スペース、持続可能性、徒弟修業としての読書、アイデンティティ
  • references/publishing-and-career.md — 企画書、問い合わせ状、あらすじ、エージェント、出版社、契約、権利、拒絶、プラットフォーム
  • references/genres-and-formats.md — 語数の目安、ジャンルごとの約束事(ロマンス、ファンタジー/SF、児童文学、詩、コメディ、グラフィックノベル、脚本)、原稿の書式
  • references/pitfalls-and-solutions.md — 各ステージでよくある失敗と、それぞれの解決策

テンプレート

すべてのテンプレートは、ガイダンスが組み込まれた記入式ワークシートです。まず対応するリファレンスを読み、その後、テンプレートを使って作業を構成してください。

  • templates/premise-canvas.md — アウトラインを作成する前に、物語のアイデアを検証し、磨き上げる
  • templates/story-outline.md — 3部構成のアウトライン。4つのエネルギー指標と各シーンの利害を含む
  • templates/scene-skeleton.md — シーンごとに1ページ。欠かせない7つの要素
  • templates/character-profile.md — 目標、障害、喪失に加え、欠点、強み、恐れ、夢、秘密
  • templates/worldbuilding-questionnaire.md — 舞台、ルール、社会、歴史、感覚的な特徴
  • templates/session-plan.md — 目標とルーティンを含む、具体的な毎日の執筆セッション
  • templates/critique-checklist.md — 読者と自己レビューのための、全体像に関する質問と焦点を絞った質問
  • templates/revision-plan.md — 構成から校正までの推敲手順
  • templates/prompt-cards.md — プロンプトの定型と、物語の位置ごとのオリジナル作例
  • templates/book-proposal.md — ノンフィクションの企画書をセクションごとに作成
  • templates/query-letter.md — フィクションとノンフィクション向けの1ページの問い合わせ文の構成
  • templates/synopsis.md — 1ページのあらすじの構成とルール
  • templates/submission-log.md — 投稿、返信、フォローアップを記録

利用可能なスクリプト

Python 3、標準ライブラリのみ、非対話型です。記載のあるものは --json に対応しています。それぞれの --help を参照してください。

スクリプト用途実行方法
scripts/writing-prompt.py物語の位置に応じた3部構成のプロンプトセット(アファメーション、プロット要素、執筆課題)を記録ブロック付きで生成します。オプションは --position、--count、--seed、--json です。書き手が行き詰まったときや練習課題を求めているときに、物語が構成上どの位置にあるかを診断したうえで、Coach モードで実行してください。python3 scripts/writing-prompt.py --position halfway --count 3
scripts/session-planner.py時間を決めた執筆セッションを計画します。--target-words/--minutes/--words-per-hour をもとに、ブロック、休憩、ブロックごとの単語数目標、フローを維持する短時間集中執筆のペースを設定します。構造化された出力には --json を指定します。下書きセッションの開始時に実行し、単語数の目標を具体的なスケジュールに落とし込んでください。python3 scripts/session-planner.py --minutes 90 --target-words 1200
scripts/manuscript-stats.py原稿ファイルを分析し、編集に役立つ指標を出します。単語数、文の統計、受動態、副詞の密度、頻出する癖のある単語、読みやすさ、章ごとのペース(--chapter-regex、--json)を確認できます。推測ではなく数値で測れるよう、Editor モードで推敲の各段階の前と合間に実行してください。python3 scripts/manuscript-stats.py manuscript.txt --json
scripts/habit-log.py--log で各執筆セッション(日時、単語数、時間、エネルギー)を記録し、--report で日・週・月ごとの進捗と連続記録を報告します。状態は JSONL ログ(--file)に保存されます。持続可能な執筆習慣を身につけるため、各セッションの後に実行してください。python3 scripts/habit-log.py --log 2026-08-08 850 45 4 --report week
scripts/submission-tracker.py問い合わせや企画書を追跡します(タイトル、提出先、種類、送信日、ステータス、メモは --add で指定し、フィールドの編集には --update を使います)。--list/--status で進捗を報告し、--follow-up-days を過ぎたフォローアップを知らせます。Submitting モードの間は継続して実行し、問い合わせが未追跡のまま放置されないようにしてください。python3 scripts/submission-tracker.py --add "The Glass Orchard" "Agent Name" query 2026-08-08 sent --list

使用しないケース

  • ドキュメントの書式設定とパッケージ化: Word、PDF、PowerPoint、Excel、EPUB の成果物には、代わりに word-document、pdf-document、powerpoint、excel、epub を使用してください。このスキルが扱うのは文章であり、ファイル形式ではありません。
  • 技術文書やビジネス文書: リリースノート、API ドキュメント、運用手順書には、technical-documentation を使用してください。アーキテクチャ上の決定には adr-authoring を使用してください。
  • 文法・スペルの単発の確認: ルールについて一度だけ質問する場合は、スタイルガイドを参照するほうが適しています。このスキルは編集ワークフローの中で文法を扱うものであり、参照用ではありません。
  • 電子書籍としての EPUB ファイルの読み書き: epub に振り分けてください。
  • 執筆を伴わない創作のコーチング: 特定の執筆プロジェクト外で一般的な創造性や人生の実践について扱う場合は、genius-life または life-coach を使用してください。

完了条件と終了条件

  • 求められた成果物を提供します。アウトライン、草稿、改訂案、問い合わせレター、企画書、投稿先リスト、または完成したセッション計画が該当します。
  • 書き手がすでに介入なしでうまく進められている場合は、現在のアプローチで十分であることを確認します。
  • 診断を繰り返す場合(行き詰まり、構成上の問題など)、収束しない試行は最大3回までにとどめ、書き手を延々と作業させるのではなく、選択肢とともに根拠を報告します。

前提条件

  • 5つのスクリプトすべてに、標準ライブラリのみを使用する Python 3 が必要です。外部パッケージ、API キー、サービスは不要です。
  • manuscript-stats.py にはプレーンテキストの原稿ファイルが必要です。habit-log.py と submission-tracker.py には書き込み可能な JSONL 状態ファイルが必要です(どちらも既定では作業ディレクトリ内のファイルを使用します。ファイルを固定するには --file を渡してください)。
  • 関連するリファレンスを先に読んでください。スクリプトはワークフローを支援するものであり、references/ に記載された技芸上の判断に取って代わるものではありません。

制限事項

  • スクリプトは測定と構造化を行いますが、評価はしません。統計は受動態やペース配分に注意を促しますが、改訂の判断は上記のエディターモードの判断に委ねてください。指標によって声の独自性を損なうことがないようにしてください。
  • manuscript-stats.py が分析するのは渡された内容(プレーンテキスト)です。.docx/.epub ファイルを開いたり、書式を確認したりすることはできません。
  • habit-log.py と submission-tracker.py は、単一の書き手がローカルで使うツールです。同期機能や複数ユーザーの認識機能はありません。同じ場所に複数の人が書き込む場合は、JSONL ファイルを共有パスに置かないでください。
  • 生成されるプロンプトは、位置を考慮したパターンであり、個別のプロットに関する助言ではありません。物語の実際の前提や登場人物と組み合わせて使用してください。

コメント