버전 1.0.0-alpha.1최신
챕터 2.20
스킬
Skills Engine 스킬을 작성, 테스트 및 게시하는 방법, 라이브 상태가 되었을 때 표시되는 위치, 그리고 플러그인의 매니페스트 스킬과 어떻게 다른지 알아봅니다. Harrow Port Authority의 선석 배정 요약 실제 사례가 포함되어 있습니다.
이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

Harrow Port Authority의 플랫폼 엔지니어인 Tomás Reilly는 지난달에 선석 계획 담당자들이 어시스턴트에게 "내일 어느 선석에 누가 배정되고, 무엇이 변경되었나요?"라고 물어볼 때마다 왜 다른 답변을 받는지 저에게 물었습니다. 그 이유는 어시스턴트에게 좋은 답변이 어떤 형태인지 아무도 알려주지 않았기 때문이었습니다. Skills Engine 스킬을 통해 반나절 만에 이 문제를 해결했습니다. 이제 계획 담당자들은 매번 선석 표가 맨 위에 오고, 그 아래에 이전 계획 이후의 변경 사항이, 그리고 마지막에 충돌 사항이 표시되는 동일한 3단 요약을 받습니다. 이 장에서는 해당 스킬의 처음부터 끝까지를 살펴본 다음, 플러그인의 매니페스트에 존재하는 또 다른 종류의 스킬을 다룹니다.
두 가지 종류의 스킬
Nexus는 서로 다른 두 가지 대상에 "스킬"이라는 단어를 사용하며, 이 둘은 다르게 구축됩니다.
| Skills Engine 스킬 | 매니페스트 스킬 | |
|---|---|---|
| 설명 | 스킬 라이브러리의 SKILL.md 패키지 |
플러그인의 skills[] 배열에 있는 타입이 지정된 행 |
| 작성 주체 | 권한이 있는 모든 사용자(크리에이터 또는 자체 에디터 사용) | 개발자(플러그인 내부) |
| 포함 내용 | 지침, 호출할 수 있는 도구, 선택적 파일 및 스크립트 | 입출력 스키마, 티어, 해당 티어에 필요한 필드 |
| 플랫폼 도달 방식 | 검증 및 업로드 후 Skills Engine에 게시됨 | 매니페스트에서 컴파일되어 스킬 레지스트리에 동기화됨 |
| 실행 주체 | 어시스턴트, 에이전트, 워크플로, AI(인공지능) 버튼, Claude Code | UNO(워크플로 엔진) 디스패치 |
| 일반적인 용도 | "선석 계획을 매번 동일한 방식으로 요약" | "이번 패스에서 우리의 궤도 전파기를 실행" |
이 장의 나머지 부분에서는 이 둘을 구분하여 다룹니다. 문단에서 단독으로 "스킬"이라고만 언급하면 이는 Skills Engine 스킬을 의미합니다.
1부: Skills Engine 스킬
스킬이란 무엇인가
스킬은 하나의 폴더입니다. 폴더의 SKILL.md 파일에는 스킬의 용도와 작업 수행 방법이 명시되어 있으며, 그 옆에는 작업에 필요한 파일과 실행할 스크립트가 함께 자리합니다. 엔진은 세 가지 계층으로 스킬을 로드합니다. 이름과 설명은 항상 로드하고, 작업에서 스킬을 호출할 때는 지침을 로드하며, 특정 단계에서 필요할 때만 파일을 로드합니다. 그렇기 때문에 설치 환경에 200개의 스킬을 보유하고 있더라도 실제로 사용하기 전까지는 비용이 거의 들지 않습니다.
skills/<slug>/
├── SKILL.md # required: YAML frontmatter, then the instructions
├── skill.yaml # optional: engine metadata (triggers, aliases, tags, capabilities)
└── scripts/ # optional: bundled with the skill as components
디렉터리 이름은 스킬의 슬러그와 같아야 합니다. 일치하지 않으면 검증 경고가 발생하며, 라이브러리가 업로드된 항목을 기존 스킬과 매칭할 때 슬러그를 사용하므로 이를 수정하는 것이 좋습니다.
SKILL.md 프론트매터
프론트매터는 파일 상단의 두 --- 줄 사이에 있는 YAML입니다. 이 형식에는 세 가지 필드가 필요합니다. 검증 자체는 몇 가지 항목에 대해서만 차단합니다. 즉, 이름이나 설명이 누락된 경우, 그리고 이미 사용 중인 슬러그나 작업 유형인 경우입니다. 그 외의 모든 사항은 경고로 보고합니다.
| 필드 | 타입 | 필수 여부 | 포함 내용 |
|---|---|---|---|
name |
string | 예 | 케밥 케이스(kebab-case)로 된 고유 식별자 |
description |
string | 예 | 스킬이 수행하는 작업(최대 500자). 라이브러리와 매처가 이를 읽으므로, 이 스킬이 적합한지 판단하려는 독자를 위해 작성하십시오 |
allowed-tools |
string 또는 list | 예 | 스킬이 호출할 수 있는 도구. 스킬을 실행하는 주체의 허용 목록을 좁히는 것만 가능합니다 |
triggers |
list | 아니요 | 스킬을 직접 호출하는 슬래시 명령어 |
capabilities |
list | 아니요 | 구조화된 기능으로, 각각 name, description 및 선택적으로 input_schema, output_schema, examples를 가집니다 |
version |
string | 아니요 | 시맨틱 버전. 생략 시 1.0.0 |
visibility |
string | 아니요 | private, team 또는 public |
status |
string | 아니요 | draft, testing 또는 published |
지침은 약 5,000토큰 미만으로 유지하십시오. 구체적으로 작성하고 예시를 제시하십시오. 각 스킬은 하나의 작업을 잘 수행해야 합니다. 만약 "그리고 또한"이라고 쓰고 있다면 두 개의 스킬로 나누어야 할 가능성이 높습니다.
skill.yaml
skill.yaml은 엔진이 탐색 및 라이브러리를 위해 필요로 하는 내용을 담고 있으므로 SKILL.md의 가독성이 유지됩니다. 엔진이 읽는 필드에는 name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools, capabilities가 포함됩니다. 기능(capability)은 매처가 해당 기능으로 보내야 하는 구문인 query_patterns를 포함할 수 있습니다. 또한 엔진 자체의 예산 책정을 위한 힌트인 complexity, estimated_tokens, required_services도 있습니다.
scripts/
scripts/ 아래의 모든 항목은 컴포넌트로서 스킬과 함께 그대로 번들링됩니다. 스크립트는 모델의 컨텍스트로 읽히지 않고 실행만 되며, 샌드박스에서 실행됩니다. 모델이 암산으로 처리해서는 안 되는 산술 연산이나 파싱 단계가 있을 때 사용하십시오.
공개 범위 및 상태
공개 범위는 누가 스킬을 찾을 수 있는지를 나타냅니다. private은 본인, team는 본인의 팀, public은 라이브러리가 제공되는 조직의 모든 구성원입니다. 콘솔에서 동일한 선택지는 "나만", "통관 데스크"와 같은 팀, 또는 전체 조직으로 표시되며, 도메인 팩의 자체 검토를 통해 해당 팩에 스킬을 공유할 수도 있습니다.
상태는 스킬이 수명 주기상 어디에 있는지를 나타냅니다.
| 상태 | 의미 |
|---|---|
draft |
작업 중; 탐색 불가 |
testing |
검증 중, 제한된 액세스 |
published |
일반 사용 가능 |
deprecated |
대체됨; 폐기 예정 |
버전이 한 번 게시되면 절대 변경되지 않습니다. 콘솔에서 "라이브", "카나리", "섀도"는 버전에 붙는 레이블이며, 이전 버전으로 다시 전환하면 레이블이 이동합니다. 진행 중인 실행은 시작할 때 사용한 버전으로 완료됩니다.
SKILL.md, 그 옆의 파일들과 각 파일이 로드되는 시점, 그리고 스킬이 호출할 수 있는 도구를 보여줍니다. 확인용 스킬에는 쓰기 작업을 수행하는 도구가 제공되지 않으며, 스킬은 실행 주체의 허용 목록을 좁히는 것만 가능합니다.폴더에서 라이브 스킬까지
Skills Engine 리포지토리에 있는 다섯 개의 npm 스크립트는 에디터에 있는 스킬을 라이브러리로 가져가고 제대로 도착했는지 증명합니다.
| 명령어 | 수행 작업 |
|---|---|
npm run skill:validate skills/<slug> |
패키지를 린트합니다. 게시하려면 오류가 0개여야 합니다 |
npm run skill:upload skills/<slug> |
한 단계로 검증 및 게시를 수행합니다. 멱등성을 가집니다 |
npm run skill:upload skills/<slug> --dry-run |
아무것도 쓰지 않고 검증 후 계획을 출력합니다 |
npm run skill:publish -- --dry-run skills/<slug> |
업로드 이면에서 작동하는 하위 수준의 게시로, 동일한 파이프라인을 사용합니다 |
npm run skill:reconcile |
리포지토리의 스킬을 라이브러리 및 스킬 레지스트리가 보유한 항목과 비교합니다 |
npm run skill:live:verify |
실행 중인 설치 환경에서 게시된 스킬을 처음부터 끝까지 확인합니다 |
게시 작업은 두 개의 항목을 기록하며 둘 다 중요합니다. 하나는 SKILL.md 본문, 기능, 컴포넌트 및 품질 기록을 포함하는 스킬 자체이며, 라이브러리, 탐색 및 매칭에서 이를 읽습니다. 다른 하나는 워크플로 엔진이 디스패치를 확인하는 기준이 되는 레지스트리 항목입니다. 레지스트리에만 도달한 스킬은 실행은 되지만 업로드하기 전까지는 라이브러리에서 보이지 않습니다.
게시는 멱등성을 가집니다. 변경되지 않은 스킬은 아무 작업도 수행하지 않으며(no-op), 기존 스킬은 슬러그로 매칭되어 새로 생성되지 않고 제자리에서 업데이트됩니다. 이미 게시된 버전과 동일한 바이트를 업로드하면 중복 생성되지 않고 CONTENT_HASH_ALREADY_PUBLISHED과 함께 해당 버전을 돌려받습니다.
skill:reconcile은 리포지토리의 스킬을 라이브러리, 레지스트리 및 워크플로 엔진의 인벤토리와 대조하여 한 곳에만 존재하고 다른 곳에는 없는 항목을 보고합니다. skill:live:verify는 실행 중인 설치 환경에서 한 단계 더 나아갑니다. 두 항목이 모두 존재하고 동일한 콘텐츠 해시로 서로를 가리키는지, 스킬의 작업 유형에 대한 드라이런 디스패치가 수락되는지, 스킬이 라이브러리 목록과 세부 정보에 표시되는지, 호출될 수 있는지, 그리고 감사 추적이 슬러그와 요청 ID로 게시, 디스패치 및 실행을 하나로 묶어주는지 확인합니다.
워크스테이션에서 업로드하면 포트 포워딩을 통해 설치 환경의 지식 서비스인 nexus-graphrag에 도달하며, 환경 변수에 Skills Engine의 서비스 키가 필요합니다. 화면에 출력하지 않고 키를 로드하십시오:
kubectl -n nexus port-forward svc/nexus-graphrag 8090:8090
read -rs GRAPHRAG_SKILLS_ENGINE_SERVICE_KEY
export GRAPHRAG_SKILLS_ENGINE_SERVICE_KEY
GRAPHRAG_URL=http://localhost:8090 npm run skill:upload skills/berth-allocation-summary클러스터 내부의 파이프라인 작업에서는 기본 주소가 자체적으로 확인되므로 GRAPHRAG_URL이 필요하지 않습니다. 조직 자체의 시크릿 프로세스를 통해 키를 가져오십시오. 키는 리포지토리, 셸 기록 또는 명령어의 출력에 절대 들어가서는 안 됩니다.
테스트, 승인 및 라이브 전환
스킬은 초안 상태로 라이브러리에 도달하며, 크리에이터는 세 가지 항목이 통과할 때까지 그 상태로 보류합니다.
| 점검 항목 | 수행 작업 |
|---|---|
| 테스트 케이스 | 스킬이 승인 단계로 넘어가려면 모든 케이스가 통과해야 합니다. 케이스는 사유를 기재해야만 제거할 수 있으며, 승인자는 이 사유를 볼 수 있습니다. |
| 섀도 환경에서의 드라이런 | 스킬은 아무도 답변을 보지 못하는 과거 작업에 대해 실행되며, 그 결과는 당시 사람이 내린 결정과 비교됩니다. |
| 다른 제품군의 모델에 의한 블라인드 검토 | 누락된 확인 사항, 날조된 출처, 그리고 스킬이 따르지 말았어야 할 심어진 지침을 따랐는지 여부를 찾습니다. |
그런 다음 승인 단계입니다. 쓰기 작업을 수행하는 도구를 추가하는 스킬은 두 명의 사용자가 패스키로 승인할 때까지 보류되며, 이를 제안한 사람은 승인자가 될 수 없습니다(PUBLISH_NEEDS_APPROVAL). 그 후 섀도 환경에서 라이브로 전환된 다음, 지정된 게이트 뒤의 한 단위 조직에 대해 카나리로 전환되고, 마지막으로 모든 사용자에게 적용됩니다. 카나리 게이트를 충족하지 못하면 카나리는 스스로 중단되고 모든 사용자는 이전 버전에 머무릅니다. 이를 조기에 모든 사용자에게 보내려면 사유와 두 번째 승인자가 필요합니다(CANARY_GATE_NOT_MET).
Community 에디션에는 크리에이터, 라이브러리, 버전 및 테스트가 모두 포함되어 있으며, 테스트가 통과하면 소유자가 단독으로 게시합니다. 카나리, 2인 승인, 플러그인 동기화 및 중복 병합은 Enterprise 에디션에서 제공됩니다.
스킬이 표시되는 위치
동일하게 게시된 스킬은 다섯 곳에서 사용자에게 도달합니다.
- 어시스턴트는 설명, 트리거 및 쿼리 패턴을 통해 요청을 스킬과 매칭하고 스킬의 지침을 따릅니다.
- 에이전트 및 워크플로는 스킬을 단계로서 호출합니다. 워크플로 단계에서 스킬을 지정하면 실행 시 사용한 버전을 기록합니다.
- 화면에 있는 AI 버튼은 각각 하나의 스킬을 실행합니다. 관리자는 "이 버튼 정보"를 열어 버튼이 실행하는 스킬, 읽는 내용, 마지막으로 변경한 사람을 확인할 수 있으며, 스킬을 건드리지 않고 버튼을 끌 수 있습니다.
- IDE(통합 개발 환경) 및 Claude Code는 Workbench와
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_job,sync_skills_local등을 포함한 13개의 MCP(Model Context Protocol) 도구를 통해 라이브러리에 도달합니다. 각 호출은 이를 시작한 사람의 권한으로 그 사람의 허용 목록 내에서 실행됩니다. - 스킬 라이브러리 자체에서 사용자는 스킬을 탐색하고, 실행하고, 변경을 제안할 수 있으며, 관리자는 각 스킬의 소유자, 사용자, 실행 횟수 및 지출을 확인할 수 있습니다.
무엇이 스킬을 실행하든, 스킬은 실행 주체가 할 수 있는 작업 범위를 넓힐 수 없습니다. 즉, 실행 주체의 허용 목록 내에 있는 도구만 호출하고 해당 사용자가 열 수 있는 항목만 읽습니다(SKILL_CANNOT_WIDEN_TOOLS). 모델 경로가 없는 실행은 추측하지 않고 거부되며(SKILLS_ENGINE_BINDING_MISSING), 디스패처가 조직 자체의 모델 설정에서 경로를 선택합니다.
실제 예제: Harrow를 위한 선석 배정 요약
Harrow의 계획 담당자들은 이미 Harrow 자체의 선석 계획 플러그인에서 제공하는 두 개의 읽기 전용 도구를 허용 목록에 가지고 있었습니다. berth-plan.read은 특정 날짜의 계획을 반환하고, vessel-call.read는 도착 시간대와 길이가 포함된 선박 입항 정보를 반환합니다. 이 스킬에는 다른 것이 필요하지 않습니다. 쓰기 작업을 절대 수행하지 않으므로 두 명의 승인자가 필요하지도 않습니다.
---
name: berth-allocation-summary
description: Summarise tomorrow's berth plan at Harrow for the planning desk. Use when someone asks who is on which berth, what moved since the last plan, or where two calls clash.
allowed-tools: berth-plan.read, vessel-call.read
triggers:
- /berth-summary
capabilities:
- name: summarise_berth_plan
description: The berth table, the changes since the last plan and any clashes, for one date
version: 1.0.0
visibility: team
status: draft
---
# Berth allocation summary
## When to use
A planner asks about the berth plan for a date, or asks what changed.
## Steps
1. Read the plan for the date with berth-plan.read. If no date is given, use tomorrow.
2. For each call on the plan, read it with vessel-call.read.
3. Write the berth table first: berth, vessel, arrival window, length overall.
4. Then list what moved since the previous plan, one line per change, with the reason the plan records.
5. Then list clashes: two calls whose windows overlap on one berth, or a vessel longer than the berth.
6. Cite the plan's version for every line. Never guess a time the plan doesn't give.
## Output
Three headed sections, in this order: Berths, Changes, Clashes. Write "No clashes" when there are none.그 옆의 skill.yaml은 라이브러리에 표시 이름, 카테고리 및 매처가 이곳으로 라우팅해야 하는 구문을 제공합니다:
# skill.yaml, beside SKILL.md
name: berth-allocation-summary
display_name: "Berth allocation summary"
version: "1.0.0"
status: draft
visibility: team
category: operations
tags:
- berths
- planning
triggers:
- "/berth-summary"
allowed_tools:
- berth-plan.read
- vessel-call.read
capabilities:
- name: "summarise_berth_plan"
description: "Berth table, changes since the last plan and clashes, for one date"
query_patterns:
- "who is on which berth tomorrow"
- "what moved on the berth plan"
- "any berth clashes on *"그런 다음 리포지토리 루트에서 명령어를 실행합니다:
npm run skill:validate skills/berth-allocation-summary
npm run skill:upload skills/berth-allocation-summary --dry-run
npm run skill:upload skills/berth-allocation-summaryTomás는 크리에이터에 여섯 개의 테스트 케이스를 추가했습니다. 평범한 날, 도착 지연으로 두 건의 입항이 이동된 날, 실제 충돌이 발생한 날, 아직 계획이 없는 날짜, 선석보다 너무 긴 선박, 그리고 스킬이 새 선석을 제안하도록 유도하는 요청(쓰기 도구가 없으므로 제안해서는 안 됨)입니다. 드라이런은 섀도 환경에서 과거 계획 20건을 다시 실행했습니다. 케이스가 통과되자 계획 데스크의 검토자가 이를 승인했고, 계획 팀을 위해 라이브로 전환되었습니다. 이제 어시스턴트는 매번 동일한 형태로 질문에 답변하며, 선석 계획 페이지에 있는 계획 담당자의 AI 버튼도 동일한 스킬을 실행합니다.
2부: 매니페스트 스킬
매니페스트 스킬은 플러그인이 게시하는 컴퓨팅 단위입니다. 이는 매니페스트의 skills[]에 선언되고, create-nexus-plugin validate를 실행할 때 SDK(소프트웨어 개발 키트)에 의해 검증되며, compileRegistry에 의해 레지스트리 본문으로 컴파일되어 스킬 레지스트리에 동기화됩니다. 레지스트리 SQL을 직접 수작업으로 작성할 일이 없으므로, 플랫폼이 디스패치하는 행과 선언한 디스크립터가 서로 달라질 수 없습니다.
모든 매니페스트 스킬에는 id, displayName, description, tier, classification, inputSchema, outputSchema이 필요합니다. timeoutMs도 선언하십시오. 이는 1,000에서 21,600,000(1초에서 6시간) 사이의 정수이며, 이 범위를 벗어난 값은 TIMEOUT_OUT_OF_BOUNDS와 함께 거부됩니다. dataResidency은 any, eu 또는 us이며, 기본값은 any입니다.
id은 lower_snake 형식이고, 레지스트리의 디스패치 키는 네임스페이스가 지정된 작업 유형인 <plugin name>.<skill id>이므로 두 플러그인이 충돌 없이 모두 summarise 스킬을 가질 수 있습니다. 다음은 템플릿의 스킬 하나를 간추린 것입니다:
{
"id": "sentiment_score",
"displayName": "Sentiment score",
"description": "Deterministic lexicon-based sentiment score for a piece of text.",
"tier": "host_callback",
"classification": "tenant",
"dataResidency": "any",
"inputSchema": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1 } }, "required": ["text"] },
"outputSchema": { "type": "object", "properties": { "score": { "type": "number" } }, "required": ["score"] },
"hostCallback": {
"service": "my-plugin",
"port": 8080,
"path": "/internal/skills/sentiment_score",
"maxRequestBytes": 262144,
"maxResponseBytes": 16384,
"tenantHeader": "X-Organization-ID"
},
"timeoutMs": 10000
}다섯 가지 티어
티어는 단순한 레이블이 아닙니다. 각 티어에는 고유한 필드가 있으며, 다른 티어에 속하는 필드는 조용히 무시되지 않고 FIELD_NOT_FOR_TIER과 함께 거부됩니다.
| 티어 | 필수 항목 | 모델 도달 여부 | 실행 주체 |
|---|---|---|---|
host_callback |
hostCallback: 자체 Service, 포트, 경로 및 두 바이트 제한(cap) |
아니요 | 플랫폼이 네임스페이스 내부의 자체 Service로 입력을 POST함 |
plugin_queue |
queueName, 표기는 <plugin name>.<name> |
아니요 | 큐에서 작업을 가져오는 자체 워커 |
tool_using |
systemPrompt 및 tools[]; 신뢰 수준 core 또는 verified |
예 | AI Provider Router를 통한 플랫폼; 각 도구 호출은 허용 목록에 있는 실행기(executor)를 통해 실행됨 |
llm_only |
systemPrompt; 신뢰 수준 core 또는 verified |
예 | AI Provider Router를 통한 플랫폼의 단일 호출 |
map |
map.perItemJobType, 맵이 아닌 동일한 매니페스트의 다른 스킬을 지정 |
대상을 통해서만 도달 | 플랫폼이 항목당 한 번씩 대상을 실행하고 결과를 수집함 |
어느 모델 티어도 제공자나 모델을 지정하지 않습니다. 라우터가 디스패치하는 조직의 자체 풀에서 둘 다 선택합니다. tool_using 스킬의 도구는 여섯 개의 실행기 중 하나를 지정합니다. standing_service_call(자체 Service), graphrag, graphrag_query, graphrag_search, h3 또는 web_search입니다. 그 외의 다른 것은 EXECUTOR_NOT_PERMITTED과 함께 거부됩니다. 세 개의 지식 그래프 실행기는 도구 이름에 해당하는 작업을 그대로 실행하기 때문에 graphrag_query 및 graphrag_search이라는 도구 이름만 수락합니다.
레지스트리에는 플러그인이 선언할 수 없는 두 가지 티어가 존재합니다. 체인과 단독으로 실행되는 스킬은 플랫폼에 의해서만 작성됩니다. 이 중 하나를 지정하는 동기화는 전체가 거부됩니다.
사용할 티어 선택
- 작업이 자체 코드로 계산하는 입력의 함수(점수, 계산, 자체 스키마 조회)인 경우
host_callback을 사용합니다. 테스트하기 가장 간단하며 템플릿의 기본값입니다. 콜백 경로를 보호하십시오. 매니페스트의 경로는 비밀이 아니며, 경로는 플랫폼의 호출을 검증하고 본문이 아닌 호출에서 조직 정보를 가져와야 합니다. 이를auth: internal로 선언하고 그 위에requireService(Fastify) 또는serviceMiddleware(Express)를 마운트하십시오. 가드는 다른 사람을 위해 발행된 토큰을 거부합니다. 빠르게 응답하고, 동일한 작업이 두 번 전달되더라도 무해하도록 만드십시오. - 사람이 기다리는 더 긴 작업으로, 자체 워커가 수명 주기를 소유하는 경우
plugin_queue을 사용합니다. 워커는 시작할 때 실행 상태를running로 변경하고 완료할 때 종료 상태로 변경해야 합니다. 결과만 게시하는 워커는 실행 상태가 영원히queued로 표시되게 만듭니다. - 고정된 시스템 프롬프트를 사용한 한 번의 모델 호출로 작업이 수행되고, 플러그인이
core또는verified인 경우llm_only을 사용합니다. - 모델이 루프에서 도구를 호출해야 하는 경우
tool_using을 사용하며, 이 역시core또는verified에서만 가능합니다. - 플랫폼이 목록에 대해 다른 스킬 중 하나를 팬아웃(fan out)하기를 원하는 경우
map을 사용합니다.
Corrán Orbital에 있는 저의 궤도 전파 스킬은 host_callback입니다. 우리의 플러그인은 community이므로 모델 티어는 애초에 선택지가 아니었고, 아쉬울 것도 없습니다. 화요일에 다른 답변을 내놓는 전파기는 무용지물보다 더 나쁠 것이기 때문입니다.
매 실행 전 승인
기계의 판단만으로는 절대 실행되어서는 안 되는 매니페스트 스킬은 이를 선언합니다:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }required은 항상 true이며, 승인이 필요 없는 스킬은 이 블록을 생략합니다. reason은 승인자가 보는 내용으로, 공백 제거 후 1~500자여야 하며, 그 외의 형태는 APPROVAL_INVALID와 함께 거부됩니다. 그러면 해당 스킬의 디스패치가 보류됩니다. 디스패치는 status: "awaiting_approval" 및 waitpointId과 함께 202를 응답하며, 지정된 사람의 승인이 있어야만 단 한 번 보류가 해제됩니다. 팬아웃은 개별 항목을 보류할 수 없기 때문에 보류된 스킬의 배치, 맵 또는 체인 디스패치는 SKILL_APPROVAL_NOT_HOLDABLE과 함께 거부됩니다. 보류된 응답을 렌더링하고 승인자가 결정하게 하십시오. 디스패치한 후에 동의를 구하지 마십시오.
레지스트리에 동기화
모든 동기화는 선언적이며 전체가 검사됩니다. 매번 전체 스킬 세트를 전송하십시오. 누락된 스킬은 비활성화되고 실행 기록은 유지됩니다. 하나의 잘못된 스킬이 있으면 모든 위반 사항이 함께 나열되고 아무것도 기록되지 않은 채 SYNC_CONTRACT_VIOLATION과 함께 전체 동기화가 거부되므로, 플러그인이 절반만 업데이트되는 일은 없습니다. 2.22장, 플러그인 런타임에서는 동기화 호출과 플랫폼이 어떤 플러그인이 호출하고 있는지 파악하는 방법을 다룹니다.
두 가지 종류 중 선택하기
작업이 "매번 동일한 방식으로 말하기"라면 Skills Engine 스킬입니다. 작업이 "내 코드를 실행하고 그 답변을 제공하기"라면 매니페스트 스킬입니다. 대부분의 실제 작업은 두 가지 모두로 귀결됩니다. Harrow의 선석 요약은 플러그인에서 도구를 가져오는 Skills Engine 스킬이며, 플러그인의 도구 자체는 매니페스트에 선언되어 있습니다. 두 가지 중 변경 비용이 더 저렴한 것은 Skills Engine 스킬이므로, 문구와 판단은 그곳에 두고 산술 연산은 플러그인에 두는 것이 좋습니다.
어느 쪽이든 비용은 실제로 발생합니다. Skills Engine 스킬은 SKILL.md이 잘 읽힌다고 해서 끝나는 것이 아닙니다. 케이스가 통과하고, 드라이런이 사람들의 결정과 일치하며, 본인이 아닌 다른 누군가가 승인했을 때 완료됩니다. 쓰기 작업을 수행하는 스킬의 경우 일주일 정도의 일정을 잡으십시오. 그중 대부분은 카나리에 소요됩니다.



