Cargo custom command

공유 전에는 명령 계약과 실패 동작을 먼저 고정한다

cargo-<name> 도구는 팀 표준 작업을 한 줄로 묶어주지만, 이름과 환경, 오류 처리 규칙이 함께 정해져야 운영이 예측 가능합니다.

운영 고정 순서

1

반복 명령을 하나로 묶기

빌드, 검증, 포맷처럼 자주 반복되는 수동 절차를 먼저 고릅니다.

2

입력과 출력 계약 문서화

인자, 종료 코드, 로그 형식을 README와 CI 설정에 같이 남깁니다.

3

표준 Cargo 우회 경로 유지

확장 명령이 실패해도 기본 명령으로 즉시 원인을 좁힐 수 있어야 합니다.

공유 전 확인

args

잘못된 인자

오류 메시지와 종료 코드가 항상 같은 규칙으로 나옵니다.

env

필수 환경 변수

누락 시 즉시 멈추고 복구 방법을 안내합니다.

ci

CI 재현성

로컬과 CI에서 같은 성공 기준과 실패 기준을 사용합니다.

log

단계별 로그

장애 대응 시 어느 단계가 실패했는지 바로 분리합니다.

완료 기준

새 팀원이 문서만 보고 5분 안에 명령을 실행하고, 실패 상황까지 같은 방식으로 재현할 수 있으면 공유 준비가 된 것입니다.