절차
실행 순서
- 1
새 내용이 엔진 API 능력이면 docstring/기능로 보강한다.
- 2
새 내용이 여러 엔진을 조합하는 분석 절차면 curated skill 후보로 둔다.
- 3
새 내용이 테스트, 릴리즈, 문서, UI, 데이터 같은 운영 규칙이면 operation skill로 둔다.
- 4
프로젝트별 실험은 `.dartlab/skills/**/*.md` user skill로 시작한다.
- 5
official 승격은 구조 lint, 서버 audit P, 사용자 확인이 모두 있을 때만 허용한다.
- 6
승격 후에도 SkillSpec은 schema를 복사하지 않고 사용 기능와 sourceRefs로 원천을 연결한다.
예시
이런 질문이 들어오면 이 skill 을 쓴다
- 새 운영 규칙을 operation skill로 추가하기
- 반복 분석 절차를 curated skill로 승격하기
출력
기대 결과
- 확장 위치 결정
- 승격 가능 여부
- 검증 체크리스트
절차
- 새 내용이 엔진 API 능력이면 docstring/capability로 보강한다.
- 새 내용이 여러 엔진을 조합하는 분석 절차면 curated skill 후보로 둔다.
- 새 내용이 테스트, 릴리즈, 문서, UI, 데이터 같은 운영 규칙이면 operation skill로 둔다.
- 프로젝트별 실험은
.dartlab/skills/**/*.mduser skill로 시작한다. - official 승격은 구조 lint, 서버 audit P, 사용자 확인이 모두 있을 때만 허용한다.
- 승격 후에도 SkillSpec은 schema를 복사하지 않고 capabilityRefs와 sourceRefs로 원천을 연결한다.
런타임
실행 환경별 호환성
| 환경 | 상태 | 비고 / 제한 |
|---|---|---|
| Local Python | supported | — |
| Server | supported | — |
| MCP | supported | — |
| Web AI | supported | — |
| Pyodide | supported | — |
실패 회피
흔한 실패 · 절대 금지
흔한 실패
- 한 번 쓴 질문별 runner를 skill로 고정
- 검증 없이 official 상태 부여
- docstring에 있어야 할 API 능력을 SkillSpec에 중복
- sourceRef 없는 운영 규칙 추가
절대 금지
- final answer template 저장
- API schema 복사
- 사용자 확인 없는 official 승격