doc-coauthoring スキル
スキル Claude Code ドキュメント・コンテンツ作成Claude Code 拡張・ワークフロー以下の解説は生成 AI によるものです。出典と照らし合わせてご確認ください。
doc-coauthoringは、技術仕様書、決定文書、提案書、RFCなどの文書作成をユーザーと共同で進めるためのClaudeスキルです。SKILL.mdによると、ワークフローはコンテキスト収集、リファインメント＆構造化、リーダーテストという3段階で構成されています。コンテキスト収集では文書の種類や読者、目的について質問し、背景情報をまとめて受け取ります。リファインメント＆構造化ではセクションごとにブレインストーミングと取捨選択を行い、ドラフトを作成して反復的に編集します。リーダーテストでは事前情報を持たない新規のClaudeインスタンスやサブエージェントに文書を読ませ、読者にとって分かりにくい点や矛盾を検出します。
doc-coauthoring でできること
- 文書の種類・読者・目的・テンプレートに関する初期質問に答え、背景情報をまとめて提供する
- Slack、Teams、Google Drive、SharePointなど連携ツールがある場合、関連するチャンネルやドキュメントを取り込む
- セクションごとに質問への回答、候補の brainstorming（5〜20件程度）、取捨選択、ドラフト作成、str_replaceによる編集を繰り返して文書を組み立てる
- artifacts機能または作業ディレクトリ内のMarkdownファイルで骨組みを作成し、セクション見出しとプレースホルダーを配置する
- 文書がある程度仕上がった段階で、コンテキストを持たない新規のClaudeやサブエージェントに読ませ、想定される読者の質問への回答や曖昧さ・前提知識・矛盾点を確認する（Reader Testing）
- Reader Testingの結果を踏まえて該当セクションのリファインメントに戻り、問題を修正する
- 完成前に、事実・リンク・技術的詳細の最終確認と、意図した効果が得られているかの検証をユーザー自身が行うようSKILL.mdは推奨している
出典
原文の説明（英語）
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.