1仕組みと動作原理
謳われている「ガイド付き共同作成」はコードに一切依存せず、純粋なプロンプトのオーケストレーションに基づきます。モデルが能動的なガイドとして3段階の対話プロトコル（Context Gathering / Refinement & Structure / Reader Testing）に沿ってユーザーを牽引し、機能はすべて構造化された対話指示のみで実現されています。
doc-coauthoring/SKILL.md:L8
This skill provides a structured workflow for guiding users through collaborative document creation. Act as an active guide, walking users through three stages: Context Gathering, Refinement & Structure, and Reader Testing.
スキル全体で SKILL.md 1ファイルのみ（`git ls-files doc-coauthoring/` はこのファイルのみを返す）で構成され、スクリプトや参照、テンプレートはありません。「なぜ実現できるのか」：外部ツールチェーンに頼るのではなく、ドキュメントの共同作成を実行可能な対話プロトコルとしてコード化したためです。
Stage 1 ではまず「ユーザーの脳内知識」を対話コンテキストに取り込みます。5つのメタ質問＋自由な書き出しの推奨＋情報のギャップに基づく5〜10件の明確化質問の生成を行い、判定可能な終了条件を用いて早すぎる執筆開始を防ぎます。
doc-coauthoring/SKILL.md:L30
**Goal:** Close the gap between what the user knows and what Claude knows, enabling smart guidance later.
補足エビデンス：L34-40 の5つのメタ質問；L92-94「Generate 5-10 numbered questions based on gaps in the context.」；L97「Sufficient context has been gathered when questions show understanding - when edge cases and trade-offs can be asked about without needing basics explained.」——終了条件によって「十分な理解」を操作可能にしており、これが後続の各セクションで急所を突く5〜10件の質問を投げかけるための前提条件となります。
Stage 2 ではドラフト作成をセクションごとの固定6ステップ（明確化→5〜20項目のブレインストーミング→番号キュレーション→ギャップ確認→ドラフト作成→反復）に細分化し、「番号による選択・取捨選択」プロトコルを用いてユーザーの曖昧なフィードバックを実行可能な指示に変換します。
doc-coauthoring/SKILL.md:L168
Generate 5-20 numbered options based on section complexity. At the end, offer to brainstorm more if they want additional options.
補足エビデンス：L175-179 キュレーションの例「Keep 1,4,7,9」「Combine 11 and 12」；L183-184 gap check。番号付けプロトコルにより、モデルはユーザーのフィードバックを安定して処理し、「何を残すべきか」という優先度を自然に学習できます。
ドラフト作成と反復は一貫してホストの編集ツール（`create_file` によるアーティファクト骨格の作成 / `str_replace` によるピンポイント編集）を経由し、意図的に「never reprint the whole doc」を維持して、長文ドキュメントの全量再出力の繰り返しによる内容の乖離を防ぎます。
doc-coauthoring/SKILL.md:L208
- Use `str_replace` to make edits (never reprint the whole doc)
補足エビデンス：L135「Use `create_file` to create an artifact. This gives both Claude and the user a scaffold to work from.」；L148（アーティファクト非対応ホストの場合）「Create file with all section headers and placeholder text.」。スキルはホストの機能に応じて自動的にルーティングし、アーティファクトがある場合は `create_file` ＋ 編集ごとのリンク提示、ない場合はローカルの Markdown ファイルへ保存します。
Stage 3 の Reader Testing は本スキルの最もユニークなメカニズムです。「コンテキストを持たない新規の Claude サブエージェント」を用いて実読者をシミュレートし、ドキュメントが著者の文脈から切り離されても自立しているかを検証します。つまり「読者視点」を自動実行可能なチェックへと変換します。
doc-coauthoring/SKILL.md:L244
**Goal:** Test the document with a fresh Claude (no context bleed) to verify it works for readers.
補足エビデンス：L265「For each question, invoke a sub-agent with just the document content and the question.」；L273 サブエージェントが曖昧さ／誤った前提／矛盾を再確認；失敗した場合は「Loop back to refinement for any problematic sections.」（L325）。サブエージェントがない環境（claude.ai web）では、ユーザー向けの手動テスト案内（https://claude.ai で新規チャットを開きドキュメントを貼り付け、L303-304）にフォールバックします。
全編にわたりユーザーの主体性が維持されます。開始時の拒否、途中でのスキップ、いつでも自由形式への切り替えが可能であり、プロセスはガイドするのみで強制せず、「ユーザーがドキュメントを所有する」という境界が明確に保たれます。
doc-coauthoring/SKILL.md:L26
If user declines, work freeform. If user accepts, proceed to Stage 1.
補足エビデンス：L358「If user wants to skip a stage: Ask if they want to skip this and write freeform」；L360「Always give user agency to adjust the process」；L338 仕上げ段階では、ユーザー自身が最終確認を行い責任を持つこと（they own this document and are responsible for its quality）が求められます。
2コア機能
01ドキュメント作成タスクのトリガー検出＋3段階プロセスの能動的提案（自由形式へのオプトアウトパスを含む）
02Stage 1 コンテキスト収集：5つのメタ質問 → 自由な情報書き出し → ギャップに応じた5〜10件の明確化質問（簡潔な回答に対応）
03ドキュメントの足場生成：アーティファクト対応時は `create_file`、非対応時はワークスペースにプレースホルダー Markdown（decision-doc.md / technical-spec.md など）を作成
04セクション別6ステップ共同作成プロトコル：明確化質問 → 5〜20項目のブレインストーミング → 番号キュレーション → ギャップ確認 → `str_replace` によるドラフト作成 → 反復
05スタイル学習ループ：直接編集するのではなくユーザーに「修正箇所を指摘」させ、モデルがその好みを学習して以降のセクションに反映
06収束品質ゲート：実質的な修正なしで3往復経過した際に削減可能か確認。80%以上完成した時点で全体の流れ／冗長性／矛盾／質の低い表現（slop）を総点検
07Reader Testing のデュアルパス：Claude Code ではサブエージェントによる自動テスト／claude.ai web では手動テスト用スクリプトを提示。問題のあるセクションは推敲へ差し戻し
08仕上げと事後処理：著者による最終確認と責任、付録への共同作成チャットリンクの追加、実際の読者からのフィードバックに基づく継続的更新
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| api | create_file（宿主内建 artifact 工具，非外部 API） |
| api | str_replace（宿主内建编辑工具，非外部 API） |
| api | sub-agents（Claude Code 运行时能力，非外部 API；skill 未指定具体 task 工具名） |
| api | 集成连接器 Slack/Teams/Google Drive/SharePoint/MCP 服务器 —— 条件性：仅在『If integrations are available』时提及，由宿主提供、无绑定端点 |
| network | claude.ai —— 仅作为用户手动 Reader Testing 的文字入口（用户自行打开新会话，skill/agent 不发起网络调用） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠（ファイルパスと抜粋）
- 本地工作目录: ファイル読み書きおよびアーティファクト出力: 共同作成中のドキュメントに対して `str_replace` による編集を実行 —— SKILL.md L188/L208
監査ノート： 純粋な指示のみで、スクリプト実行、外部ネットワーク送信、クレデンシャル読み取りは一切ありません。ただし、スキルはホストに対してローカルファイルへの書き込み（L148 骨格ファイルの作成、L188/L208 ユーザーのドキュメントに対する `str_replace` 編集）を明確に指示しています。リスク評価基準「ローカル読み書きのみ、外部ネットワーク送信なし、クレデンシャルなし」に基づき、🔵 青区分（通知・認知で十分）に該当します。書き込み対象は常にユーザーが対話を通じて段階的に確認した共同作成ドキュメント本体であり、隠蔽された挙動はありません。
5二重目の独立検証
- [ok] 目录内仅 SKILL.md、无脚本/引用/模板等资源 — git ls-files doc-coauthoring/ 只返回 doc-coauthoring/SKILL.md
- [ok] description 引用逐字一致 — L3 原文与 meta.official_desc 完全一致
- [ok] create_file / str_replace 调用点真实存在 — L135、L188、L208、L367-368 均实存，且 L367-368 收尾 Tips 再次强调同一工具对
- [ok] claude.ai 网络提及 — 全文件唯一 http(s) 命中为 L303；L72/L290 仅文字提及 Claude.ai 产品名，无调用语义
- [ok] Slack/Teams/Google Drive/SharePoint/MCP 集成语 — L70 实存且为条件式（If integrations are available），属宿主能力提示而非 skill 自带 API
- [ok] sub-agent Reader Testing 机制 — L251-253（无需用户参与的自动路径）、L265、L273 实存，L290 起手动路径对照完整
- [ok] 无凭证读取 — grep api key/token/secret/password/credential/env/export/keychain 全文件零命中
- [ok] 无脚本执行面 — grep bash/python/subprocess/curl/wget/exec( 全文件零命中；SKILL.md 内无代码块
6結論
最適な用途： 手元にすでに素材があり、PRD、設計ドキュメント、意思決定ログ、RFCなどを「著者の文脈を離れても自立しており、同僚や Claude が二次利用できる」構造化ドキュメントに仕上げたい方に適しています。Claude Code（サブエージェントとアーティファクトが利用可能）環境で最大の価値を発揮し、Reader Testing が完全自動化されます。複数ターンの問答や取捨選択の手間を惜しまない執筆者に最適です。
不向きな用途： 1回のプロンプトで即座にドラフトや単なるテンプレート・例文が欲しい方。問答・キュレーション・反復のサイクルに付き合う時間や忍耐がない方。ドキュメントの内容が極めて機密であり、現在の対話から全文を外部（サブエージェントへの引き渡しや claude.ai への貼り付け）に出したくないシナリオ。
Install Agent-Ready
① Verified Mirror 2026-09-06
Option A · Direct DownloadDownload doc-coauthoring.tar.gz
sha256:
Option B · Copy Guide for Agent930944490c8451b9…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 41bbe19d1a.