기존 방식
조사 절차 다시 구성하기
- 명령어 선택
환경에 맞는 유틸리티와 매개변수를 파악합니다.
- 출력 해석
각 검사에서 반환된 데이터를 모읍니다.
- 맥락 정리
관찰한 내용을 정리해 다음 행동을 결정할 준비를 합니다.
QZX를 사용하는 이유
QZX는 일상적인 진단을 문서화된 명령어와 명확한 결과로 제공합니다. 사용자도, 함께 일하는 자동화 도구도 같은 보고서를 활용할 수 있습니다.
반복되는 작업에서
QZX 명령어로 필요한 작업을 수행할 수 있을 때 흐름이 어떻게 달라지는지 보여 주는 도식입니다. 워크플로를 개념적으로 비교한 것입니다.
기존 방식
환경에 맞는 유틸리티와 매개변수를 파악합니다.
각 검사에서 반환된 데이터를 모읍니다.
관찰한 내용을 정리해 다음 행동을 결정할 준비를 합니다.
QZX 사용 시
qzx diagnoseProject . --json
해당 작업을 지원하는 명령어를 사용합니다.
기술 구성, 의존성, 발견 사항, 아직 실행하지 않은 검사를 살펴봅니다.
같은 결과를 사람이나 에이전트와 공유합니다.
테스트용 프로젝트에서 기록한 예제
{
"success": true,
"details": {
"technologies": [
"Python"
],
"dependencies": {
"unique_declared_package_count": 1,
"unique_packages": [
"httpx"
]
},
"version_control": {
"status": "not_repository"
},
"file_scan": {
"scanned_file_count": 3,
"scan_complete": true
},
"summary": {
"issue_count": 1,
"verification": {
"release_readiness": "not_assessed"
}
},
"validation": {
"tests": {
"status": "configured_not_run"
},
"lint": {
"status": "configured_not_run"
}
}
}
}
이 인터페이스의 이점
공통 용어와 직접 확인할 수 있는 결과.
지원되는 시스템에서는 같은 명령어 이름과 인수 형식을 재사용할 수 있습니다. 명령어 목록에는 각 작업의 매개변수와 요구 사항이 정리되어 있습니다.
명령어 살펴보기기본값은 사람이 읽기 쉬운 출력입니다. 프로그램이나 에이전트에 같은 결과의 구조화된 데이터가 필요하면 --json을 추가하세요.
실행 상태와 발견 사항은 서로 다른 필드에 담깁니다. 따라서 검사가 완료되었더라도 결과에 주의가 필요한 사항이 있는지 구분해 확인할 수 있습니다.
실제 예제 보기활용할 수 있는 경우
QZX는 API 및 네이티브 명령어와 함께 사용할 수 있습니다. 필요한 작업을 지원하고 공통 인터페이스가 이해를 돕는 경우에 사용하세요.
플랫폼 고유 기능, 스트리밍, 더 엄격한 타입 체계를 갖춘 통합이 필요하다면 적절한 네이티브 API나 도구를 선택하세요.
구체적인 작업부터 시작하세요
기록된 예제를 살펴보고 자신의 환경에서 읽기 전용 명령어를 실행해 보세요.