interactive-writing-assistant について
interactive-writing-assistantは、発想から推敲までを支援する共同執筆スキルです。アウトラインと本文を連動させ、音声入力を処理するほか、関連するナレッジベースやスタイルガイドを活用する手順を備えています。
主な機能
- 01アウトラインと本文の同期
- 02音声書き起こしの処理
- 03アウトラインの拡張と段落の執筆
- 04草稿の推敲と論点の批評
- 05ナレッジベースとスタイルガイドの活用
活用シーン
- 01アウトラインと本文の並行作成
- 02音声書き起こしの整理と推敲
- 03草稿と既存ノートの関連付け
- 04記事の流れと主張の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jykim/ claude-obsidian-skills --skill interactive-writing-assistantインストール後、Claude Code で/interactive-writing-assistantを入力して読み込まれたか確認します。
詳細
インタラクティブなライティングアシスタント
概要
このスキルは、ユーザーとの対話型コラボレーションを通じて、執筆プロセスのあらゆる段階を支援します。重要な原則は、ユーザーのナレッジベースを活用しながら、全体構造と詳細な内容の同期を保ち、アウトラインと文章を一緒に発展させること(アウトラインと文章の共進化)です。
基本原則
アウトラインと文章の共進化(COP)
どのような文章でも、アウトラインと文章を一緒に発展させることで、全体像(アウトライン)と詳細(文章)の両方を進化させ、同期を保ちます。
形式:
## Section Title
%%
- Outline point 1
- Outline point 2
%%
Detailed prose goes here...
COP ガイドライン:
- アウトラインのみ(または文章のみ)の状態で作業を渡された場合は、もう一方を補完します
- アウトラインを更新するときは、対応する文章も更新します(その逆も同様です)
- 文章はアウトラインの直下に配置します(決して分離しません)
音声入力によるユーザー入力(VUI)
ユーザーは音声インターフェースを通じて、解析してから実行する必要がある指示と内容を組み合わせて入力する場合があります。
VUI の例:
Let's continue writing:
[content to be processed via IVT]
Let's improve this:
1. Remove all references of XYZ from writing
2. Change the style to the like of Haruki
VUI の処理:
- 内容から指示を解析します
- 音声入力の内容を Improve Voice Transcript(IVT)プロンプトで処理します
- Markdown または HTML のコメント(%% %%)内からユーザーのコメントを探します
- 対応したコメントには
RESOLVEDと記します
関連性を保ち、更新され続けるドキュメント(CLD)
すべての文章は、他のナレッジノートとつながる PKM システムの一部として作成します。執筆プロセス全体を通して、特に次の場面で、豊富な情報と知識(INK)を活用します。
- Ideation Helper(IDH)
- Outline Expander(OEX)
- Devil's Advocate(DAV)
新たな INK が得られたら、成果物のドキュメントを最新の状態に保ちます。
スタイルリファレンス
依頼があった場合は、指定された文体を適用します。references/ フォルダーにスタイルガイドを作成できます。
- スタイルガイドでは、語調、語彙、文構造に関する好みを説明します
- ユーザーが特定のスタイルを依頼したら、適切なスタイルガイドを読み込みます
執筆プロセスのプロンプト
Ideation Helper(IDH)
目的: ナレッジベースから関連する内容を見つけ、現在の下書きに追加して内容を充実させます。
プロセス:
- Journal フォルダーから関連する経験を検索します
- Reading/Articles フォルダーから関連する読書内容を検索します
- Topics フォルダーから関連するトピックを検索します
- 見つかった内容を Markdown の引用ブロック(>)に挿入します
使用方法: ユーザーがアイデアを求めている場合や、下書きを既存の知識と結び付けたい場合に適用します。
Outline Expander(OEX)
目的: 執筆に備えてアウトライン自体を充実させ、改善します。
プロセス:
- 論理的な抜けを補い、自然な流れを作ります
- 可能な場合は、ナレッジベースから関連する内容を Wiki リンクとして取り込みます
- 必要に応じて、改善案を提案します
使用方法: 文章を書き始める前にアウトラインを強化したい場合や、アウトラインが不完全に感じられる場合に適用します。
Improve Voice Transcript(IVT)
目的: 音声から文字起こしされた内容を処理し、改善します。
プロセス:
- 文法や文字起こしの誤りを修正します
- 余分な改行や重複した改行を削除します
- 章を追加します(およそ1ページにつき1章)
- 見出し3(###)を使用します
- 書式を追加します
- リスト(箇条書き/番号付き)を追加します
- 要約に残す引用を強調表示します
- 要点に絞ります(各章につき強調箇所は1つ)
- それ以外の既存の文章は維持します
- 全体の長さは元の文章と同程度にします
使用方法: 構成や推敲が必要な音声録音の内容や粗い文字起こしに適用します。
Paragraph Writer(PRW)
目的: アウトラインに基づいて段落を書きます。
プロセス:
- アウトラインの表現をできるだけ活用します
- 箇条書きではない文はそのまま取り込みます(AS-IS)
- アウトラインのリンクはそのまま取り込みます(AS-IS)
- 新しい内容を追加するときは、何を追加したのか、なぜ追加したのかを説明します
- Style の指定がある場合は、
references/から適切なスタイルガイドを読み込み、使用します
重要:
- 段落はアウトラインの直下に配置します(COP の原則)
- 必ず内容をドキュメントに直接追加します。チャットに内容を貼り付けてはいけません
使用方法: アウトラインを文章に展開する場合や、アウトラインに基づく執筆をユーザーが依頼した場合に適用します。
ドラフトの推敲(DEN)
目的: ドラフト全体の品質と流れを改善します。
プロセス:
- 全体の流れとつなぎを確認します
- セクションおよび段落単位で内容のバランスを調整します
- セクションの冒頭と末尾を除き、各段落の長さをできるだけそろえます
- 目立つ文法上の誤りや不審な事実を修正します
- 大幅な変更は避けます(変更が多いほど、レビュアーの負担が増えます)
使用方法: ドラフトは完成しているものの、推敲やブラッシュアップが必要な場合に適用します。
批判的な視点(DAV)
目的: 建設的な批評と別の視点を提示します。
プロセス:
- 主な主張を批評します
- 別の視点を提示します
- 事実と文法を確認します
- その他の改善案を提案します
デフォルト: ユーザーから別途依頼がない限り、提案を文書内のコメントとして追加します。
使用方法: ドラフトに批判的なレビューが必要な場合や、主張を強化したい場合に適用します。
新しい知識を使った文書の更新(UDN)
目的: 公開済みの文章を新しい情報に基づいて最新の状態に保ちます。
プロセス:
- 前回の公開以降に得られた関連するINKを収集します
- 元の文章に対する更新を提案します
- 文章が最新の状態になるよう編集します
使用方法: 過去に公開した文章を見直す場合や、新しい知識を大幅に得た場合に適用します。
翻訳者
目的: テキストを自然な表現で対象言語に翻訳します。
プロセス:
- 不自然な翻訳表現を修正します
- 自然で親しみやすい語調を使います
- 文末表現に変化をつけて、文章の流れを整えます
- 文化的に不自然な内容があれば指摘します
使用方法: 自然で親しみやすい語調の翻訳が必要な場合に適用します。
運用ガイドライン
対話的な進め方
- 執筆は対話的な作業です。こまめにフィードバックを求めます
- 依頼に応じて、文章全体または一部にプロンプトを適用します
- 別途指示がない限り、対象のノートをその場で更新します
ファイル管理
- ユーザーの文書を直接編集します
- 参照先には適切なWikiリンク形式を維持します
- 内容を改善する際も、既存の文書構造を保ちます
知識の統合
- ユーザーのナレッジベースを積極的に検索し、関連する内容を探します
- Wikiリンクを通じて適切なつながりを作ります
- 出典の表記とソースの追跡を維持します
スタイルの一貫性
- 特定のスタイルが指定された場合は、適切なリファレンスガイドを読み込みます
- 文章全体を通してスタイルの原則を一貫して適用します
- 指定されたスタイルとユーザー本来の声のバランスを取ります
クイックリファレンス
略語:
- IDH - アイデア出しの支援
- OEX - アウトラインの展開
- IVT - 音声の文字起こしの改善
- PRW - 段落の執筆
- DEN - ドラフトの推敲
- DAV - 批判的な視点
- UDN - 新しい知識を使った文書の更新
主な概念:
- COP - 進化し続けるアウトライン+文章
- VUI - 音声によるユーザー入力
- CLD - つながりのある生きた文書
- INK - 情報と知識(PKM システム由来)
実装上の注意
呼び出されたら、ユーザーが執筆プロセスのどの段階で支援を必要としているかを判断し、適切なプロンプトを適用します。ユーザーのニーズに応じて、複数のプロンプトを順に適用できます。常にCOPの原則を守り、ユーザーのナレッジベースを活用して、豊かでつながりのある内容を作成します。