본문으로 건너뛰기

QZX를 사용하는 이유

에이전트에게
명확한 출발점을 주세요.

QZX는 일상적인 진단을 문서화된 명령어와 명확한 결과로 제공합니다. 사용자도, 함께 일하는 자동화 도구도 같은 보고서를 활용할 수 있습니다.

무료로 제공되는 오픈 소스Windows, Linux, macOS 지원 여부는 명령어에 따라 다름사람이 읽기 쉬운 출력과 JSON

반복되는 작업에서

조사 절차를 재사용하고 맥락을 유지하세요.

QZX 명령어로 필요한 작업을 수행할 수 있을 때 흐름이 어떻게 달라지는지 보여 주는 도식입니다. 워크플로를 개념적으로 비교한 것입니다.

기존 방식

조사 절차 다시 구성하기

  1. 명령어 선택

    환경에 맞는 유틸리티와 매개변수를 파악합니다.

  2. 출력 해석

    각 검사에서 반환된 데이터를 모읍니다.

  3. 맥락 정리

    관찰한 내용을 정리해 다음 행동을 결정할 준비를 합니다.

QZX 사용 시

문서화된 작업에서 시작하기

qzx diagnoseProject . --json
  1. 진단 요청

    해당 작업을 지원하는 명령어를 사용합니다.

  2. 근거 확인

    기술 구성, 의존성, 발견 사항, 아직 실행하지 않은 검사를 살펴봅니다.

  3. 다음 단계 결정

    같은 결과를 사람이나 에이전트와 공유합니다.

테스트용 프로젝트에서 기록한 예제

기술 구성
Python
중복 제외 패키지
1
발견 사항
1
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 및 네이티브 명령어와 함께 사용할 수 있습니다. 필요한 작업을 지원하고 공통 인터페이스가 이해를 돕는 경우에 사용하세요.

도움이 되는 경우

  • 사용 중인 시스템을 지원하고 문서가 갖춰진 진단이 필요할 때.
  • 에이전트에게 유용한 맥락을 담은 구조화된 결과를 전달하고 싶을 때.
  • 스크립트 실행이나 파일 변경 전에 근거를 확인하고 싶을 때.

계속 확인해야 할 사항

  • 명령어 레퍼런스에 명시된 사용 가능 여부, 의존성, 플랫폼별 차이.
  • 실제로 실행된 검사. 테스트를 발견했다고 해서 그 테스트를 통과한 것은 아닙니다.
  • 상태를 변경하는 작업의 권한, 백업, 미리보기. QZX는 사용자의 권한으로 동작하며, 공통 인터페이스가 실행을 격리하지는 않습니다.

플랫폼 고유 기능, 스트리밍, 더 엄격한 타입 체계를 갖춘 통합이 필요하다면 적절한 네이티브 API나 도구를 선택하세요.

구체적인 작업부터 시작하세요

워크플로에 도입하기 전에 결과를 확인하세요.

기록된 예제를 살펴보고 자신의 환경에서 읽기 전용 명령어를 실행해 보세요.

이 결과의 출처

기록일: 2026-10-08. 사용 환경: QZX 0.2.2.0.15, CPython 3.13.13, Windows 11 10.0.26200.

수치는 기록된 예제의 결과입니다. 복사한 명령어는 사용자의 터미널에서 실행되며, 결과는 환경에 따라 달라집니다.