절차
실행 순서
- 1
실패 또는 신규 질문을 목적어, 대상, 필요한 근거, runtime 제약으로 나눈다.
- 2
먼저 `search_reference`로 엔진 소유 skill을 찾고, 없으면 `engines.company`, `engines.scan`, `engines.macro`, `engines.quant`, `engines.viz` 중 필요한 엔진 조합을 선택한다.
- 3
조합이 기존 엔진 기본 skill과 기능의 Guide/AIContract만으로 충분히 설명되면 해당 skill/docstring 보강 후보로 둔다. 여러 기능를 묶는 반복 분석 절차가 필요하면 해당 엔진 폴더의 응용 SkillSpec 후보로 둔다.
- 4
서버 경유 `/api/ask` audit에서 같은 skill이 반복 P를 받으면 `auditP` 후보가 된다. `official`은 구조 lint, 서버 audit P, 사용자 확인을 모두 만족할 때만 허용한다.
- 5
public API 자체가 새 축을 요구할 정도로 반복되면 docstring Guide/AIContract 또는 공식 엔진 axis로 승격하고, 관련 SkillSpec의 공개 호출 방식과 대표 반환 형태를 같은 변경에서 갱신한다.
예시
이런 질문이 들어오면 이 skill 을 쓴다
- 엔진에 없는 분석도 skills만 보고 만들 수 있는지 확인해줘
- audit에서 실패한 질문을 skill 또는 docstring 개선으로 반영해줘
출력
기대 결과
- 반복 가능한 절차
- 필요한 사용 기능
- 승격 여부 판단
절차
- 실패 또는 신규 질문을 목적어, 대상, 필요한 근거, runtime 제약으로 나눈다.
- 먼저
search_reference로 엔진 소유 skill을 찾고, 없으면engines.company,engines.scan,engines.macro,engines.quant,engines.viz중 필요한 엔진 조합을 선택한다. - 조합이 기존 엔진 기본 skill과 capability의 Guide/AIContract만으로 충분히 설명되면 해당 skill/docstring 보강 후보로 둔다. 여러 capability를 묶는 반복 분석 절차가 필요하면 해당 엔진 폴더의 응용 SkillSpec 후보로 둔다.
- 서버 경유
/api/askaudit에서 같은 skill이 반복 P를 받으면auditP후보가 된다.official은 구조 lint, 서버 audit P, 사용자 확인을 모두 만족할 때만 허용한다. - public API 자체가 새 축을 요구할 정도로 반복되면 docstring Guide/AIContract 또는 공식 엔진 axis로 승격하고, 관련 SkillSpec의 공개 호출 방식과 대표 반환 형태를 같은 변경에서 갱신한다.
런타임
실행 환경별 호환성
| 환경 | 상태 | 비고 / 제한 |
|---|---|---|
| Local Python | supported | — |
| Server | supported | — |
| MCP | supported | — |
| Web AI | supported | — |
| Pyodide | limited |
|
실패 회피
흔한 실패 · 절대 금지
흔한 실패
- 한 질문에 맞춘 runner를 skill로 고정
- 공개 API 변경 후 관련 skill을 갱신하지 않음
- 자동 metric만 보고 official 승격
- 한 번 실패한 사례를 곧바로 docstring 문제로 단정
절대 금지
- 질문별 실행 코드 저장
- 답변 템플릿 저장
- skill과 공개 API 호출/반환 설명 불일치 방치
- 사용자 확인 없는 official 승격