Skill Market 운영 규칙

Skill Market 은 DartLab 의 공식 Skill OS 와 분리된 별도 커뮤니티 지식층이다. 등록 방식은 manifest 작성이나 PR 제출이 아니라 GitHub Discussions 의 Skill Market 카테고리에 분석 질문을 자연어로 쓰는 것이다. 전용 카테고리가 아직 없으면 Ideas 카테고리에 [Skill Market] 제목으로 쓰는 방식을 bootstrap 입구로 사용한다.

공식 Skill OS 는 src/dartlab/skills/specs/** 에 있는 builtin 지식이다. Skill Market 은 Discussion 원문과 댓글을 Forge 가 구조화한 정적 인덱스이며, 패키지 builtin skill 로 취급하지 않는다. 여기서 skill 은 카드나 설명문이 아니라 반복 가능한 분석 행위의 실행 계약이다.

trust tier

tier	의미	AI 처리
marketDraft	Discussion 에서 자동 구조화된 초안. 입력·출력·기준이 부족할 수 있다.	실행하지 않고 아이디어로만 제시한다.
marketRunnable	실제 DartLab caller 기반 executionPlan, 예시 입력, 기대 출력, 실패 조건이 있어 실행 후보로 제안 가능하다.	출처와 trust tier 를 보여준 뒤 사용자 동의 하에 사용한다.
marketCurated	Skill Market 안에서 완성된 공유스킬이다. maintainer 가 입력·데이터·executionPlan·출력·판단·한계를 검토했다.	sourceUrl 과 trust tier 를 표시하고 보조 실행 절차로 사용할 수 있다. builtin 과 같은 권한은 주지 않는다.
builtinCandidate	예외적인 장기 검토 상태다. marketCurated 중 공식 Skill OS 편입 가능성이 따로 지정된 항목이다.	구현·문서 편입 검토 대상으로만 다룬다. 기본 운영 경로가 아니다.
blocked	악성 지시, 불명확한 라이선스, 실행 위험, 중복 등으로 차단된 항목이다.	검색 결과에서 경고 또는 숨김 처리한다.

등록 흐름

1. 사용자는 GitHub Discussions 의 Skill Market 카테고리에 분석 질문을 쓴다. 전용 카테고리가 없으면 Ideas 카테고리에 [Skill Market] 제목으로 쓴다.
2. DartLab Forge workflow 가 Discussion 원문과 댓글을 읽는다.
3. Forge 는 intent, inputs, dataSources, procedure, executionPlan, outputs, outputSchema, criteria, forbidden, completionCriteria, examples, mappedBuiltinSkills, missingDetails 를 추출한다.
4. Forge 는 자동 댓글로 구조화 초안을 남긴다. 이 댓글은 공식 승인이나 curated 판정이 아니다.
5. 작성자와 커뮤니티는 Caller Audit 으로 실제 DartLab caller, 입력 파라미터, 출력, 실패 조건을 확인한다.
6. 토론에서 확인한 caller 를 executionPlan 으로 작성하고 예시 입력과 기대 출력을 붙인다.
7. maintainer 는 /market runnable, /market curated, /market builtin-candidate, /market blocked 명령으로 현재 revision 을 확정할 수 있다.
8. 확정 명령이 있어도 executionPlan 또는 예시가 부족하면 snapshot 을 만들지 않고 missingDetails 로 남긴다.
9. 상태 확정 뒤 새 댓글이 달리면 Forge 는 최종 스킬을 즉시 바꾸지 않고 revisionStatus: pendingReview 로 표시한다.
10. maintainer 가 revision draft 를 검토하고 다시 상태를 확정하면 items/{@html String.fromCharCode(123)}id{@html String.fromCharCode(125)}.json, 정적 index, 랜딩 카드가 갱신된다.

완성 정의

Skill Market 의 완성 상태는 accepted snapshot 이다. marketRunnable 은 실행 후보 snapshot, marketCurated 는 검토 완료 snapshot, builtinCandidate 는 공식 Skill OS 편입 검토 snapshot 이다. 셋 모두 패키지 builtin Skill OS 에 편입한다는 뜻이 아니다.

최종 스킬의 canonical source 는 items/{@html String.fromCharCode(123)}id{@html String.fromCharCode(125)}.json accepted snapshot 이다. Discussion 은 토론장이고 댓글은 토론·반례·보강·credit 근거로 남긴다. 댓글이 달렸다는 이유만으로 최종 스킬 내용이 자동 변경되지는 않는다. 후속 댓글은 pendingReview revision 으로 잡고, maintainer 가 revision draft 를 검토하고 상태를 다시 확정해야 다음 snapshot 에 들어간다.

accepted snapshot 생성 조건은 다음과 같다.

• executionPlan 에 실제 DartLab engine 또는 recipe caller 가 있다.
• 예시 입력과 기대 출력이 있다.
• 입력, 데이터 소스, 출력 스키마, 판단 기준, 금지·실패 조건이 있다.
• maintainer 가 /market runnable, /market curated, /market builtin-candidate 중 하나로 현재 revision 을 확정했다.
• 조건 미달이면 확정 명령은 기록되지만 snapshot 은 생성하지 않는다.

완성된 공유스킬은 marketIndex.json 에 다음 필드를 갖는다.

필드	의미
intent	어떤 분석 질문을 해결하는지
inputs	사용자가 제공하거나 선택해야 하는 입력
dataSources	DartLab 또는 외부에서 조회할 데이터 범주
procedure	실행 순서
executionPlan	실제 DartLab engine 또는 recipe caller 호출 순서
outputs	사용자가 받는 결과
outputSchema	AI 와 랜딩이 기대할 수 있는 출력 구조
criteria	결과 판단 기준
forbidden	실행하거나 단정하면 안 되는 항목
completionCriteria	Skill Market 안에서 완성으로 보는 기준

revision 필드	의미
canonicalSource	최종 스킬 카드의 원천. v1 은 marketItemSnapshot 다.
itemPath	승인된 최종 스킬 snapshot 경로
acceptedAt	현재 snapshot 이 승인된 시각
version	accepted snapshot 버전
canonicalUpdatedAt	snapshot 생성에 사용된 토론 본문이 마지막으로 바뀐 시각
revisionStatus	current 또는 pendingReview
pendingCommentCount	최종화 이후 검토 대기 중인 댓글 수
pendingCommentUrls	검토 대기 댓글 링크

credit 원장

GitHub repository contributors graph 는 commit 중심이며 Discussion 기여를 DartLab 지식 기여자로 충분히 표현하지 못한다. DartLab 은 별도 credit 원장을 둔다.

role	의미
originator	최초 Discussion 작성자
coAuthor	기준·본문·예시를 실질적으로 보강한 사람
reviewer	반례·검증·오류 지적을 남긴 사람
curator	curated 또는 builtinCandidate 상태를 확정한 maintainer
implementer	builtin Skill OS 나 코드로 편입한 구현자

정적 산출물

Skill Market 산출물은 landing/static/skills/market/ 아래에 생성된다.

파일	용도
items/{@html String.fromCharCode(123)}id{@html String.fromCharCode(125)}.json	승인된 최종 공유스킬 snapshot. detail page 와 AI 실행 절차의 canonical source 다. 조건 미달 draft 에는 생성하지 않는다.
marketIndex.json	Pages 와 AI 가 읽는 검색용 인덱스. draft 와 accepted 항목을 모두 담되, accepted 항목만 itemPath 를 갖는다.
marketCredits.json	skill 별 credit 원장
marketGraph.json	market skill 과 builtin skill 의 연결 그래프

이 파일들은 PyPI 패키지의 builtin Skill OS 에 포함하지 않는다. Pages 빌드 또는 GitHub Actions 에서 최신 Discussion 상태를 반영해 생성한다.

AI 조회 규칙

AI 는 항상 builtin Skill OS 를 먼저 검색한다. builtin 으로 충분하면 Skill Market 을 보지 않는다. builtin 에 없는 분석 의도나 커뮤니티 아이디어가 필요할 때만 Skill Market 을 조회한다.

Market 결과를 답변에 사용할 때는 sourceUrl, trustTier, author, missingDetails 를 함께 드러낸다. marketDraft 는 직접 실행하지 않는다. marketRunnable 이상도 외부 작성물이라는 사실을 유지한다. accepted snapshot 은 executionPlan, dataSources, outputSchema, forbidden 을 함께 읽어 실행 경계를 고정한다. revisionStatus 가 pendingReview 이면 현재 accepted snapshot 기준 최종 스킬은 사용할 수 있지만, 후속 댓글이 검토 대기 중임을 함께 알려야 한다.

운영 cadence

• Discussion 생성·수정·댓글 변경 시 Forge 가 즉시 재색인한다.
• 매일 1 회 scheduled rebuild 로 preview event 누락을 복구한다.
• 매주 maintainer triage 에서 runnable, curated, builtinCandidate 후보를 검토한다.
• 릴리즈 전에는 curated 목록을 점검하고, 예외적으로 지정된 builtinCandidate 만 공식 편입 여부를 확인한다.

다음 단계

• start.dartlabSkillOs — 공식 Skill OS 진입점.
• operation.code — 공식 코드·문서 규칙.
• operation.testing — 검증 게이트.