개발자 가이드

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` (내 프로젝트 로컬에 누적)