Tune 스킬
미세 조정은 이미 존재하는 스킬에 대해 작은 증거 기반 수정을 적용하는 것입니다. 재작성이 아닙니다. 목표는 올바른 요청에 트리거되고, 형제 스킬을 방해하지 않으며, 정의된 형태로 작업을 전달하는 스킬을 만드는 것입니다.
기본 규칙
- 실제 SKILL.md 파일을 먼저 읽으십시오. README, 저장소 설명 및 목록은 에이전트가 실제로 로드하는 파일과 다를 수 있습니다. 스킬에 대한 모든 주장은 해당 스킬의 SKILL.md 또는 참조 자료에 근거해야 합니다. 파일을 열 수 없으면 파일 이름을 지정하고 추론하는 내용을 명시하십시오.
- 자신의 주장을 확인하십시오. 나중에 읽은 파일이 이전에 말한 내용과 모순되면 솔직하게 말하고 수정하십시오. 조용히 우회하지 마십시오.
- 최소한의 수정, 작성자의 어조 유지. 감사 결과 발견된 사항만 수정하고 다른 것은 변경하지 마십시오. 인식하지 못하는 프론트매터 키(
version,argument-hint,user-invocable)는 그대로 유지하십시오. 정직성, 안전성 또는 개인정보 보호 규칙을 약화시키지 마십시오. - 실행하지 않은 것은 주장하지 마십시오. 어떤 검사를 실행했는지, 어떤 테스트 케이스만 작성했는지, 어떤 파일을 보지 못했는지 명시하십시오.
워크플로우
1. 수집
대상 스킬의 SKILL.md와 대상이 접촉하는 모든 형제 스킬의 SKILL.md, 그리고 접근 가능한 모든 참조 자료를 가져옵니다. 사용자가 열 수 없는 링크를 제공하면 파일 텍스트나 URL을 요청하십시오. 스킬이 디스크의 폴더인 경우 지금 확인 스크립트(6단계)를 실행하여 첫 번째 읽기를 수행하십시오.
2. 매핑
스킬별로 간단한 목록을 작성하십시오: 설명이 약속하는 내용, 모드 또는 명령, 명명하는 참조 파일, 핸드오프 대상 및 대상. 형제 스킬의 설명과 명령 목록을 나란히 놓으십시오. 중복은 둘 다 볼 수 있을 때만 드러납니다.
3. 감사
references/audit-checklist.md를 통해 작업하십시오. 각 발견 사항에 대해 증거(해당 줄 인용), 심각도(트리거링 중단, 혼란 유발, 또는 사소함) 및 최소 수정 사항을 기록하십시오. 가장 심각한 것부터 보고하십시오.
4. 경계 설정
두 스킬이 동일한 요청을 주장하는 경우 하나의 소유권을 부여하십시오. 사용자가 이미 사용하고 있는 자체 설계의 분할 방식을 사용하십시오(예: verdict 대 artifact: 한 스킬은 판단하고 다른 스킬은 작성). 사용자의 설계로 해결되지 않는 경우에만 사용자에게 한 번 질문하십시오.
5. 편집
각 발견 사항을 수정하는 가장 작은 변경을 수행하십시오. 사용자가 결과를 바로 저장소에 넣을 경우 전체 교체 파일을 반환하고 변경되지 않은 텍스트를 정확히 복사하십시오. 수정에 새로운 공유 요소(예: 핸드오프 형식)가 필요한 경우 보지 못한 파일을 편집하는 대신 새 참조 파일을 추가하십시오. 일치하는 업데이트가 필요할 가능성이 있는 참조 파일을 나열하십시오.
6. 검증
각 스킬 폴더에서 확인 스크립트를 실행하십시오:
python scripts/check_skill.py <스킬-폴더-경로>
스크립트는 이름이 폴더와 일치하는지, 설명이 1024자 제한에 맞고 트리거 및 경계 표현이 있는지, H1이 이름과 일치하는지, 참조 파일이 존재하는지, 본문 길이가 적절한지 확인합니다. 모든 FAIL을 수정하십시오. 각 WARN을 판단하십시오. 붙여넣은 텍스트만 있는 경우 SKILL.md를 스킬 이름으로 폴더에 저장하고 거기서 실행하십시오. 이 경우 누락된 참조 경고는 예상됩니다.
7. 테스트 케이스 작성
references/test-cases.md를 따르십시오. 변경한 모든 경계에 대해 각 측면에 하나의 케이스를 작성하십시오. 설명에 대해 수동으로 실행하십시오. 일부 에이전트는 작성 도구에 자동 트리거링 루프를 제공합니다. 실행하지 않았다면 실행했다고 암시하지 마십시오. 어떤 것을 실행했는지 명시하십시오.
8. 보고
간결하게 유지하십시오:
- 스킬별로 변경된 사항과 이유(각 한 줄).
- 이전에 말한 내용에 대한 수정 사항.
- 볼 수 없거나 실행하지 않은 사항.
- 다음 단계 하나.
프로세스가 아닌 변경 사항을 먼저 제시하십시오.