documentation-generator について
documentation-generator は、ソースコードをもとに技術文書をローカルで作成・更新するツールです。API 文書の保守や、新メンバー向けのアーキテクチャ概要作成に使えます。
主な機能
- 01ソースコードから技術文書を生成
- 02API 文書の更新
- 03アーキテクチャ図と概要の作成
- 04ソースコードを外部に送らずローカルで実行
活用シーン
- 01機能開発後の API 文書更新
- 02新メンバー向けのアーキテクチャ概要作成
- 03プロジェクトの技術文書の保守
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jorgealves/ agent_skills --skill documentation-generatorインストール後、Claude Code で/documentation-generatorを入力して読み込まれたか確認します。
同梱ファイルskill.yaml
詳細
ドキュメント生成ツール
目的と意図
documentation-generator は、ソースコードから技術ドキュメントを自動的に作成・更新することで、ソフトウェアプロジェクトの保守性を維持します。
使用するタイミング
- 開発後:機能の実装が完了した後に実行し、API ドキュメントを最新の状態に保ちます。
- オンボーディング:新しいチームメンバー向けに、アーキテクチャ図や概要を生成するために使用します。
使用しないタイミング
- 上位レベルの戦略:このツールは技術ドキュメントを生成するものであり、「ビジネス要件」や「製品ビジョン」のドキュメントは作成できません。
セキュリティとデータの取り扱いに関する考慮事項
- ローカルで動作し、ソースコードを外部サーバーにアップロードしません。
コメント
Markdown 対応