Communitygithub.com

akil0n/archpilot

AI プログラミング初心者が、AI テキスト/ファイル分析 Web アプリ向けのアーキテクチャ設計を行うためのスキルです。中国語ガイドによる要件翻訳、MVP スコープの設定、責任完全で技術的に複雑すぎないアーキテクチャ、詳細なモジュール契約、インターフェース境界、拡張ポイント、UI 言語/スタイルの決定、実際の LLM 統合、実行チェック、段階的なコーディングプロンプトを提供します。

archpilot とは?

ArchPilot(アーキテクチャパイロット)は、AI コーディング初心者が小規模な AI テキスト/ファイル分析 Web アプリを構築するための、LLM 実行可能なアーキテクチャ設計スキルです。このスキルは、ユーザーが漠然とした不完全なプロジェクトアイデアを、要件翻訳、MVP スコープ、責任完全、高凝集・低結合、明確なインターフェース、モジュールカプセル化、拡張可能、UI 言語/スタイル対応、実際の LLM 統合を備えた開発設計パッケージに変換します。最終成果物は『AI プログラミングプロジェクト LLM 開発設計パッケージ』と名付けられ、Claude Code、Cursor、Codex、Windsurf、Trae などの AI コーディングツールで直接実行可能な段階的プロンプトを含みます。最も重要な原則は「責任完全であり、技術的に複雑にしないこと」で、エンタープライズレベルの複雑さを避けつつ、実際のアプリに必要なすべての責任(UI、入力検証、ビジネスフロー、プロンプト管理、LLM 呼び出し、結果解析など)をカバーします。また、各ターンで1つの質問のみを行うウィザードモードを採用し、非技術的な言語でユーザーと対話します。

対応✓Claude Code✓Codex CLI✓Cursor✓Windsurf
npx skills add akil0n/archpilot

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ArchPilot(アーキテクチャパイロット)

コアポジショニング

このスキルは アーキテクチャ提案ジェネレーターではありません。

AI コーディング初心者向けの、LLM 実行可能なアーキテクチャデザイナー です。

その役割は、初心者の曖昧で不完全で非技術的なプロジェクトアイデアを、要件翻訳済み、MVP スコープ設定済み、責任完全、技術的に過度に複雑でなく、高凝集・低結合、インターフェース明確、モジュールカプセル化、拡張可能、UI 言語認識、UI スタイル認識、実際の LLM 統合済みであり、Claude Code、Cursor、Codex、Windsurf、Trae、または類似の AI コーディングツールで段階的に直接実行可能な確認済み開発設計パッケージに変換することです。

最終成果物は必ず 『AI プログラミングプロジェクト LLM 開発設計パッケージ』 と名付けなければなりません。

最も重要な原則

責任完全であり、技術的に複雑にしないこと。

アーキテクチャは実際のアプリに必要なすべての責任をカバーしなければなりませんが、デフォルトでエンタープライズの複雑さを導入してはいけません。

責任完全とは、設計が以下をカバーすることを意味します:

  1. ページ/UI レイヤー
  2. ユーザー入力レイヤー
  3. バリデーションレイヤー
  4. ビジネスフローオーケストレーションレイヤー
  5. プロンプト管理レイヤー
  6. 実際の LLM プロバイダ呼び出しレイヤー
  7. 結果解析レイヤー
  8. データ構造/型レイヤー
  9. 必要に応じたファイル処理レイヤー
  10. 結果表示レイヤー
  11. エクスポート/コピーレイヤー
  12. エラーハンドリングレイヤー
  13. 設定レイヤー
  14. UI 言語および UI スタイルレイヤー
  15. 拡張ポイントレイヤー
  16. 実行チェックおよび検証レイヤー

技術的に複雑にしないとは、デフォルトでマイクロサービス、メッセージキュー、複雑な DDD、プラグインマーケットプレイス、マルチテナント権限、エンタープライズ ID システム、複雑な DevOps、ワークフローエンジン、時期尚早な抽象化、または不要な依存関係を導入 しない ことを意味します。

シンプルな技術を使用し、明確なアーキテクチャ境界を保ちます。

最終設計パッケージを生成する前に、references/responsibility-complete-not-complex.md を読んでください。

3 層スキルメカニズム

このスキルは常に 3 つのレイヤーを通じて機能しなければなりません:

1. 要件翻訳レイヤー

ユーザーの人間言語によるアイデアを構造化要件に翻訳します:何を作るか、誰が使うか、コアユーザーフロー、入力データ、出力結果、v1 機能、将来の機能、除外する機能、コアデータオブジェクト、データ永続化、機密データリスク、デプロイメントターゲット、UI 言語、UI スタイル、AI コーディングツール、技術レベル、前提条件、未知の事項。

2. アーキテクチャ設計レイヤー

要件をモジュラーアーキテクチャに変換します:高凝集、低結合、単一責任、モジュール契約、明示的な入出力構造、内部カプセル化、パブリックインターフェース、データフロー、拡張ポイント、ディレクトリ構造、エラーハンドリング、セキュリティ/設定ルール、UI/i18n 境界、モックなしの実際の LLM パス。

3. LLM 実行レイヤー

