docmd — 에이전트 스킬 (개발자)은(는) 무엇을 하나요?
이 스킬은 사용자가 docmd를 소비하는 사이트가 아닌 docmd 프레임워크 자체를 수정하려 할 때 사용하세요. 이 스킬은 npx docmd-skills dev <dir> 명령으로 로드되며, 기존 docmd-skills/ 설치와 함께 docmd-dev/를 추가합니다.
이 스킬을 사용해야 하는 경우
다음 신호 중 하나라도 해당될 때 사용하세요:
- 사용자의 현재 작업 디렉토리가 docmd 모노레포의 클론인 경우. 로컬 클론 디렉토리 이름은
docmd/입니다 (GitHub 경로는docmd-io/docmd/). 특징적인 파일:pnpm-lock.yaml,packages/core/src/,packages/ui/src/,packages/api/src/,packages/plugins/<name>/,packages/engines/. 클론하려면:git clone https://github.com/docmd-io/docmd.git docmd && cd docmd. - 사용자가 명시적으로 "플러그인을 작성", "템플릿을 작성", "엔진을 확장", "코어를 수정", "훅을 추가" 등과 같이 말한 경우.
- 사용자가 docmd 모노레포의
packages/core/src/,packages/api/src/,packages/ui/src/,packages/plugins/*/src/, 또는packages/engines/*/안에 있는 파일을 편집하고 있는 경우.
작업 디렉토리에 docmd/ 클론이 없는데 프레임워크 도움을 원한다면, 아무 작업 전에 먼저 물어보세요: 모노레포를 클론(git clone https://github.com/docmd-io/docmd.git docmd)하거나 기존 클론을 갱신(git -C docmd pull)하시겠습니까? 최신 로컬 클론 없이 프레임워크 소스 코드를 편집하지 마세요.
다음 경우에는 사용하지 마세요: 사이트 레벨 설정이나 운영(docmd-skills 사용), 또는 페이지 문서 품질(docmd-writer 사용).
로딩 규칙
- 사용자가 docmd 모노레포 내에서 적극적으로 작업 중이거나 프레임워크 내부에 대해 명시적으로 물을 때만 이 스킬을 로드하세요.
- 확실하지 않으면 docmd-skills (사용자)를 기본으로 사용하세요. 이 스킬로 전환한다는 것은 사용자가 모노레포에 대해
pnpm명령을 실행하는 데 익숙하다는 것을 의미합니다.
참조 색인
각 행은 참조 파일입니다. CLI 열은 이 파일을 추가하는 설치 서브명령어를 보여줍니다.
| 참조 | CLI 설치 서브명령어 | 용도 |
|---|---|---|
references/api-dev.md | docmd-skills dev | 프레임워크 작성자를 위한 공개 Node API: EngineLoader, URL 유틸리티, createActionDispatcher, TemplateSlot, 훅/액션 계약 |
references/plugin-development.md | docmd-skills dev | docmd 플러그인 작성: 패키지 구조, 매니페스트, apply() 생명주기, template 기능, 훅, 테스팅 |
references/template-development.md | docmd-skills dev | docmd 테마/템플릿 작성: 12개의 템플릿 슬롯, 에셋 파이프라인, manifest.json, 템플릿 플러그인 |
references/engines.md | docmd-skills dev | JS 대 Rust 빌드 엔진, 엔진 교체, 엔진별 설정, 성능 트레이드오프 |
워크플로
1. 모노레포 클론 또는 갱신
아직 클론이 없는 경우 — 클론 및 설치:
git clone https://github.com/docmd-io/docmd.git docmd
cd docmd
pnpm install
기존 클론이 있는 경우 — 갱신 및 필요시 의존성 재설치:
git -C docmd pull
pnpm install
결정하기 전에 클론이 뒤쳐져 있는지 확인하려면 git -C docmd status ("Your branch is behind" 확인) 또는 git -C docmd log -1 --oneline을 실행하고 https://github.com/docmd-io/docmd/commits/main과 비교하세요.
로컬 클론 디렉토리는 docmd/입니다 (docmd-io/docmd/가 아님). 그 안에는 이 스킬 전체에서 참조하는 표준 패키지 레이아웃이 있습니다.
2. 플러그인 작성
- 스캐폴딩 전에
references/plugin-development.md를 처음부터 끝까지 읽으세요. packages/plugins/<name>/아래에서 가장 가까운 기존 플러그인을 선택하고 그 구조를 복사하세요.references/api-dev.md에서Plugin타입, 훅 이름, 0.8.7에 도입된template기능을 확인하세요.- 플러그인 자체의
tests/아래에 테스트를 추가하세요. 모노레포의pnpm prep은 범용 안전장치를 실행합니다.
3. 템플릿 작성
- 12개의 템플릿 슬롯과 에셋 파이프라인을 확인하려면
references/template-development.md를 읽으세요. - 기존 템플릿(
packages/templates/summer/이 참조)에서 사용하는 매니페스트 구조와 일치시키세요. references/api-dev.md에서TemplateSlot유니온과 대조하여 검증하세요 (header슬롯 없음 — 12개입니다).
4. 엔진 작업
references/engines.md를 먼저 읽으세요 — 대상 엔진과 그 설정 키를 확인합니다.- 엔진 로더의 Node 레벨 변경을 위해
references/api-dev.md§ "엔진 로더 API"를 참조하세요.
스킬 간 네비게이션
- docmd-skills — 사이트 레벨 작업용; 기본적으로 먼저 로드하세요.
- docmd-writer — 작업이 템플릿 데모나 예제 문서 내의 문서 품질로 넘어갈 때 로드하세요.