Agent skills

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

Sume CLI 명령어는 에이전트 자동화를 명시적이고 감사 가능하게 만들도록 설계됐습니다.

읽기 전용부터 사용하기

계획 단계에서는 읽기 명령어를 먼저 사용하세요.

쓰기에는 확인 요구하기

에이전트는 운영자의 명시적인 확인 없이 리소스를 만들거나 유료 프로바이더 작업을 제출해서는 안 됩니다.

게이트	용도
`--confirm-submit`	Job 취소나 에셋 등록처럼 유료가 아닌 쓰기입니다.
`--confirm-paid`	크레딧을 예약하거나 소모할 수 있는 생성입니다(Avatar / Avatar Video).

Image, Video, Music 생성은 아직 CLI 제출 명령어가 아닙니다. 이 계열들은 에이전트가 Developer API를 호출하고, 필요하면 CLI Job 복구를 함께 쓰세요.

민감한 출력 가리기

자동화가 명령어 출력을 읽는다면 --agent --json을 사용하세요. agent 모드는 지원하는 곳에서 URL 형태의 필드와 계정·워크스페이스 정보를 가리거나 요약합니다.

번들 skills

패키징된 Sume skill을 로컬 에이전트 skill 디렉터리에 설치하거나 갱신합니다.

sume skills install은 .agents/skills 또는 .claude/skills에 씁니다. 커스텀 설치 전에 소스 파일을 확인하려면 export를 사용하세요.

에이전트를 위한 MCP

Cursor/Claude 원격 커넥터에는 호스팅 MCP(https://mcp.sume.com/mcp)를 권장합니다. 로컬 sume mcp는 현재 CLI 릴리스에서 출시되지 않았습니다. sume mcp doctor --json과 CLI 명령어 레퍼런스에서 살펴보세요.

권장 루프

카탈로그와 로컬 준비 상태를 확인합니다.
읽기 전용 또는 스키마 명령어로 페이로드를 검증합니다.
쓰기나 유료 작업 전에 확인을 요청합니다.
범위가 제한된 Job을 하나 제출합니다(Avatar는 CLI, Image/Video/Music은 API).
Job status/events/result 명령어로 복구합니다.
비밀 값이나 서명된 URL을 붙여 넣지 않고 결과를 요약합니다.