Công cụ phát triển AI (devkit)

devkit là bộ công cụ mã nguồn mở giúp bạn phát triển tiện ích mở rộng cho zittme bằng công cụ lập trình AI (Claude Code, Cursor, v.v.) mà không vi phạm quy ước. Bộ công cụ gồm máy chủ MCP, skill và tài liệu hướng dẫn phát triển.

Kho mã zittme/devkit

Kho mã: github.com/zittme/devkit (giấy phép MIT)
Công cụ này được cung cấp không kèm bảo đảm và không thuộc phạm vi hỗ trợ kỹ thuật chính thức. Báo cáo sự cố được tiếp nhận qua GitHub Issues.

Thành phần

Thư mục	Nội dung
`mcp/`	Máy chủ MCP. Tạo khung mã (scaffold), kiểm tra tĩnh template (lint), danh sách kiểm tra phát triển, triển khai lên máy chủ của bạn
`skills/`	3 skill: `make-layout`, `make-board-skin`, `make-theme`. Tiến hành hỏi đáp thiết kế trước khi tạo
`docs/`	Hướng dẫn phát triển. Có thể tham khảo cả khi không dùng AI

Luồng hoạt động

Luồng phát triển với devkit

Skill hỏi trước các quyết định thiết kế như chế độ tối hay cấu trúc menu, rồi tạo khung mã theo câu trả lời. Template hoàn chỉnh được kiểm tra tĩnh (lint_template), và công cụ triển khai sẽ từ chối tải lên nếu có vi phạm quy ước. Các bẫy tiêu biểu gây lỗi máy chủ trong template v2 (chú thích nhiều dòng, closure trong biểu thức, v.v.) là đối tượng kiểm tra.

Cài nhanh chỉ skill

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

Để chỉ cài một skill cụ thể, chỉ định như --skill make-layout.

Cài máy chủ MCP

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

Đăng ký với Claude Code:

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

Biến môi trường bắt buộc là ZITTME_PATH (đường dẫn mã nguồn website đang phát triển). Để dùng chức năng triển khai, hãy đặt thông tin kết nối như DEVKIT_SFTP_HOST vào biến môi trường. Vì thông tin xác thực không được ghi vào tệp nên không có khả năng vô tình commit vào kho mã.

Cách đăng ký với các công cụ khác như Cursor, Windsurf, Codex CLI, Gemini CLI được tổng hợp trong hướng dẫn tích hợp của kho mã.

Công cụ cung cấp (MCP)

Phân loại	Công cụ
Khung mã	`scaffold_module` `scaffold_layout` `scaffold_skin` `scaffold_query` `scaffold_schema`
Kiểm tra	`lint_template` `check_php_syntax`
Kiến thức	`get_dev_checklist` `get_guidelines` `get_framework_docs`
Khám phá	`get_module_structure` `search_code` `search_queries` `get_db_schema` v.v.
Triển khai	`deploy_to_server` `deploy_changed` `push_file` (tất cả đều bắt buộc qua lint)
Học hỏi	`record_pitfall` `list_pitfalls` (tích lũy cục bộ trong dự án của bạn)

Xem thêm

Cú pháp template v2 - bản gốc của các quy ước mà devkit kiểm tra
Xây dựng skin và layout
Tạo gói giao diện