跳到主要內容
文件

開發者指南

AI 開發工具(devkit)

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。製作前會先進行設計問答
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(累積在您專案的本機)

延伸閱讀