절차
실행 순서
- 1
과거 운영 문서 주제는 `engines.*`, `runtime.*`, `operation.*` skill로 흡수한다.
- 2
`/skills`와 `dartlab.skills.search()`를 공식 최초 탐색 표면으로 둔다.
- 3
엔진 skill은 공개 호출 방식, 호출 동작, 대표 반환 형태, 실행 순서, 검증 게이트를 포함한다.
- 4
기능/docstring은 세부 필드와 코드 원천 자료이며, skill은 사람이 그대로 실행할 수 있는 공개 사용 문서다.
- 5
기능 개선, API 변경, 반환 형태 변경, 운영 방식 개선이 있으면 관련 skill을 같은 변경에서 갱신한다.
- 6
새 운영 규칙은 먼저 operation skill로 검색 가능해야 하며, 원문 위치가 필요하면 sourceRef를 반드시 둔다.
- 7
이 전환이 완료되면 삭제된 운영 문서 경로를 공식 진입점으로 안내하지 않는다.
예시
이런 질문이 들어오면 이 skill 을 쓴다
- 테스트 규칙을 Skills에서 찾기
- 아키텍처 규칙을 operation skill로 검색하기
출력
기대 결과
- operation category skill
- 원문 위치가 보존된 규칙
- 중복 없는 Skills 진입점
절차
- 과거 운영 문서 주제는
engines.*,runtime.*,operation.*skill로 흡수한다. /skills와dartlab.skills.search()를 공식 최초 탐색 표면으로 둔다.- 엔진 skill은 공개 호출 방식, 호출 동작, 대표 반환 형태, 실행 순서, 검증 게이트를 포함한다.
- capability/docstring은 세부 필드와 코드 원천 자료이며, skill은 사람이 그대로 실행할 수 있는 공개 사용 문서다.
- 기능 개선, API 변경, 반환 형태 변경, 운영 방식 개선이 있으면 관련 skill을 같은 변경에서 갱신한다.
- 새 운영 규칙은 먼저 operation skill로 검색 가능해야 하며, 원문 위치가 필요하면 sourceRef를 반드시 둔다.
- 이 전환이 완료되면 삭제된 운영 문서 경로를 공식 진입점으로 안내하지 않는다.
런타임
실행 환경별 호환성
| 환경 | 상태 | 비고 / 제한 |
|---|---|---|
| Local Python | supported | — |
| Server | supported | — |
| MCP | supported | — |
| Web AI | supported | — |
| Pyodide | supported | — |
실패 회피
흔한 실패 · 절대 금지
흔한 실패
- 운영 내용을 SkillSpec에 통째로 복사해 읽기 어려운 문서로 만듦
- 삭제된 운영 문서 경로와 Skills가 서로 다른 규칙을 말함
- operation skill에 sourceRefs가 없음
- 기능 개선이나 반환 형태 변경 후 관련 skill을 갱신하지 않음
- 긴 설계 원문을 사람이 읽는 첫 화면에 그대로 노출함
절대 금지
- 운영 규칙의 SSOT를 삭제된 문서 경로와 SkillSpec 양쪽에 서로 다르게 둔다.
- 공개 API의 호출 방식, 대표 반환 형태, 오류/제한 동작과 skill 설명의 불일치를 방치한다.
- 기능/docstring에서 skill을 자동 생성해 엔진 기본 skill을 대체한다.