Modus 개발과 작성
이것은 Modus 프레임워크 자체를 위한 복합 스킬입니다. 하나의 진입점이 전반적 인지, 모듈 개발, 테스트, 배포 및 문서 작성을 연결합니다. 모듈 가이드는 작업에 따라 로드되며, 전체 참조 디렉토리를 한 번에 컨텍스트에 넣지 않습니다.
먼저 현재 프로젝트 확인
소스 코드 위치는 사용자가 지정한 체크아웃을 기준으로 합니다. 지정되지 않은 경우 현재 Git 저장소 루트를 사용합니다. 이 스킬 디렉토리는 로드된 SKILL.md의 위치에 따라 결정됩니다. 체크아웃에 처음 진입하면 SKILL_DIR을 이 스킬 디렉토리로 설정하고, Modus 저장소 루트에서 읽기 전용 진단을 실행합니다:
python3.11 "$SKILL_DIR/scripts/inspect_repository.py" --root .
이것은 브랜치, HEAD, 업스트림, 로컬 변경 사항, 패키지 버전 및 지식 기준선 이동을 확인합니다. 네트워크에 연결하지 않고, 저장소에 쓰지 않으며, 설치된 Modus를 호출하지 않습니다. Python 3.11+ 인터프리터를 사용하며, 실제 환경에 따라 예제의 python3.11을 대체할 수 있습니다.
지식 스냅샷은 modus-open / 49c51621f378a58d6724eedde4657d9505346d45, 배포판 openmodus 0.0.4에서 가져옵니다. 다른 브랜치, 버전 또는 파일 변경은 관련 가이드가 현재 구현과 대조해야 함을 의미합니다. 브랜치를 자동으로 전환하거나, 개인 CLI를 업그레이드하거나, 프로젝트 지식을 생성하지 마십시오.
먼저 전반적 개요를 읽은 후 아래 표에 따라 가이드를 선택하세요. 프로젝트에 익숙하고 작업이 명확하다면 관련 모듈로 바로 이동할 수 있습니다.
작업 라우팅
| 현재 작업 | 읽을 문서 |
|---|---|
| 기능 개발, 수정, 리팩토링, 소스 코드 리뷰 | 개발 프로세스 + 해당 모듈 + 검증 및 배포 |
| 도움말, 인수, 종료 코드, 한국어 환경, 개인 패키지 유지보수 | CLI 및 유지보수 진입점 |
| 연동, 업그레이드, 제거, 매니페스트, 자산 충돌, Git 보호 | 프로젝트 설치 및 소유권 |
| CodeBuddy / Claude / Cursor / Codex 연동, 시작 훅 | 플랫폼 및 훅 |
| 소스 코드 발견, 고정, 파싱, 컴파일러, 언어 확장, 캐시 적중 | N1–N2: 소스 및 관찰 |
| 식별자 해석, 호출 관계, 토폴로지, 진입점부터 효과까지, 능력 순회 | N3–N4: 해석 및 능력 |
| 범위 후보, 클러스터링 제안, 증거 패킷, 컨텍스트, 커서, 요약 | N5–N6: 프로젝션 및 전달 |
| 현재 프로젝트 컨텍스트, 지식 라우팅, 순위, 소스 코드 폴백, 예산 | 검색 및 오케스트레이션 |
| Markdown ID, CAS, 지식 업데이트, 앵커, 완전성 및 게시 검증 | 지식 쓰기 및 검증 |
| init/reinit/update/sync 동작, 본문 생성, 범위 확인, 템플릿 | 지식 생성 워크플로우 |
| 다중 저장소 워크스페이스, 멤버 주소 지정, 외부 탐색, 격리 | 워크스페이스 |
| wheel, 소스 패키지, 의존성, CI, 테스트 선택 | 검증 및 배포 |
| 문서, 보고서, 기술 소개, 공유 개요, 아키텍처 다이어그램 | 소스 코드 근거 및 작성; 관련 메커니즘은 해당 모듈 참조 |
| iWiki, 이전 자료 또는 이 스킬의 근거 확인 | 출처 및 차이점 |
가장 쉽게 잘못 수정되는 경계
- Modus 설치 접속, 초기화 증거, 장기 Markdown 지식은 각각 다른 소유자가 있습니다.
modus init은 자산을 설치합니다./modus-init은 어시스턴트가 조사하고 지식을 생성합니다. - 일반 검색은 현재 소스 코드와 공식 Markdown을 읽습니다. 초기화 분석 캐시가 일상적인 실행의 사실적 소스가 되어서는 안 됩니다. 새로운 기능을 추가할 때
machine을 일반 CLI 경로로 가져오지 마십시오. - N1–N6은 결정적 증거 처리이고, K1–K6은 어시스턴트의 의미론적 생성입니다. 능력 조합은 LLM을 호출하지 않으며, 후보 및 대표 경로는 공식 도메인 또는 완전한 실행 체인과 같지 않습니다.
- 설치/업데이트 트랜잭션과 지식 업데이트의 실패 의미는 다릅니다. 지식 업데이트는 파일별로 커밋되고 부분적 성공을 보고하며, 전체 일괄 롤백을 약속할 수 없습니다.
.modus/및 호스트 복사본은 관리되는 연동 자산입니다.modus/knowledge/는 장기 지식입니다. 수동constraint/,references/business/는 별도로 보호됩니다.clean은 검사기가 다루는 완전성 또는 게시 약속만 증명하며, 본문의 진실성, 완전성, 명확성 또는 런타임 성공을 증명하지 않습니다.- 명령어, JSON 필드, 상태 코드, 안정적 ID 및 한국어 표시는 별도로 유지 관리됩니다. 템플릿은 패키지와 함께 제공되는 제품 동작 계약입니다.
작업 완료
개발 결과는 구체적인 동작, 수정 소유자, 실제 검증 및 검증되지 않은 경계를 설명합니다. 작성 결과는 현재 구현, 설계 목표, 기록 자료 및 효과 증거를 분리합니다. 이 스킬을 참조하면 위치 파악 속도를 높일 수 있지만, 구현 결론은 현재 소스 코드를 다시 읽어야 합니다.
이 스킬은 후속 개발을 지원하지만, 게시, 커밋, 푸시, 외부 문서 쓰기 또는 권한 위임을 부여하지 않습니다. 이러한 작업은 현재 사용자 작업의 권한을 따릅니다. 이 스킬을 사용한다고 해서 자동으로 지식을 재구성하거나, 스킬을 업데이트하거나, 관련 없는 자산을 변경하지 마십시오.