채팅 카드에서 Bash 종료 코드, 스크립트 출력 및 파일 diff

에이전트의 기능

• 파일read_file, write_file, edit_file, grep, glob, list_dir는 채팅의 현재 폴더에서 작동하며, edit_file은 모든 변경 사항의 diff를 표시합니다. 생성, 수정, 읽은 파일 수를 카운터로 보여줍니다.
• ShellWindows, WSL 또는 SSH로 연결된 서버 등 선택한 환경에서 명령을 실행하고 실제 종료 코드를 보고합니다. 위험한 명령은 차단됩니다.
• 웹web_search로 검색하고 http_get로 문서 페이지 하나를 가져와 명령의 동작을 사용하기 전에 확인할 수 있습니다.
• 스크린샷 및 이미지ocr는 저장된 스크린샷(예: 오류 메시지)에서 텍스트를 읽고, gen_image는 이미지 파일을 저장합니다.
• 오케스트레이션task는 하위 에이전트를 병렬로 시작하고, run_on_model은 큰 모델에 단계를 보내며, skills는 재사용 가능한 플레이북입니다.
• 승인 모드Auto-run은 즉시 실행하고, Ask first는 변경 작업을 하기 전에 일시 정지하며, Plan only는 계획만 작성하고 실행하지 않습니다.
• 크론정기적으로 프롬프트를 실행합니다. 예를 들어 소유한 머신에서 스크립트 일일 테스트를 실행합니다.
• 모델API 엔드포인트를 통한 클라우드 AI 제공자, PC의 로컬 모델 또는 별도 엔드포인트 없이 바로 사용할 수 있는 내장 모델을 지원합니다.

종료 코드와 인자가 포함된 네 가지 작업

인자가 없을 때 종료 코드 확인

에이전트에게 check.sh에 인자가 없을 때의 동작을 확인해 달라고 요청합니다. read_file이 스크립트를 열고, Shell은 이름 뒤에 아무것도 없이 bash check.sh를 실행합니다. 카드는 실제 출력과 종료 코드를 표시합니다. 스크립트가 표준 오류에 사용법 줄을 출력하고 exit 2로 끝나면 종료 코드는 2입니다. 마지막 명령의 Bash 종료 코드는 $?에 저장되며, 호출자는 해당 숫자만 확인합니다. 명확한 코드로 끝나는 스크립트는 항상 1을 반환하는 스크립트보다 테스트하기 쉽습니다. Shell은 스크립트를 두 값으로 다시 실행하며, 카드에는 0이 표시되어야 합니다. 코드가 놀랍다면 카드를 읽고 Ask first 모드에서 edit_file이 제안하는 수정 사항을 검토한 후 적용합니다.

getopts로 옵션 구문 분석

“getopt을 설명해 줘”라고 입력하면 에이전트는 평이한 언어로 답변합니다. getopts는 -v나 -f file과 같은 짧은 옵션을 위한 Bash 내장 명령이며, getopt는 --file과 같은 긴 옵션도 처리하며 시스템 간 동작이 다른 별도 명령입니다. 그런 다음 read_file이 스크립트를 열고 edit_file이 getopts 루프를 추가하며 diff를 확인합니다. Shell은 -v, -f 및 잘못된 옵션으로 스크립트를 실행하며 각 카드에는 고유한 종료 코드가 있습니다. 잘못된 옵션은 보통 잘못된 사용 의미인 2로 끝나야 합니다. 소수의 옵션에는 case와 shift가 있는 while 루프면 충분하므로 선호하는 버전을 요청할 수 있습니다. diff를 읽은 후에만 적용합니다.

공백이 포함된 값을 하나로 유지

공백이 포함된 인자를 스크립트에 전달할 때 값이 따옴표로 감싸지지 않으면 셸이 이를 별도의 단어로 나누므로 실패합니다. 에이전트는 read_file로 파일을 읽고 따옴표가 없는 $1과 $@를 찾으며, edit_file은 이를 이중 따옴표로 감싸는 변경을 제안합니다. Shell은 "two words"와 같은 값으로 스크립트를 실행하며 출력은 한 줄로 전달되는지 두 줄로 전달되는지 보여줍니다. 명령줄 인자를 관리하는 방법 중 하나는 shift로, 첫 번째 값을 제거하여 루프가 나머지 부분을 순회할 수 있게 합니다. 에이전트는 동일한 diff에 이를 추가할 수 있습니다. Ask first 모드에서는 편집이 사용자를 기다립니다. diff를 검토하고 테스트를 다시 실행한 후 두 출력을 직접 비교합니다.

set -eu로 오류 발생 시 중단

“bash exit script”를 검색하는 사람은 보통 exit 내장 명령을 찾습니다. exit N은 스크립트를 상태 N로 종료하고, return N은 함수만 종료합니다. 에이전트는 파일 상단에 set -eu와 set -o pipefail을 추가하여 오류와 미할당 변수 발생 시 스크립트를 중단하게 할 수 있으며, bash -n으로 구문 검사 및 bash -x로 각 명령을 출력합니다. return이 마지막 명령의 상태를 전달하지 않는다면 보통 그 사이에 다른 명령이 실행되었기 때문입니다. $?는 가장 최근 명령의 종료 코드만 보유합니다. Shell 카드는 추적 정보를 표시합니다. 위에서부터 읽고 스크립트와 비교한 후 수정 사항을 유지할지 결정합니다.