> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 좋은 작업 작성하기

> 에이전트에게 작업을 맡길 때의 실용적인 팁: 목표와 완료 기준을 밝히고, 컨텍스트를 제공하고, 큰 작업을 나누고, 알맞은 권한을 선택하고, 반복 작업을 자동화하고, 에이전트에게 PR을 열게 합니다.

작업이 명확하면 에이전트가 잘못된 방향으로 가는 일이 줄고, 멈춰서 사용자에게 묻는 횟수도 줄어듭니다. 아래 팁은 대부분의 세션에 적용됩니다.

## 목표, 범위, 완료 기준 밝히기

무엇을 달성할지, 어디를 변경할지, 완료되었는지 어떻게 판단할지를 에이전트에게 알려 주세요. 비교해 보세요.

* "로그인 페이지를 고쳐 줘."
* "Safari에서 로그인 페이지의 입력 필드가 어긋나는 문제를 고쳐 줘. 로그인 페이지 스타일만 변경하고 다른 페이지는 건드리지 마. 끝나면 기존 테스트를 실행하고 Safari를 다루는 테스트를 추가해 줘."

두 번째 버전은 목표, 경계, 결과를 검증하는 방법을 제시합니다. 에이전트는 추측할 필요가 없으며, 언제 멈추고 작업을 사용자에게 넘겨야 하는지 알 수 있습니다.

## 관련 파일과 링크 제공

* 에이전트가 올바른 코드와 환경에서 작업하도록 **먼저 알맞은 프로젝트를 선택**하세요.
* 작업에 관련 파일, 폴더, 오류 메시지, 문서 링크를 명시하세요.
* UI 문제는 스크린샷을 첨부하거나 입력창의 **Take a screenshot**을 사용하세요. 로그, 디자인 파일 등의 자료는 첨부 파일로 보내세요. [세션 시작하기](https://docs.aihubmix.com/ko/cloud/sessions/start-a-session.md)를 참고하세요.
* 에이전트에게 필요한 시크릿은 프로젝트의 시크릿 및 환경 변수에 미리 저장해 두세요. 그러면 에이전트가 멈춰서 요청할 필요가 없습니다. [프로젝트 및 환경 구성](https://docs.aihubmix.com/ko/cloud/environments/projects.md)을 참고하세요.

## 큰 작업 나누기

세션은 보통 한 가지 일에 집중할 때 가장 잘 작동합니다. 큰 요청은 여러 세션으로 나누세요. 예를 들어 에이전트에게 먼저 방안을 조사하게 하고, 그 결과를 바탕으로 구현을 시작합니다.

* 작업의 일부가 서로 독립적이면 어떤 부분을 병렬로 진행할 수 있는지 알려 주세요. 복잡한 작업에서 에이전트는 [하위 에이전트](https://docs.aihubmix.com/ko/cloud/sessions/subagents.md)를 시작하여 동시에 작업하게 하고, 모두 끝나면 결과를 자동으로 합칠 수 있습니다.
* 다른 방법을 시도하려면 답변에서 새 세션을 **Fork**하세요. 원래 세션에는 영향이 없습니다.
* 에이전트가 방향을 벗어나면 끝날 때까지 기다릴 필요가 없습니다. **Steer**로 즉시 바로잡거나, 이전 메시지를 편집하고 다시 실행하세요. [에이전트와 함께 작업하기](https://docs.aihubmix.com/ko/cloud/sessions/work-with-agent.md)를 참고하세요.

## 알맞은 권한 선택

새 세션은 기본적으로 **Full access**를 사용하므로 에이전트가 단계마다 묻지 않습니다. 클라우드 서버에서 에이전트가 스스로 완료하기를 원하는 작업에 적합합니다. 클라우드 서버의 세션은 내 컴퓨터에 전혀 접근하지 않습니다.

다음과 같은 경우에는 **Ask for approval** 또는 **Approve for me**로 전환하세요.

* 세션이 내 컴퓨터에서 실행되며 중요한 파일이나 시스템 설정과 관련된 경우.
* 프로젝트에 에이전트가 마음대로 사용하지 않기를 원하는 시크릿이 있는 경우. Full access에서는 에이전트가 프로젝트의 모든 시크릿을 읽을 수 있습니다.
* 작업이 외부 서비스나 웹사이트에 연결되며, 에이전트가 실행하기 전에 확인하고 싶은 경우.

## 반복 작업에는 예약 작업 사용

"평일 오전 9시마다 의존성 업데이트를 확인해 줘"처럼 정기적으로 해야 하는 작업은 세션에서 에이전트에게 평소 말로 알려 주세요. 에이전트가 예약 작업 초안을 만들며, **Create**를 클릭해야 적용됩니다. "30분 뒤에 배포를 다시 확인해 줘"처럼 현재 세션과 관련된 후속 작업은 에이전트에게 세션 타이머를 설정하도록 요청하세요. 예약 작업은 클라우드 서버에서 실행되므로 내 컴퓨터가 꺼져 있어도 계속 실행됩니다. [예약 작업](https://docs.aihubmix.com/ko/cloud/automation/scheduled-tasks.md)을 참고하세요.

## 에이전트에게 PR을 열게 하기

변경이 끝나면 세션에서 에이전트에게 커밋, 푸시, PR 생성을 요청하세요. 예: "테스트가 통과하면 수정 내용을 설명하는 제목으로 PR을 만들어 줘." 기본 동작은 프로젝트 설정의 Ship behavior에 따릅니다. PR 생성, 브랜치 푸시, 직접 작성한 프롬프트에 따른 커밋 중 하나입니다. 연결된 원격 저장소가 없는 업로드 프로젝트는 변경 사항이 패치로 전달됩니다. 변경 사항을 검토하고 결과를 전달하는 방법은 [결과 검토 및 전달](https://docs.aihubmix.com/ko/cloud/sessions/review-and-deliver.md)을 참고하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.