frappe-app-dev について
frappe-app-devは、Frappeのフルスタックアプリを開発・拡張するためのスキルです。新規作成と既存アプリの作業を分け、タスクに応じた手順や資料を選び、benchコマンドやサイトの操作方法も示します。
主な機能
- 01新規・既存アプリの作業フローを区別
- 02タスクに必要な資料を読み込む
- 03サイト・DocType・コントローラー開発を案内
- 04API・データベース・権限・テストを扱う
- 05benchコマンドの実行方法を規定
活用シーン
- 01Frappeアプリを新規作成
- 02既存のFrappeアプリに機能を追加
- 03DocType・API・バックグラウンドジョブを実装
- 04Frappeサイトの管理とテスト実行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ frappe/ skills --skill frappe-app-devインストール後、Claude Code で/frappe-app-devを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api.mdbackground-jobs.mdbench-operations.mdcaching.mdcontrollers.mddatabase.mddoctypes.mdexisting-app.mdfrontend-desk.mdfrontend-portal.mdfrontend-vue.mdfrontend.mdhooks.mdnew-app.mdpermissions.mdrealtime.mdsite-management.mdtesting.md詳細
Frappe フルスタックアプリビルダー
グローバルルール
./env/bin/benchではなく、benchをそのまま使用します。フルパスも使用しないでください。which bench、bench --version、bench --helpの実行や、frappe のバージョン確認は禁止です。調査コマンドは実行しないでください。- bench の検出をサブエージェントに委任しないでください。自分で
ls apps/ sites/ Procfileを実行してください。 mkdirで DocType フォルダーを作成しないでください。Frappe がbench migrateを通じて作成します。bench startは必ずバックグラウンドプロセスで実行してください。bench startを実行する前に、既存のターミナルですでに実行中かどうかを確認してください。2つ目のインスタンスを起動しないでください。- bench コマンドには必ず
--site <site>を明示的に指定してください。bench migrateを単独で実行しないでください。
フローの選択
該当するフローを判断し、関連するファイルだけを読み込んでください。
新しいアプリを作成する場合
新しいアプリを読んでください。bench のセットアップ、アプリのスキャフォールディング、サイトの作成とインストールについて説明しています。
既存のアプリで作業する場合
既存のアプリを読んでください。bench の検索、アプリの場所の特定、サイトの確認、機能の拡張について説明しています。
機能別リファレンス
現在のタスクに必要なリファレンスだけを読み込んでください。
| トピック | 読み込むタイミング | ファイル |
|---|---|---|
| サイト管理 | サイトの検索、作成、管理を行う場合 | サイト管理 |
| DocType | DocType、フィールド、命名規則を作成・変更する場合 | DocTypes |
| コントローラー | ドキュメントのライフサイクル、サーバー側のロジック | コントローラー |
| ホワイトリスト登録済み API | REST エンドポイント、@frappe.whitelist() | API |
| データベースと ORM | frappe.db、クエリ、SQL の直接実行 | データベース |
| キャッシュ | Redis、frappe.cache | キャッシュ |
| リアルタイム | WebSocket、publish_realtime | リアルタイム |
| バックグラウンドジョブ | frappe.enqueue、スケジュール済みジョブ | バックグラウンドジョブ |
| フック | hooks.py のパターン | フック |
| 権限 | ロール、DocType の権限、has_permission | 権限 |
| テスト | テストの作成と実行 | テスト |
| フロントエンドと UI | Desk UI、Vue SPA、ポータルページ | フロントエンド(ルーター → 3 つのサブファイル) |
| Bench CLI | bench コマンドの全リファレンス | Bench の操作 |
コメント
Markdown 対応