AI 開発ツール（devkit）

devkit は、AI コーディングツール（Claude Code、Cursor など）で zittme の拡張を作るときに、規約違反なく開発できるよう支援するオープンソースのツール集です。MCP サーバー、スキル、開発ガイドドキュメントで構成されています。

zittme/devkit リポジトリ

リポジトリ：github.com/zittme/devkit（MIT ライセンス）
このツールは無保証で提供され、公式の技術サポートの対象外です。問題の報告は GitHub イシューで受け付けます。

構成

フォルダー	内容
`mcp/`	MCP サーバー。スキャフォールド生成、テンプレートの静的検査（lint）、開発チェックリスト、自分のサーバーへのデプロイ
`skills/`	スキル3種：`make-layout`、`make-board-skin`、`make-theme`。制作前に設計の Q&A を先に進める
`docs/`	開発ガイド。AI なしでも参照可能

処理の流れ

devkit の開発フロー

スキルがダークモード・メニュー構成のような設計上の決定を先に尋ね、回答に合わせてスキャフォールドを生成します。完成したテンプレートは静的検査（lint_template）を通り、デプロイツールは規約違反があるとアップロードを拒否します。テンプレート v2 でサーバーエラーを起こす代表的な落とし穴（複数行コメント、式の中のクロージャなど）が検査対象です。

スキルだけを手早くインストール

npx skills add https://github.com/zittme/devkit

特定のスキルだけをインストールするには、--skill make-layout のように指定します。

MCP サーバーのインストール

git clone https://github.com/zittme/devkit
cd devkit/mcp
npm install
npm run build

Claude Code での登録：

claude mcp add zittme-devkit -- node <클론 경로>/mcp/dist/index.js

必須の環境変数は ZITTME_PATH（開発中のサイトのソースパス）で、デプロイ機能を使うには DEVKIT_SFTP_HOST などの接続情報を環境変数で渡します。認証情報をファイルに書かない方式なので、リポジトリに誤ってコミットされるおそれがありません。

Cursor、Windsurf、Codex CLI、Gemini CLI など他のツールの登録方法は、リポジトリの連携ガイドにまとめてあります。

提供ツール（MCP）

分類	ツール
スキャフォールド	`scaffold_module` `scaffold_layout` `scaffold_skin` `scaffold_query` `scaffold_schema`
検証	`lint_template` `check_php_syntax`
ナレッジ	`get_dev_checklist` `get_guidelines` `get_framework_docs`
探索	`get_module_structure` `search_code` `search_queries` `get_db_schema` など
デプロイ	`deploy_to_server` `deploy_changed` `push_file`（すべて lint の通過が必須）
学習	`record_pitfall` `list_pitfalls`（自分のプロジェクトのローカルに蓄積）

開発者ガイド

AI 開発ツール（devkit）