開発 · コマンドリファレンス
qzx diagnoseProject
機能
プロジェクトのスクリプトを実行せずに、技術スタック、依存関係、検証フロー、Git 状態、コード品質、大容量ファイルを調査します。
コマンドの成熟度: Alpha
実際の利用とフィードバックに使えますが、インターフェースと動作はまだ変更される可能性があります。 これは現在の開発チェックアウトに対する評価です。今後の各不変リリースタグには、そのバージョンに含まれた正確な評価が保存されます。 PyPI 0.2.2.0.9 で利用できます。ドキュメントは alpha チェックアウト 0.2.2.0.9 に対応しています。
動作と組み込み保護
状態を変更せずに検査します
この操作は直接実行されます
必要に応じてネイティブツールを使用します
ネットワークを使わずに動作します
権限昇格なしで動作するよう設計されています
読み取り専用の検査です。Git の問い合わせを実行する場合はありますが、プロジェクト定義のテスト、linter、型チェック、build、パッケージスクリプト、hook、インストーラーは決して実行しません。検出したフローは推奨コマンドとして返され、明示的に未検証のままです。
この安全分類は 2026-09-04 に OpenAI ChatGPT が実装ダイジェスト sha256:7ab0d09029e88f1ebe52be85698694204a7a20e60a5aa79c52c4725161922e99 と照合してレビューしました。
正確な構文
qzx diagnoseProject [path] --jsonパラメータ
スワイプするか横スクロールバーを使って、すべての列を表示してください。
| 名前 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| path | str | いいえ | "." | 診断するプロジェクトディレクトリのパス (既定値: '.') |
入力例
qzx diagnoseProjectスクリプトを実行せずに現在のディレクトリのプロジェクトを診断
qzx diagnoseProject C:/my/project指定パスのプロジェクトを診断
完全な構造化ペイロードを取得するには --json を追加します: qzx diagnoseProject [path] --json
観測された出力例
Windows 11 上の QZX 0.2.2.0.9 で取得。終了コードは 0。ホスト依存の値や所要時間は変わる場合があります。
例のコマンド: qzx diagnoseProject ../artifacts/qzx-evidence/project-doctor --json
{
"success": true,
"message": "Project diagnosis completed with 1 observed issue. 2 configured validation workflows were discovered but not executed; run the suggested commands before treating the project as release-ready.",
"details": {
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\project-doctor",
"technologies": [
"Python"
],
"dependencies": {
"manifest_count": 1,
"manifests_found": [
"pyproject.toml"
],
"total_declaration_count": 1,
"unique_declared_package_count": 1,
"unique_packages": [
"httpx"
],
"parse_errors": [],
"manifests": [
{
"path": "pyproject.toml",
"ecosystem": "python",
"status": "parsed",
"declaration_count": 1,
"group_counts": {
"runtime": 1
},
"packages": [
"httpx"
]
}
],
"counting_note": "Declaration totals include repeated packages across manifests and dependency groups; unique_declared_package_count deduplicates normalized package names."
},
"environment": {
"local_files": [],
"template_files": [],
"local_configuration_present": false,
"template_present": false,
"values_inspected": false,
"note": "Only environment filenames are reported; diagnoseProject never reads or returns environment values."
},
"validation": {
"execution_policy": "discovery_only",
"execution_note": "diagnoseProject never executes project-owned tests, linters, type checkers, builds, package scripts, hooks, or installers.",
"tests": {
"configured": true,
"status": "configured_not_run",
"tools": [
"pytest"
],
"configs": [
"tests",
"pyproject.toml [tool.pytest]"
],
"commands": [
"python -m pytest"
]
},
"lint": {
"configured": true,
"status": "configured_not_run",
"tools": [
"ruff"
],
"configs": [
"pyproject.toml [tool.ruff]"
],
"commands": [
"python -m ruff check ."
]
},
"type_checking": {
"configured": false,
"status": "not_configured",
"tools": [],
"configs": [],
"commands": []
},
"build": {
"configured": false,
"status": "not_configured",
"tools": [],
"configs": [],
"commands": []
}
},
"version_control": {
"status": "not_repository",
"reason": "Git did not identify a repository for this path."
},
"source_analysis": {
"unused_code": {
"status": "passed",
"candidate_symbols_count": 0,
"candidate_symbols": [],
"interpretation": "Candidates have no statically visible references; review dynamic uses before removal."
},
"circular_imports": {
"status": "passed",
"cycles_count": 0,
"cycles": []
}
},
"file_scan": {
"scanned_file_count": 3,
"maximum_file_count": 5000,
"scan_complete": true,
"error_count": 0,
"large_file_threshold_bytes": 1048576,
"large_file_threshold_formatted": "1.00 MB",
"large_file_count": 0,
"large_files": []
},
"summary": {
"status": "review",
"issue_count": 1,
"informational_count": 0,
"issue_counts_by_severity": {
"high": 0,
"medium": 0,
"low": 1,
"info": 0
},
"issues": [
{
"code": "git_not_detected",
"severity": "low",
"title": "Git repository not detected",
"description": "The inspected path is not inside a Git working tree.",
"remediation": "Use version control for maintained source projects or confirm that this directory is intentionally unversioned."
}
],
"verification": {
"level": "partial",
"release_readiness": "not_assessed",
"verified_areas": [
"technology and manifest discovery",
"dependency declaration inventory",
"Git working-tree state when Git is available",
"static unused-code candidates",
"static circular-import analysis",
"bounded large-file scan"
],
"configured_but_not_run": [
"tests",
"lint"
],
"suggested_commands": [
"python -m pytest",
"python -m ruff check ."
],
"reason": "The command performs read-only inspection and never executes project-owned validation or build scripts."
}
}
},
"report": "PROJECT BRIEFING\nPath: C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\project-doctor\nTechnologies: Python\nDependencies: 1 unique declared package in 1 manifest\nGit: repository not detected\nFile scan: 3 files; complete; 0 larger than 1.00 MB\n\nFINDINGS - Review recommended\n1 issues; 0 informational observations\n1. [LOW] Git repository not detected\n Next: Use version control for maintained source projects or confirm that this\n directory is intentionally unversioned.\n\nVALIDATION - DISCOVERED, NOT RUN\nTests: configured, not run\nLint: configured, not run\nType checks: not detected\nBuild: not detected\n\nReview the project scripts before running these commands.\nRun from: C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\project-doctor\n python -m pytest\n python -m ruff check .\n\nRelease readiness: NOT ASSESSED. Inspection is not a test run.\nUse --json for the full structured evidence and finding descriptions.",
"meta": {
"command": "diagnoseProject",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 138.716,
"schema_version": 1
}
}JSON 結果コントラクトを見る
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"details": {
"type": "object",
"properties": {
"path": [],
"technologies": [],
"dependencies": [],
"environment": [],
"validation": [],
"version_control": [],
"source_analysis": [],
"file_scan": [],
"summary": []
},
"additionalProperties": true
},
"error": {
"type": "string"
},
"report": []
},
"additionalProperties": true
}エラーと制限
公開コントラクトでは失敗時に success=false と説明的な message が必要です。このカタログではまだコマンドごとのエラー分類を宣言していません。結果を確認し、存在しないコードを推測しないでください。
QZX は alpha 段階です。オプション依存関係、権限、ホスト機能によって結果が変わる場合があります。
{
"success": false,
"error": "Path '../artifacts/qzx-evidence/missing-golden-core-path' does not exist.",
"message": "Cannot diagnose the project because '../artifacts/qzx-evidence/missing-golden-core-path' does not exist.",
"meta": {
"command": "diagnoseProject",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 3.356,
"schema_version": 1
}
}取得したコマンド: qzx diagnoseProject ../artifacts/qzx-evidence/missing-golden-core-path --json
証拠フロー: 取得済み・ダイジェストで検証済み。
証拠と出所
- ドキュメントチャネル
- 開発ドキュメント 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- 提供状況
- 0.2.2.0.9 以前
さらに探す
関連コマンド
これらのコマンドも 開発 カテゴリに属します。比較して、タスクに最適な操作を選んでください。