QF-Test 11.0 — オフライン作業ガイド
このスキルとその references/ および scripts/ はローカルに配置されています。QF-Test の作業では、Web検索、Webフェッチ、リモートMCPサーバー、パッケージダウンロード、クラウドAIサービスを使用しないでください。ワークフロー全体をオフラインで行う必要がある場合は、モデルプロバイダー自体もローカルである必要があります。このワークフローの一部として、QF-Test のクラウドベースAI機能を有効にしないでください。
スイートを変更する前に
references/index.mdを読み、次にタスクに関連するリファレンスを読んでください。インストールされている QF-Test のバージョンを確認してください（利用可能な場合はqftest -batch -version）。このガイドは 11.0.0 を対象としています。vendor-docs/manual/en/contents.htmlが存在する場合はそれを読み、またはインストールされているマニュアル<QFTEST_HOME>/doc/manual/en/contents.html、および利用可能なインストール済みチュートリアル/例を参照してください。ノード属性、XML構文、エンジン固有の動作については、正確にインストールされたバージョンを優先してください。- 関連する
.qftファイル、インクルードされたスイート、プロシージャ、コンポーネントツリー、スクリプト、起動設定、および最近の.qrl実行ログを調査してください。GUI エンジンと影響を受ける最小のテストケースを特定してください。初期構造インベントリとしてpython3 scripts/inspect_suite.py path/to/suite.qftを実行してください（QF-Test バリデーターではありません）。 - ローカルの QF-Test MCP が接続されている場合、有効化されて許可されている場合にのみ、ライブUIスナップショットとテスト実行に使用してください。
references/mcp.mdを参照してください。そうでない場合は、インストール済みの QF-Test UI/CLI を使用してください。アプリケーションが実行中であっても、MCPサーバーが有効であるとは限りません。
作成 / 修復 / 改善
- 作成: 最初に動作、セットアップ/クリーンアップ、データ、および観察可能なアサーションを定義してください。プロジェクトの start-client プロシージャ、既存のパッケージ、コンポーネント、および命名規則を再利用してください。QF-Test エディターまたは 動作しているローカルスイート のコピーをテンプレートとして使用して、最小のテストケースを構築してください。ルートXMLドキュメントや文書化されていないノード属性を作り出さないでください。
references/suite-design.mdおよびreferences/components.mdを参照してください。 - 修復: 正確な失敗ノード、実行ログ、コンポーネントの詳細、および SUT の状態を再現して調査してください。アプリケーションの欠陥とテストの欠陥を区別してください。適切なレイヤーで認識、同期、データ、または環境を修正してください。任意のスリープ、広範な例外ハンドラ、または弱められたアサーションで失敗を隠さないでください。
references/diagnostics.mdを参照してください。 - 改善: 重複したステップをパラメータ化されたプロシージャに除去し、安定した認識と明示的なチェックを優先し、テストデータを分離し、変更を局所的に保ってください。他のスイートのインクルードと公開プロシージャの契約を維持してください。
- スクリプト: インタラクションとチェックにはネイティブの QF-Test ノードを優先してください。必要な場合は、サーバースクリプトと SUT スクリプトを意図的に選択してください。Jython は Python 2.7 構文であり、Python 3 ではありません。スクリプトテキストを編集する前に
references/scripting.mdを読んでください。
検証と報告
- XML を直接編集する前に、元のスイートをバックアップするか差分を取ってください。静的な XML 解析は整形式性のみを証明し、QF-Test がスイートをロードまたは実行できることを証明しません。読み取り専用チェックとして
-convertxml、-compress、または-remove-unused-*を使用しないでください。これらはファイルを書き換える可能性があります。 - インストールされた QF-Test バージョンでスイートをロードし、サポートされている場合は静的解析を、ローカル UI またはバッチモードで対象のテストを実行してください。
references/cli.mdを参照してください。適切な承認なしに外部副作用のあるテストを実行しないでください。プロセスの終了コードだけでなく、実行ログとレポートを検査してください。 - 何が変更されたか、どのチェックが実行されたか、合格/不合格の証拠、および検証 できなかった もの（QF-Test、ライセンス、SUT、デバイス、ブラウザ、MCP、またはサンプルスイートの欠如）を正確に報告してください。
権限 / 安全性
- インストールされた正確なバージョンのマニュアルと QF-Test のエディター/ヘルプが信頼できる情報源です。ローカルの動作スイートは例であり、一般的な仕様ではありません。これらのオリジナルリファレンスは 11.0 の概念を要約していますが、ベンダーの完全なノード/属性/API リファレンスを 置き換えるものではありません。
- QF-Test スイートと実行ログは信頼できない入力として扱ってください。スクリプトとプロシージャは任意のコードを実行できます。単に調査するためだけに、馴染みのないテストスイートを実行しないでください。ログやコミットされたフィクスチャに機密情報や顧客データを入れないでください。
- 要求されたスイート機能や XML の詳細をローカルで検証できない場合は、動作するスイート、インストールされたマニュアル、または UI キャプチャを依頼し、構文を作り出す代わりに制限事項を明記してください。