스킬

스킬은 현장에서 반복되는 작업 방식을 에이전트가 기억하도록 정리해 둔 것입니다. 한 번 만들어 두면 이후 세션에서 같은 일을 다시 설명하지 않아도 됩니다.

목록과 등록

메서드	경로	하는 일
GET	/api/skills	스킬 목록
POST	/api/skills	새 스킬
PATCH	/api/skills/{id}	수정 (바꿀 항목만 보냄)
DELETE	/api/skills/{id}	삭제

등록 본문:

{
  "name": "설비 일일점검 리포트",
  "description": "라인별 가동률과 알람 건수를 표로 정리한다",
  "content": "..."
}

description 이 중요합니다. 에이전트는 이 설명을 보고 지금 작업에 이 스킬이 맞는지 판단합니다 — 무엇을 하는지가 아니라 언제 쓰는지를 쓰는 편이 잘 걸립니다.

작업에서 스킬 뽑아내기

POST /api/session/{sessionId}/extract-skill

방금 끝낸 세션에서 한 일을 스킬로 정리해 줍니다. 잘된 작업을 다음에 재사용하고 싶을 때, 처음부터 스킬을 쓰는 대신 만들고 나서 뽑는 순서가 실제로는 더 편합니다.

내보내기와 가져오기

메서드	경로	하는 일
GET	/api/skills/export	전체를 스킬 팩으로 내려받기
POST	/api/skills/import	스킬 팩을 반입 (본문에 skills 배열)

현장별로 Studio를 따로 운영할 때, 본사에서 정리한 스킬 묶음을 각 현장으로 옮기는 데 씁니다. 폐쇄망에서도 파일만 반입하면 됩니다.