# Doc Coauthoring

> Guide users through a structured workflow for co-authoring documentation. Triggers: 「ドキュメントを書いて」「仕様書を作成」「READMEを更新」「提案書を作って」「PRD」「設計ドキュメント」 Use when: Writing documentation, proposals, technical specs, decision docs, or similar structured content. Workflow: Context Gathering → Refinement & Structure → Reader Testing

- Skill: `majiayu000/doc-coauthoring-5` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/doc-coauthoring-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/doc-coauthoring-5/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/doc-coauthoring-5

---


# Doc Co-Authoring Workflow

構造化されたドキュメント共同作成ワークフロー。3つのステージを通じてユーザーをガイドする。

## Stage 1: Context Gathering
（ステージ1：コンテキスト収集）

**目標**: ユーザーの知識とエージェントの知識のギャップを埋める。

### 初期質問

1. ドキュメントの種類は？（技術仕様、提案書、決定文書等）
2. 主な読者は？
3. 読者に期待する反応は？
4. テンプレートや特定のフォーマットはある？
5. その他の制約やコンテキストは？

### 情報収集

- プロジェクト/問題の背景
- 関連するチーム議論やドキュメント
- 代替案が採用されない理由
- タイムライン制約
- 技術アーキテクチャや依存関係

### 終了条件

エッジケースやトレードオフについて質問できるようになったら、次のステージへ。

## Stage 2: Refinement & Structure
（ステージ2：構造化と改善）

**目標**: セクションごとにブレインストーミング・キュレーション・反復的改善で構築。

### 各セクションの作業フロー

1. **Clarifying Questions**: セクションに含める内容について5-10の質問
2. **Brainstorming**: 5-20のアイデアを生成
3. **Curation**: ユーザーが保持/削除/結合を判断
4. **Gap Check**: 不足している重要な情報がないか確認
5. **Drafting**: セクションを起草
6. **Iterative Refinement**: フィードバックに基づく改善

### 品質チェック（80%完了時）

- セクション間の流れと一貫性
- 冗長性や矛盾
- 「スロップ」がないか（英語の "slop"：汎用的な埋め文・内容のない定型表現）
- 全ての文が意味を持つか

## Stage 3: Reader Testing
（ステージ3：読者視点でのテスト）

**目標**: 新鮮な視点でドキュメントをテストし、盲点を発見する。

1. **Reader Questions**: 読者が質問しそうな5-10の質問を予測
2. **Testing**: 予測した質問をドキュメントに対してチェック
3. **Additional Checks**: 曖昧さ、前提知識、矛盾を確認
4. **Fix**: 見つかった問題を修正し、Stage 2に戻る

### 最終レビュー

Reader Testingが通ったら:
1. ユーザー自身の最終読み通しを推奨
2. 事実、リンク、技術詳細のダブルチェック
3. 望んだインパクトが達成されているか確認

## Resources

- `resources/implementation-playbook.md` - 詳細なワークフロー手順、サブエージェント活用、アーティファクト管理方針