DeepSeek Harness 모범 사례

제품 사실과 팀 정책을 구분합니다

작업하기 전에 작은 범위부터 읽습니다

1. 01

   프로젝트 지침부터 읽기

   저장소 루트와 하위 디렉터리의 지침 파일을 찾아, 대상 경로에 적용되는 규칙을 확인합니다.

2. 02

   관련 범위만 살펴보기

   검색 범위를 넓히기 전에 대상 파일, 테스트, 설정, 최근 로컬 변경 사항을 읽습니다.

3. 03

   의도한 변경과 증거 명시하기

   대상 파일, 예상 관찰 결과, 검증 명령, 롤백 지점을 기록합니다.

4. 04

   되돌릴 수 있는 단계로 작업하세요

   한 번에 하나의 일관된 변경을 수행하고 다음 경계로 이동하기 전에 차이를 검토하세요.

실제로 필요한 최소 권한만 사용합니다

인증 정보를 프롬프트와 저장소에 넣지 않습니다

• 현재 작업에 필요한 최소 자격 증명만 전달하며, 바람직하게는 범위가 지정된 공급자나 단기 토큰을 통해 전달하십시오.
• 비밀 정보를 채팅, 프로젝트 지침, 로그, 스크린샷, 고정치, 또는 커밋된 환경 파일에 붙여넣지 마십시오.
• 차이(diff)나 아티팩트를 공유하기 전에, 추적된 변경 사항과 추적되지 않은 변경 사항을 스캔하여 비밀 정보나 민감한 로컬 경로가 있는지 확인하세요.
• 노출 가능성이 있는 경우, 먼저 취소하거나 교체하십시오; 파일을 삭제한다고 해서 복사된 자격 증명이 무효화되지는 않습니다.

모든 변경을 롤백 가능하게 설계합니다

1. 01

   기준선을 캡처하세요.

   현재 수정 버전, 구성, 테스트 및 작업이 변경할 수 있는 외부 상태를 기록하세요.

2. 02

   비파괴적 작업을 선호하세요.

   광범위한 삭제나 재설정 대신 범위가 지정된 업서트, 추가 방식을 이용한 마이그레이션, 회수 가능한 파일 이동 및 정확한 대상 사용을 권장합니다.

3. 03

   전체 차이를 검사하세요.

   의도된 편집과 기존 사용자의 작업을 구분하고, 생성된 파일이 원본과 일치하는지 확인하세요.

4. 04

   실패가 중요한 경우 복구 테스트를 수행하세요.

   패키지, 마이그레이션 또는 배포의 경우, 릴리스 전에 제거, 역마이그레이션, 버전 롤백 또는 스냅샷 복원을 수행하십시오.

완료했다는 주장보다 실제 동작을 확인합니다

1. 수정된 동작을 증명하는 좁은 테스트를 실행하십시오.
2. 위험에 적합한 유형, 형식, 빌드 및 광범위한 회귀 검사를 실행하십시오.
3. 사용되는 실제 빌드와 브라우저, 런타임, 데이터베이스 또는 패키지 경로를 테스트하십시오.
4. 종료 코드에만 의존하지 말고 콘솔, 네트워크, 로그, 데이터베이스 결과 및 출력 산출물을 검사하십시오.
5. 실패를 솔직하게 기록하십시오; 원인을 이해했을 때만 재시도가 증거가 됩니다.

Skills와 플러그인을 공급망 입력으로 취급합니다

Skill은 재사용 가능한 지침 패키지이고, 플러그인은 실행 가능한 기능을 추가할 수 있습니다. 사용 전에 소스와 요구 기능을 확인하고, 가능하면 변경 불가능한 버전을 고정하며, 라이선스와 체크섬을 검증하고, 격리 환경에서 테스트합니다. 관리 책임자를 기록하고 업데이트·제거 경로도 정의합니다. 이름만 영구적으로 신뢰하지 말고 변경될 때마다 다시 검토해야 합니다.

경계에서 안쪽으로 순서대로 장애를 진단합니다

1. 가장 작은 입력과 깨끗하거나 일회용인 워크스페이스에서 문제를 재현합니다.
2. 활성 Profile, 플러그인 버전, 프로바이더 설정, 워크스페이스 루트, permission preset, 보고된 sandbox enforcement를 확인합니다.
3. 모델 출력 문제를 도구, shell, network, 인증 정보, UI, 영속성 장애와 분리합니다.
4. 구조화된 이벤트와 로그를 조사한 뒤 정상으로 알려진 기준선과 비교합니다.
5. 변수를 하나만 바꾸고 같은 검증을 다시 실행하며, 원인이 확정될 때까지 실패 증거를 보존합니다.