doc-coauthoring
構造化された AI ガイダンスによるドキュメンテーションの共同作成
こちらからも入手できます: 7Spade,anthropics,Azeem-2,ZhanlinCui,davila7,7Spade,AstraBit-CPT
質の高いドキュメンテーションを作成するには、反復と新鮮な視点が必要です。このスキルは、漠然としたアイデアを明確で読者にテストされたドキュメントに変換する、実証済みの 3 ステージのワークフローを提供します。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「doc-coauthoring」を使用しています。 ユーザーが新しいキャッシングレイヤーの設計ドキュメントを作成したい
期待される結果:
構造化されたワークフローは、キャッシングの問題、オーディエンス、制約に関するコンテキスト質問から始まります。情報の放出と明確化質問の後、ドキュメントはセクションごとに（問題文、検討された代替案、提案されたアプローチ、実装計画）反復的な洗練を伴って構築されます。リーディングテストにより、チームレビュー前に重要な質問をドキュメントが捕捉していることが検証されます。
「doc-coauthoring」を使用しています。 ユーザーに不完全に感じるドラフト RFC がある
期待される結果:
このワークフローは、標的を絞った質問を通じてギャップを特定し、各セクションの欠落している検討事項をブレインストーミングし、洗練された RFC を生成します。新しい Claude インスタンスによるリーディングテストにより、最終公開前に解決される曖昧さが浮かび上がります。
セキュリティ監査
安全All static analysis findings are false positives. The 'external_commands' references are Claude Code tool calls (create_file, str_replace), not shell execution. The 'network' reference is documentation text directing users to claude.ai, not actual network calls. Cryptographic and reconnaissance patterns are text matches in documentation context only. This is a pure instructional skill with no executable security risks.
品質スコア
作れるもの
技術仕様書の作成
技術仕様書を作成するエンジニアは、このワークフローを使用して、要件を体系的に記録し、代替案を検討し、実装に関する質問を予測した読者対応のドキュメントを作成できます。
設計決定のドキュメンテーション
アーキテクチャ上の決定をドキュメント化するチームは、コンテキストを記録し、トレードオフを検討し、リーディングテストを通じて明確性を検証する構造化されたアプローチから恩恵を受けます。
プロダクト要件と提案書
プロダクトチームは、コンテキスト収集、洗練、テストの段階に従うことで、大まかなアイデアを洗練された PRD に変換し、ステークホルダー対応の出力を確保できます。
これらのプロンプトを試す
新機能の技術仕様書を作成する必要があります。ドキュメンテーション共著ワークフローを通じてガイドしてください。
改善が必要な既存の設計ドキュメントがあります。共著ワークフローを使用して、セクションごとに洗練しましょう。
ドキュメントはほぼ完成しています。チームと共有する前にギャップを見つけるために、リーディングテストステージを行いましょう。
ゼロから提案書を作成する必要があります。コンテキスト収集、洗細と構造、リーディングテストの 3 つのステージすべてを通じてガイドしてください。
ベストプラクティス
- 3 つのステージをすべて完了する - 各ステージが異なるタイプの問題を発見する
- 後続のステージでより良いガイダンスを可能にするために、ステージ 1 で徹底的なコンテキストを提供する
- 既存のコンテンツを擁護するのではなく、リーディングテストのフィードバックを使用して真のギャップを特定する
回避
- コンテキスト収集をスキップしてすぐにドラフト作成に移ると、不完全なドキュメントになる
- 外科的なセクション別リファインメントではなく、広範な書き直しを行う
- 著者には自明に見えるという理由で、リーディングテストのフィードバックを無視する