ドキュメント共同執筆スキル

ドキュメント共同執筆スキルは、Claude Codeと協力してドキュメントを作成するための構造化された3段階のワークフローを提供します。技術仕様、提案、意思決定ドキュメント、チームドキュメントのいずれを作成する場合でも、このスキルはコンテキストの収集、反復的な改善、読者の検証を通じてガイドします。

主な機能

このスキルはドキュメント作成を体系的なプロセスに変換します:

• 3段階ワークフロー: コンテキスト収集 → 改善と構造化 → 読者テスト
• アクティブなガイダンス: Claudeは単なる命令実行者ではなく、積極的な共同執筆者として機能
• コンテキスト効率: 執筆開始前の構造化された情報収集
• 反復的改善: 明確なフィードバックによる複数の修正サイクル
• 読者検証: 実際のターゲット読者でドキュメントをテスト
• ドキュメントタイプ非依存: 仕様、提案、RFC、PRDなどに対応
• コラボレーション設計: 効率的な人間とAIのパートナーシップ用に最適化

使用シナリオ

このスキルを使用すべき人は?

• プロダクトマネージャー: PRD、製品仕様、ロードマップドキュメントの作成
• エンジニアリングチーム: 技術設計ドキュメント、RFC、アーキテクチャ決定の作成
• テクニカルライター: ユーザードキュメントとAPIリファレンスの開発
• プロジェクトマネージャー: プロジェクト計画とステークホルダー更新の作成
• ビジネスアナリスト: 要件仕様とプロセスドキュメントの作成
• チームリーダー: 意思決定ドキュメントと戦略計画の作成

解決する問題

1. コンテキスト転送のオーバーヘッド: 必要なすべての背景情報を効率的に収集
2. 構造的曖昧さ: 各ユースケースの最適なドキュメント構造をガイド
3. 反復の非効率性: 修正サイクルの明確なフレームワークを提供
4. 読者の乖離: ドキュメントが実際のターゲットオーディエンスに機能することを検証
5. ライターズブロック: 構造化されたワークフローが空白ページの麻痺を解消

3段階ワークフロー

ステージ1: コンテキスト収集

目標: すべての関連知識を頭からClaudeのコンテキストに転送。

プロセス:

• 背景、制約、目標、要件を提供
• Claudeがギャップを埋めるための明確化質問を行う
• 情報が体系的に整理される
• まだ執筆は行われない—純粋なコンテキスト構築

ステージ2: 改善と構造化

目標: 反復的改善を通じて構造化されたドキュメントを作成。

プロセス:

• Claudeが収集されたコンテキストに基づいて初稿を生成
• レビューして具体的なフィードバックを提供
• 複数の修正サイクルでコンテンツを改善
• 目的に最適に貢献するよう構造が進化

ステージ3: 読者テスト

目標: ドキュメントが意図したオーディエンスに機能することを検証。

プロセス:

• 代表的な読者を特定(同僚、ステークホルダー)
• 読者とドラフトを共有してフィードバックを収集
• 明確さと完全性に関する構造化フィードバックを収集
• 実際の読者体験に基づいて改善

サポートされるドキュメントタイプ

• 技術ドキュメント(設計ドキュメント、RFC、技術仕様)
• 製品ドキュメント(PRD、提案)
• プロセスドキュメント(意思決定ドキュメント、標準操作手順)

ベストプラクティス

1. コンテキストを前倒し: ステージ1に時間を投資—後で報われる
2. 反復を受け入れる: 初稿は最終版ではない;修正を計画
3. 早期テスト: 文章を磨く前に構造についての読者フィードバックを取得
4. 具体的に: 「技術的すぎる」は曖昧;「セクション3はXの知識を前提」は実行可能
5. バージョン管理: ドキュメントの進化を追跡するために主要な修正をコミット

Claude Codeとの統合

このスキルはClaude Codeワークフローにシームレスに統合:

• 自動トリガー: ドキュメント作成キーワードに言及
• ガイド付きプロセス: Claudeが各ステージを明示的にガイド
• 状態追跡: Claudeが現在のステージを記憶
• ファイル管理: ドキュメントファイルを生成・更新
• バージョン管理: 変更追跡のためにgitと自然に連携

よくある質問

プロセス全体にどのくらいかかりますか?

コンテキスト収集:10-20分。初稿:即座。改善:2-5回の反復。読者テスト:可用性による。合計:完全なドキュメントは通常1-3時間。

ステージをスキップできますか?

はい、ただし推奨されません。各ステージには目的があります。コンテキスト収集をスキップすると初稿が粗末になります。読者テストをスキップするとコミュニケーションミスのリスクがあります。

利用可能性

すべてのClaude Codeユーザーが利用可能:

• Claude Pro
• Claude Max
• Claude Team
• Claude Enterprise

まとめ

ドキュメント共同執筆スキルは、ドキュメント作成を恐ろしいタスクから構造化された管理可能なワークフローに変換します。コンテキスト収集、執筆、検証を別々のフェーズに分離することで、より短い時間でより良いドキュメントを作成できます。3段階プロセスは、ドキュメントがその意図した目的に貢献し、ターゲットオーディエンスと効果的にコミュニケーションすることを保証します。

出典:

• Anthropic Skillsリポジトリ
• Slack - ワークフロードキュメントのベストプラクティス