メニュー
JSONで定義されたAPI仕様を元にRuby on RailsでAPIと管理画面を実装するスキル。全体のオーケストレーションを行い、各ステップの詳細ガイドラインに従って実装を進めます。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/xtone/ai_development_tools --skill orchestrating-api-implementationコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
SOC 職業分類に基づく
Figma のワイヤーフレーム URL から仕様書一式を docs/ 配下に Markdown で抽出するスキル。ページ構成・ユースケース・アクター・データモデル・コンポーネントを 15 ステップで段階的に生成し、整合性／データモデル／コンポーネントの 3 レビューを作成する。**既存リポジトリの機能拡張モード** では既存モデル・ルーティング・ビューを再利用優先。**レビュー反復反映ステップ** では質問ループで方針を確定しドキュメントに反映する。Figma URL が提供されたとき、Figma デザインから実装用仕様書を作りたいとき、または既存仕様書の精度向上を求められたときに使用する。
Claude Codeセッションの効率を分析・スコアリングするWebツール。セッションログ（JSONL）を解析し、7観点100点満点で「無駄の有無」を評価。npx session-evaluatorで起動し、ブラウザUIでセッション選択→分析→改善提案まで実行可能。
PRの変更内容をトリアージし、変更カテゴリ分類・表層チェック・必要リファレンス判定を行います。結果を`.pr-triage.json`に出力し、後続のコードレビューフェーズで活用します。CI環境でのコスト最適化に使用してください。
| name | orchestrating-api-implementation |
| description | JSONで定義されたAPI仕様を元にRuby on RailsでAPIと管理画面を実装するスキル。全体のオーケストレーションを行い、各ステップの詳細ガイドラインに従って実装を進めます。 |
このスキルは、JSONで定義されたAPI仕様に基づいて、Ruby on Rails + PostgreSQLでAPIと管理画面を実装します。
Claudeは以下の状況でこのスキルを使用します：
| 項目 | 技術 |
|---|---|
| 言語 | Ruby 3.4 |
| フレームワーク | Ruby on Rails 8.1 |
| データベース | PostgreSQL 18 |
| ORM | Active Record |
各ステップの詳細は steps/ ディレクトリ内のファイルを参照してください。
詳細: @steps/01_check_specification.md
Claudeは、JSON仕様ファイルを読み込み、モデル構造・フィールド定義・リレーションを把握します。 仕様形式: @references/01_json_specification.md
詳細: @steps/02_select_tech_stack.md
Claudeは、環境確認と管理画面の方式（ActiveAdmin / Administrate / Hotwire）を決定します。
詳細: @steps/03_define_usecases.md
Claudeは、JSON仕様のアクター・ユースケースを確認し、各モデルのCRUD操作、ページネーション、フィルタリング、ソート、リレーション取得方法を定義します。
詳細: @steps/04_define_openapi.md
Claudeは、ユースケースとモデル定義に基づいて、APIの仕様をOpenAPI 3.1形式で定義します。
詳細: @steps/05_design_db_schema.md
Claudeは、JSON仕様の型をPostgreSQLの型にマッピングし、テーブル設計を行います。
詳細: @steps/06_define_sql_and_indexes.md
Claudeは、ユースケースで実行されるSQLを洗い出し、通常インデックスと全文検索インデックス（GIN + tsvector）を定義します。
詳細: @steps/07_initialize_project.md
Claudeは、Rails 8.1プロジェクトを作成し、必要なGemと設定をセットアップします。
詳細: @steps/08_implement_migration.md
Claudeは、設計に基づいてマイグレーションファイルを作成・実行します。
詳細: @steps/09_implement_orm.md
Claudeは、Active Recordモデルにリレーション、スコープ、クエリメソッドを実装します。
詳細: @steps/10_implement_validation.md
Claudeは、JSON仕様のvalidation設定に基づいてActive Recordバリデーションを実装します。
詳細: @steps/11_implement_api_endpoints.md
Claudeは、RESTful APIエンドポイント（CRUD、ページネーション、フィルタリング、ソート）を実装します。
詳細: @steps/12_verify_api.md
Claudeは、curlとRSpecでAPIの動作を検証し、N+1問題がないことを確認します。
Claudeは、選択した方式で管理画面を実装します。方式に応じて以下のファイルを参照してください：
Note: Hotwire管理画面を実装する場合は、E2Eテスト設計・実装も含む包括的な
implementing-hotwire-adminスキルを使用してください。
詳細: @steps/14_implement_api_playground.md
Claudeは、OpenAPI定義を活用してSwagger UIまたはカスタムPlaygroundを実装し、APIを対話的にテストできる環境を構築します。
implementing-rails-api/
├── SKILL.md # このファイル
├── references/
│ └── 01_json_specification.md # JSON仕様の定義
└── steps/
├── 01_check_specification.md
├── 02_select_tech_stack.md
├── 03_define_usecases.md
├── 04_define_openapi.md
├── 05_design_db_schema.md
├── 06_define_sql_and_indexes.md
├── 07_initialize_project.md
├── 08_implement_migration.md
├── 09_implement_orm.md
├── 10_implement_validation.md
├── 11_implement_api_endpoints.md
├── 12_verify_api.md
├── 13a_admin_activeadmin.md
├── 13b_admin_administrate.md
├── 13c_admin_hotwire.md
├── 13d_admin_common.md
└── 14_implement_api_playground.md