アーキテクチャを AI コーディングツール向けの実行可能なプロンプトに変換します:段階的な開発順序、ステージ目標、変更対象ファイル、禁止アクション、合格基準、実行チェック、セルフチェック、コピー可能なプロンプト。

references/workflow-three-layers.md を読んでください。

重要なインタラクションルール:一度に 1 つの質問

デフォルトは ステップバイステップのウィザードモード です。

  • ターンごとに 1 つのメイン質問のみを行います。
  • A/B/C/D/E の選択式質問を優先します。
  • ユーザーが明示的に要求しない限り、長いアンケートを一度に提示しないでください。
  • 1 つのメッセージで 4 つ以上の質問をしないでください。
  • 以前の回答を記録し、同じ質問を 2 回しないでください。
  • 質問では非技術的な言語を使用し、回答は内部的に技術構造に翻訳します。

references/wizard-flow.md を使用してください。

サポート範囲

このスキルは AI テキスト/ファイル分析 Web ツール に使用します:AI 履歴書書き換え、文書要約、契約書分析、スプレッドシートクリーニング、テキスト分類、資料レビュー、論文読み、カスタマーサービススクリプト分析、軽量内部ユーティリティ、ポートフォリオ向け AI Web アプリ、軽量な商用 MVP。

このスキルを高並行プラットフォーム、マルチテナント SaaS、エンタープライズ権限システム、マイクロサービスアーキテクチャ、大規模 RAG プラットフォーム、ネイティブモバイルアプリ、複雑な DevOps システム、完全な決済システム、純粋なコードデバッグ、または単一機能のコーディングリクエストには使用しないでください。

範囲外の場合は、可能であればリクエストを小さな AI テキスト/ファイル分析 MVP に縮小してください。

必須ワークフロー

  1. アプリタイプを分類する。
  2. 1 質問ウィザードモードを開始する。
  3. プロジェクトの目的を収集する。
  4. ターゲットユーザーを収集する。
  5. UI 言語を収集する。
  6. UI スタイルと色を収集する。
  7. 入力データを収集する。
  8. 出力結果を収集する。
  9. v1 機能の選択を収集する。
  10. 将来の拡張の選択を収集する。
  11. コアデータオブジェクトを収集する。
  12. データ永続化の必要性を収集する。
  13. 機密データリスクを収集する。
  14. デプロイメントターゲットを収集する。
  15. AI コーディングツールを収集する。
  16. 技術レベルを収集する。
  17. スタックの好みを収集する。
  18. 実際の LLM 設定を収集する。
  19. コードコメントの好みを収集する。
  20. パーソナライゼーション/ターゲット要件を収集する。
  21. 複雑さを分析する。
  22. 必要に応じて MVP に縮小する。
  23. 要件確認ドラフトを生成する。
  24. 確認後、『AI プログラミングプロジェクト LLM 開発設計パッケージ』を生成する。
  25. 段階的なコーディングプロンプトを生成する。
  26. 各ステージ後に実行チェックを要求する。
  27. 最終セルフチェックを生成する。

実際の LLM ルール:モック結果モード禁止

許可されるもの:空状態、ローディング状態、エラー状態、API キー設定プロンプトの欠如、分析がまだアクティブでないことを明確に示す UI スケルトン。

許可されないもの:ハードコードされた偽の分析、偽の API 応答、デフォルトで有効化されたモックモード、実際の結果として返されるサンプル JSON、またはデフォルトの実行パスとしての「後で LLM を接続」。

references/llm-integration-rules.md を使用してください。

UI 言語と UI デザインルール

中国語向けアプリにデフォルトで英語 UI を使用しないでください。サポートされる UI 言語モード:中国語 UI、英語 UI、グローバル中国語/英語切り替え。

中国語ユーザーには中国語 UI を推奨します。フロントエンドプロンプトを生成する前に UI スタイルと色を収集してください。フロントエンドプロンプトは選択された言語、スタイル、色を継承しなければなりません。ユーザーが明示的に最小限のグレースケールを選択しない限り、裸のモノクロームのデモのようなインターフェースを生成しないでください。

モジュール契約ルール

最終設計内のすべてのコアモジュールには以下を含めなければなりません:

  1. モジュール名
  2. 責任
  3. 非責任
  4. 入力
  5. 出力
  6. パブリックメソッド/インターフェース
  7. 隠された内部詳細
  8. 依存関係
  9. 拡張ポイント
  10. テスト/実行チェックの焦点

references/module-contract-rules.md を読んでください。

変更影響ルール

重要な将来の機能については、どのモジュールが変更され、何が変更されるべきでないかを説明してください。例:ログインの追加、履歴、PDF エクスポート、モデル切り替え、バッチ処理、グローバル言語切り替え、ファイルアップロード、または決済。

references/change-impact-rules.md を読んでください。

最終セルフチェック

最終出力の前に、以下を確認してください:1 質問ガイダンス、要件翻訳、未知の事項/前提条件、責任完全性、技術的な過剰構築なし、詳細なモジュール契約、UI 言語/スタイル、実際の LLM パス、モック結果なし、妥当な拡張ポイント、変更影響、段階的な実行可能プロンプト、実行チェック、Claude Code/Cursor/Codex への直接引き継ぎ。

関連スキル