애셋 내보내기 파이프라인은 디자인 파일에서 빌드가 사용할 수 있는 파일에 이르는 일련의 과정입니다. 내보내기, 리사이징, 최적화, 이름 변경, 배치가 여기에 해당합니다. 이는 코딩 에이전트가 가장 잘하는 반복적이고 파일 중심적인 작업인 동시에, 디자이너가 엔지니어에게 실행을 요청해야 해서 늘 지연되는 작업이기도 합니다. assets 폴더에 고정되어 룸에서 접근할 수 있는 에이전트가 있다면 이러한 요청 과정 자체가 사라집니다.
요청
“@assets 디자인 파일의 아이콘 세트를 1x, 2x, 3x 크기로 내보내고, 최적화해서 /public/icons에 넣어줘. 컨택트 시트도 올려줘.”
에이전트가 수행하는 작업
- 디자인 도구의 API를 호출하여 최신 아이콘 컴포넌트를 가져옵니다.
- 세 가지 배율로 임시 폴더에 내보냅니다.
- 머신에 이미 설치된 최적화 도구를 실행합니다.
- 폴더 내
README.md에 작성된 프로젝트 규칙에 맞게 이름을 변경합니다. - 파일을
/public/icons로 이동하여 기존 세트를 교체합니다. - 컨택트 시트 이미지를 생성하고 개수와 함께 룸에 게시합니다.
디자이너는 타임라인에서 각 단계를 확인하고 마지막에 컨택트 시트를 볼 수 있습니다. 소요 시간은 약 1분입니다.
일시 중지되는 작업
1단계에서는 디자인 도구의 API token을 읽습니다. 이는 자격 증명 작업이므로 소유자의 승인을 받기 위해 처음 한 번 일시 중지되며, 누가 요청했는지와 에이전트가 무엇을 읽고자 하는지 보여주는 카드가 표시됩니다. 소유자가 승인하면 token은 머신 외부로 유출되지 않으며 디자이너에게도 노출되지 않습니다. 에이전트가 실행하기 전에 항상 확인해야 하는 네 가지 작업을 참고하세요.
에이전트가 새 아이콘을 main에 커밋하고 푸시하려는 경우에도 일시 중지됩니다. 대부분의 팀은 대신 브랜치에 커밋하고 풀 리퀘스트를 열도록 설정하며, 이 작업은 일시 중지되지 않습니다.
설정 방법
- 에이전트 하나, 폴더 하나. 사이트 리포지토리의 디자인 애셋 디렉터리에
assets를 고정하거나, 에이전트가 코드베이스에 접근하지 못하게 하려면 전용 내보내기 폴더에 고정하세요. - 규칙 문서화하기. 명명 규칙, 크기, 포맷, 대상 경로를
README.md에 적어 두세요. 에이전트는 매번 이 문서를 읽습니다. acceptEdits권한 모드. 파일 작성이 주 업무이며, 명령어 실행은 여전히 승인을 요청합니다. 권한 모드 살펴보기를 참고하세요.- 디자이너를 위한 사전 승인. 각 디자이너별로 한 번만 승인해 두면 이후에는 자유롭게 요청할 수 있습니다.
- token은 머신에 보관하기. 도구의 일반적인 설정 위치에 보관하세요. 요청이나 README에 token을 직접 붙여넣지 마세요.
활용 사례
스크립트 대신 룸을 사용하는 이유
스크립트도 내보내기 작업을 처리할 수 있습니다. 하지만 룸을 사용하면 변경 사항을 발견한 사람이 터미널, 티켓, 엔지니어의 개입 없이도 일상적인 작업을 직접 트리거하고, 진행 상황을 지켜보고, 결과를 받아볼 수 있습니다. 동시에 예외적인 작업(자격 증명, 삭제, 푸시)은 여전히 소유자의 승인을 거칩니다. 또한 누가 언제 무엇을 내보냈는지에 대한 기록도 남습니다. 코딩 에이전트는 코드 작성 그 이상의 일을 합니다를 참고하세요.
자주 묻는 질문
디자이너에게 디자인 도구의 API 접근 권한이 필요한가요? 아닙니다. token은 소유자의 머신에 있으며 에이전트가 해당 머신에서 이를 사용합니다. 디자이너가 요청하면 소유자가 자격 증명 읽기를 승인합니다.
에이전트가 풀 리퀘스트를 열 수 있나요? 네, 에이전트의 디렉터리가 리포지토리 내에 있고 머신에서 git 접근 권한이 있다면 가능합니다. 브랜치에 PR을 여는 것은 일시 중지되지 않지만, 공유 브랜치로 푸시하는 작업은 일시 중지됩니다.
디자이너가 명명 규칙을 변경하고 싶어 하면 어떻게 하나요? 해당 폴더의 README를 직접 수정하거나 에이전트에게 수정을 요청하세요. 에이전트는 매 요청마다 규칙을 새로 읽어옵니다.
내보내기 자체는 1분이면 끝나는 작업입니다. 문제는 기다림이었습니다. 애셋 에이전트를 위한 룸을 만들어 보세요.
게시일