이 스킬
운영 문서를 Skills 체계로 흡수
skills를 공개 문서이자 사람과 AI가 직접 실행하는 skill resolver로 유지하고, 엔진 기능·운영 방식 변경을 관련 skill에 동기화하는 운영 규칙이다.
절차
실행 순서
- 1
과거 운영 문서 주제는 `engines.*`, `runtime.*`, `operation.*` skill로 흡수한다.
- 2
`/skills`와 `dartlab.skills.search()`를 공식 최초 탐색 표면으로 둔다.
- 3
엔진 skill은 공개 호출 방식, 호출 동작, 대표 반환 형태, 실행 순서, 검증 게이트를 포함한다.
- 4
엔진 skill은 tool card 다. 엔진이 무엇을 분석할 수 있는지, 어떤 공개 호출을 쓰는지, 어떤 evidence 를 반환하는지까지만 책임진다. 축별 상세 schema 는 기능/docstring 으로 연결하고, 여러 엔진·반증·시각화·후속 모니터링을 묶는 실제 분석 절차는 recipe skill 로 둔다.
- 5
recipe skill은 EngineCall 우선이다. 엔진에 이미 있는 기능을 RunPython 코드로 다시 구현하지 않고, RunPython 은 engine surface 가 아직 없거나 L1/L1.5 helper 결합이 필요한 fallback 경로로만 둔다.
- 6
recipe 의 visualRefs 는 observed 상태의 `engines.viz.*` 만 공식 연결한다. unverified 시각화는 후속 후보로만 남기며, 근거 표 없이 장식 chart 를 만들지 않는다.
- 7
기능/docstring은 세부 필드와 코드 원천 자료이며, skill은 사람이 그대로 실행할 수 있는 공개 사용 문서다.
- 8
기능 개선, API 변경, 반환 형태 변경, 운영 방식 개선이 있으면 관련 skill을 같은 변경에서 갱신한다.
- 9
새 운영 규칙은 먼저 operation skill로 검색 가능해야 하며, 원문 위치가 필요하면 sourceRef를 반드시 둔다.
- 10
이 전환이 완료되면 삭제된 운영 문서 경로를 공식 진입점으로 안내하지 않는다.
예시
이런 질문이 들어오면 이 skill 을 쓴다
- 테스트 규칙을 Skills에서 찾기
- 아키텍처 규칙을 operation skill로 검색하기
출력
기대 결과
- operation category skill
- 원문 위치가 보존된 규칙
- 중복 없는 Skills 진입점
절차
- 과거 운영 문서 주제는
engines.*,runtime.*,operation.*skill로 흡수한다. /skills와dartlab.skills.search()를 공식 최초 탐색 표면으로 둔다.- 엔진 skill은 공개 호출 방식, 호출 동작, 대표 반환 형태, 실행 순서, 검증 게이트를 포함한다.
- 엔진 skill은 tool card 다. 엔진이 무엇을 분석할 수 있는지, 어떤 공개 호출을 쓰는지, 어떤 evidence 를 반환하는지까지만 책임진다. 축별 상세 schema 는 capability/docstring 으로 연결하고, 여러 엔진·반증·시각화·후속 모니터링을 묶는 실제 분석 절차는 recipe skill 로 둔다.
- recipe skill은 EngineCall 우선이다. 엔진에 이미 있는 기능을 RunPython 코드로 다시 구현하지 않고, RunPython 은 engine surface 가 아직 없거나 L1/L1.5 helper 결합이 필요한 fallback 경로로만 둔다.
- recipe 의 visualRefs 는 observed 상태의
engines.viz.*만 공식 연결한다. unverified 시각화는 후속 후보로만 남기며, 근거 표 없이 장식 chart 를 만들지 않는다. - 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을 대체한다.