QuickEngineering ユーザーガイド
QuickEngineering は、目標を明示的なタスク・指示・作業者・入力・結果・レビュー・公開可能な成果物がつながったフローへと変換します。
使いはじめる
- プロジェクトを作成し、ファイルやコードが必要なフローの場合のみワークスペースを選びます。
- フローを作成し、明示的な Instructions と Result 名を持つタスクを追加します。
- 各タスクに Agent を選び、前の結果を後続の入力へマッピングします。
- 影響の大きさに応じて、レビュー・ヒューマン・データ送信・予算・公開のゲートを追加します。
- フローを実行し、Runs と Agent Queue を追い、Artifacts と History を確認します。
ヒント: 下流のマッピングが理解しやすいよう、すべての Result にわかりやすい名前を付けましょう。
画面の構成
| 領域 | 役割 |
|---|---|
| プロジェクト | フロー、成果物、スナップショット、インポート、ゴミ箱をまとめる .qeng ソースコンテナです。 |
| フローエディタ | タスクグラフ、マッピング、条件、コントラクト、ゲート、予算、実行の起点。 |
| プロンプトワークスペース | プロンプト、変数、バリアント、マトリクス、評価、再利用可能なアセット。 |
| Runs と Agent Queue | 実行、承認、クレーム済みタスク、進捗、リトライ、レビュー、最終状態。 |
| Artifacts と History | 型付き出力、バージョン、系譜、コメント、差分、ロールバック、エクスポート、公開、監査。 |
Task → Instructions → Agent → Result
フローエディタは、各タスクの目的・プロンプト・作業者・入力コントラクト・出力コントラクト・レビュー境界を、1つのチャットに埋もれさせず常に見える形で保ちます。
- フローエディタ: タスク、入力、結果、マッピング、コントラクト、条件、予算、ゲートをつなぎます。
- プロンプトワークスペース: 再利用可能なプロンプト、変数、バリアント、マトリクス、評価、バージョン管理されたプロンプトアセットを管理します。
- Agent ルーティング: System AI、ローカルモデル、MCP エージェント、設定済みのクラウドプロバイダ、または人によるステップを使い分けます。
- 永続的な Run: 待機中・実行中・一時停止・待ち・失敗・レビュー済み・完了の作業を、リトライ境界とともに追跡します。
- Agent Queue と MCP: スコープを限定した外部エージェントに作業をクレームさせ、コンテキストを渡し、進捗と結果を受け取ります。
- 成果物とレビュー: 型付き出力、系譜、バージョン、コメント、差分、ロールバック、エクスポート、公開、監査履歴を保持します。
注意: 外部エージェント、プロバイダ、コマンド、接続済みサービスはファイルやシステムに影響を与える可能性があります。承認の前にスコープ、送信先、出力を確認してください。
設定
設定を開くと、このアプリ固有の次の項目を確認できます。
- Agent、AI プロバイダ、接続、MCP Host、ワークスペース権限
- 承認、データ送信、予算、レビュー、公開の各ポリシー
- キーボードショートカット、外観、診断、復旧
- プロジェクト、成果物、トリガー、Knowledge、Agent Memory の挙動
トライアル、Free、Pro の機能は同じです。Pro ではモバイル広告と、デスクトップで 1 日 1 回表示される支援のお知らせが表示されなくなります。
キーボードショートカット
Apple プラットフォームでは、表示上 Ctrl のショートカットがプラットフォーム標準の修飾キーに割り当てられるため、Command を使用します。アプリ内のショートカット一覧が常に正となります。
| ショートカット | 操作 |
|---|---|
| F2 / Enter | 選択中のプロンプト変数項目の名前を変更または編集します |
| F4 | 選択中のプロンプト変数のパスモードを切り替えます |
| Tab / 右矢印 | 次のプロンプト変数セグメントへ移動します |
| 左矢印 | 前のプロンプト変数セグメントへ移動します |
| Escape | インラインのプロンプト編集をキャンセルします |
| 設定 > キーボードショートカット | 現在登録されているグローバル操作を確認します |
ヒント & コツ
下流のマッピングが理解しやすいよう、すべての Result にわかりやすい名前を付けましょう。
まずは System AI と短い手動フローから始め、その後に外部 Agent やトリガーを追加しましょう。
エージェントのワークスペース直接アクセスがプローブを通らない場合は、VFS 経由または Patch のみのアクセスを使ってください。
シークレットは参照のまま保持し、外部送信の前に Data Send Preview を確認しましょう。
トラブルシューティング
| 症状 | 確認すること |
|---|---|
| Agent が利用できない | Agents と Connections を開き、インストール、ログイン、配信モード、リスナー、ワークスペース、プローブの状態を確認してください。 |
| Run が待機している | そのタスクのステータス、承認、データ送信レビュー、ヒューマンゲート、予算、不足している入力を確認してください。 |
| 結果を適用できない | 成果物のコントラクト、ソースのリビジョン、ワークスペースの機能、Review/Gate の判断を確認してください。 |
| バックグラウンドリスナーがタスクをクレームしない | MCP Host、プロジェクトのルーティング、リスナープロセス、正確な Agent、現在のワークスペースパスを確認してください。 |
プライバシー
- シークレットは展開されたプロジェクトテキストではなく参照のまま保持されます。
- Data Send Preview は、外部送信の前に送信先と選択されたペイロードを表示します。
- Agent と MCP のアクセスはスコープが限定され、機能テストを経て、レビュー境界を通してルーティングされます。
- Audit History は、生の資格情報を意図的に露出させることなく判断と結果を記録します。
ご利用にあたって: 承認済みのプロバイダ、ワークスペース、ホスト、アカウント、ツールのみを使用し、承認・監査・安全管理を迂回しないでください。