メインコンテンツへ移動

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。

数値は記録された各例のものです。コピーできるコマンドはお使いのターミナルで実行し、結果は環境によって変わります。