Harness Skills
Harness Skills
Skills 는 재사용 가능한 지시 번들이에요. 프로젝트 규칙, 워크플로 지침, 도메인 특화 절차, 또는 기본 harness 런타임이 발견할 수 있어야 하는 기타 지시에 유용해요. HarnessAgent 에 대해 skills를 설정하거나 완료된 턴 사이에 교체할 수 있어요.
출처: 문서
본문
Skills 정의하기 (Define Skills)
skills 설정으로 HarnessAgent 에 skills를 전달하세요:
const agent = new HarnessAgent({
harness: claudeCode,
skills: [
{
name: 'careful-refactors',
description: 'Make small, low-risk code changes.',
content:
'Prefer minimal diffs. Preserve public APIs. Before editing, read references/checklist.md and follow it.',
files: [
{
path: 'references/checklist.md',
content:
'# Refactor checklist\n\n- Identify the smallest useful change.\n- Preserve public APIs.\n- Run the narrowest relevant test.',
},
],
},
],
});
각 skill은 다음을 가져요:
name: skill의 안정적인 식별자.description: 짧은 모델 지향 요약.content: 전체 지시 내용.files: skill과 함께 묶이는 선택적 추가 텍스트 파일.
추가 파일은 skill 상대 POSIX 경로를 사용해요. 예: reference.md, references/codes.md, templates/config.json. 에이전트가 읽어야 할 때는 content 에서 그 경로를 참조하세요.
Skills를 언제 쓰나 (When to Use Skills)
일반 instructions 처럼 항상 에이전트의 컨텍스트에 로드하는 대신, 온디맨드로 사용할 수 있어야 하는 재사용 가능한 지시에 skills를 사용하세요.
광범위한 에이전트 동작과 현재 세션 우선순위에는 instructions 를 사용하세요.
Skills는 callOptionsSchema 와 prepareCall 을 사용해 완료된 턴 사이에 변경할 수 있어요. 자세한 내용은 Change Settings Between Turns 를 보세요.