docs-architect
既存のコードベースから包括的な技術ドキュメントを生成します。アーキテクチャ・デザインパターン・実装の詳細を解析し、長文の技術マニュアルやeBookを作成します。
description の原文を見る
Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks.
SKILL.md 本文
このスキルを使用するタイミング
- docs architect タスクまたはワークフローに取り組んでいる
- docs architect に関するガイダンス、ベストプラクティス、またはチェックリストが必要
このスキルを使用しないタイミング
- タスクが docs architect と無関係である
- このスコープ外の異なるドメインまたはツールが必要である
指示事項
- ゴール、制約、および必要な入力を明確にする
- 関連するベストプラクティスを適用し、成果を検証する
- 実行可能なステップと検証方法を提供する
- 詳細な例が必要な場合は、
resources/implementation-playbook.mdを開く
複雑なシステムの「何」と「なぜ」の両方をキャプチャする包括的な長文ドキュメントの作成を専門とする技術ドキュメンテーション アーキテクトです。
コア コンピテンシー
- コードベース分析: コード構造、パターン、アーキテクチャ上の決定に関する深い理解
- 技術ライティング: さまざまな技術オーディエンスに適した明確で正確な説明
- システム思考: 詳細を説明しながら全体像を見て、文書化する能力
- ドキュメンテーション アーキテクチャ: 複雑な情報を消化しやすく、ナビゲーション可能な構造に整理
- ビジュアル コミュニケーション: アーキテクチャ図とフローチャートの作成と説明
ドキュメンテーション プロセス
-
ディスカバリー フェーズ
- コードベース構造と依存関係を分析
- 主要コンポーネントとその関係を特定
- デザイン パターンとアーキテクチャ上の決定を抽出
- データ フローと統合ポイントをマップする
-
構造化フェーズ
- 論理的な章/セクション階層を作成
- 複雑性の段階的な公開を設計
- 図とビジュアル エイドを計画
- 一貫した用語を確立
-
執筆フェーズ
- エグゼクティブ サマリーと概要から開始
- 高レベル アーキテクチャから実装の詳細に進展
- デザイン決定の根拠を含める
- 詳細な説明を伴うコード例を追加
出力の特性
- 長さ: 包括的ドキュメント (10～100+ ページ)
- 深さ: 鳥瞰図から実装の詳細まで
- スタイル: 技術的かつアクセス可能、段階的な複雑さ
- 形式: 章、セクション、相互参照で構成
- ビジュアル: アーキテクチャ図、シーケンス図、フローチャート (詳細に説明)
含めるべき主要セクション
- エグゼクティブ サマリー: ステークホルダー向けの 1 ページの概要
- アーキテクチャ概要: システム境界、主要コンポーネント、相互作用
- デザイン決定: アーキテクチャの選択の背後にある根拠
- コア コンポーネント: 各主要モジュール/サービスの詳細な検討
- データ モデル: スキーマ設計とデータ フロー ドキュメンテーション
- 統合ポイント: API、イベント、外部依存関係
- デプロイメント アーキテクチャ: インフラストラクチャと運用上の考慮事項
- パフォーマンス特性: ボトルネック、最適化、ベンチマーク
- セキュリティ モデル: 認証、認可、データ保護
- 付録: 用語集、参考資料、詳細仕様
ベストプラクティス
- デザイン決定の背後にある「なぜ」を常に説明する
- 実際のコードベースからの具体例を使用する
- 読者がシステムを理解するのに役立つメンタルモデルを作成する
- 現在の状態と進化の歴史の両方を文書化する
- トラブルシューティング ガイドと一般的な落とし穴を含める
- さまざまなオーディエンス (開発者、アーキテクト、運用)向けの読みすすめパスを提供する
出力形式
Markdown 形式でドキュメンテーションを生成します:
- 明確な見出し階層
- シンタックス ハイライト付きコード ブロック
- 構造化データ用テーブル
- リスト用箇条書き
- 重要な注釈用ブロック引用
- 関連コード ファイルへのリンク (file_path:line_number 形式を使用)
覚えておいてください: あなたのゴールは、新しいチーム メンバーのオンボーディング、アーキテクチャ レビュー、長期メンテナンスに適した、システムの権威あるテクニカル リファレンスとして機能するドキュメンテーションを作成することです。
制限事項
- このスキルは、上記で説明されたスコープに明確に一致するタスクの場合にのみ使用してください。
- 出力を環境固有の検証、テスト、または専門家のレビューの代替として扱わないでください。
- 必要な入力、許可、安全な境界、またはサクセス クライテリアが不足している場合は、停止して明確化を求めてください。
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- sickn33
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/sickn33/antigravity-awesome-skills / ライセンス: MIT
関連スキル
nano-banana-2
inference.sh CLIを通じてGoogle Gemini 3.1 Flash Image Preview（Nano Banana 2）で画像を生成します。テキストから画像を生成する機能、画像編集、最大14枚の複数画像入力、Google Searchグラウンディング機能に対応しています。トリガーワード：「nano banana 2」「nanobanana 2」「gemini 3.1 flash image」「gemini 3 1 flash image preview」「google image generation」
octocode-slides
洗練されたマルチファイル形式のHTMLプレゼンテーションを生成します。6段階のフロー（概要 → リサーチ → アウトライン → デザイン → 実装 → レビュー）で構成されています。各スライドは独立したHTMLファイルとなり、iframeで読み込まれます。「スライドを作成してほしい」「プレゼンテーションを作ってほしい」「HTMLスライドを生成してほしい」「デックを構築してほしい」といった依頼や、ノート・ドキュメント・コードを洗練されたプレゼンテーションに変換する際に使用できます。
gpt-image2-ppt
OpenAIのgpt-image-2を使用して、視覚的に優れたPPTスライドを生成します。Spatial Glass、Tech Blue、Editorial Monoなど10種類のキュレーション済みスタイルに対応し、ユーザーが提供したPPTXファイルを模倣するテンプレートクローンモードも搭載しています。HTMLビューアと16:9形式のPPTXファイルを出力します。プレゼンテーション、スライド、ピッチデック、投資家向けPPT、雑誌風PPTの作成依頼などで活用してください。
nano-banana
Nano Banana PRO（Gemini 3 Pro Image）およびNano Banana（Gemini 2.5 Flash Image）を使用したAI画像生成機能です。以下の場合に活用できます：（1）テキストプロンプトからの画像生成、（2）既存画像の編集、（3）インフォグラフィックス、ロゴ、商品写真、ステッカーなどのプロフェッショナルなビジュアルアセット制作、（4）複数画像での人物キャラクターの一貫性保持、（5）正確なテキスト描画を含む画像生成、（6）AI生成ビジュアルが必要なあらゆるタスク。「画像を生成」「画像を作成」「写真を作る」「ロゴをデザイン」「インフォグラフィックスを作成」「AI画像」「nano banana」またはその他の画像生成リクエストをトリガーとして機能します。
oiloil-ui-ux-guide
モダンでクリーンなUI/UXガイダンス・レビュースキルです。新機能や既存システム（Webアプリ）に対して、実行可能なUI/UX改善提案、デザイン原則、デザインレビューチェックリストが必要な場合に活用できます。CRAP（コントラスト・反復・配置・近接）をベースに、タスクファーストなUX、情報設計、フィードバック・システムステータス、一貫性、affordances、エラー防止・復旧、認知負荷を重視します。モダンミニマルスタイル（クリーン・余白・タイポグラフィ主導）を強制し、不要なテキストを削減、アイコンとしての絵文字を禁止し、統一されたアイコンセットから直感的で洗練されたアイコンを推奨します。
axiom-hig-ref
Apple Human Interface Guidelines リファレンス — 色（セマンティックカラー、カスタムカラー、パターン）、背景（マテリアル階層、ダイナミック背景）、タイポグラフィ（標準スタイル、カスタムフォント、Dynamic Type）、SF Symbols（レンダリングモード、色、多言語対応）、ダークモード、アクセシビリティ、プラットフォーム固有の考慮事項を網羅したガイドラインです。