一般的ワークフロー

Qwen Code を用いた一般的なワークフローについて学びましょう。

このドキュメント内の各タスクには、明確な手順、実行例のコマンド、およびベストプラクティスが記載されており、Qwen Code の活用を最大限に支援します。

新しいコードベースを理解する

コードベースの概要を素早く把握する

新しいプロジェクトに参加し、その構造を素早く理解する必要があると仮定します。

1. プロジェクトのルートディレクトリに移動する

cd /path/to/project

2. Qwen Code を起動する

qwen

3. 高レベルな概要を尋ねる

このコードベースの概要を教えてください

4. 特定のコンポーネントについてさらに深く掘り下げる

ここで使われている主要なアーキテクチャパターンを説明してください

主要なデータモデルは何ですか？

認証はどのように処理されていますか？

関連するコードを検索する

特定の機能や動作に関連するコードを特定する必要があるとします。

1. Qwen Code に、関連するファイルを検索してもらいます

ユーザー認証を処理するファイルを検索してください

2. コンポーネント間の相互作用についてコンテキストを取得します

これらの認証関連ファイルはどのように連携して動作していますか？

3. 実行フローを理解します

ログイン処理をフロントエンドからデータベースまで追跡してください

バグを効率的に修正する

エラーメッセージが表示され、その原因を特定して修正する必要があるとします。

1. エラーを Qwen Code と共有する

npm test を実行したときにエラーが発生しています

2. 修正方法の提案を依頼する

user.ts 内の @ts-ignore を修正するためのいくつかの方法を提案してください

3. 修正を適用する

提案された null チェックを user.ts に追加する

コードのリファクタリング

古いコードを現代的なパターンやベストプラクティスで更新する必要があるとします。

1. リファクタリング対象のレガシーコードを特定する

コードベース内で非推奨の API 使用箇所を検索する

2. リファクタリングに関する提案を取得する

utils.js を現代的な JavaScript 機能を用いてリファクタリングする方法を提案する

3. 安全に変更を適用する

動作を維持したまま、utils.js を ES2024 の機能を用いてリファクタリングする

4. リファクタリングを検証する

リファクタリング後のコードに対してテストを実行する

専門化されたサブエージェントの使用

特定のタスクをより効果的に処理するために、専門化された AI サブエージェントを使用したいとします。

1. 利用可能なサブエージェントを表示

/agents

これにより、利用可能なすべてのサブエージェントが表示され、新しいサブエージェントを作成できます。

2. サブエージェントを自動的に使用

Qwen Code は、適切なタスクを専門化されたサブエージェントに自動的に委任します。

最近のコード変更をセキュリティ上の問題についてレビューしてください

すべてのテストを実行し、失敗したものを修正してください

3. 特定のサブエージェントを明示的に要求

auth モジュールのチェックに code-reviewer サブエージェントを使用してください

ユーザーがログインできない理由を調査するために debugger サブエージェントを起動してください

4. ワークフロー向けにカスタムサブエージェントを作成

/agents

その後、「作成」を選択し、以下の項目を定義するためのプロンプトに従ってください。

• サブエージェントの目的を説明する一意の識別子（例：code-reviewer、api-designer）
• Qwen Code がこのエージェントを使用すべきタイミング
• アクセス可能なツール
• エージェントの役割および振る舞いを記述するシステムプロンプト

テストの作業

テストが未カバーのコードにテストを追加する必要があるとします。

1. 未テストのコードを特定する

NotificationsService.swift 内でテストが実行されていない関数を検索する

2. テスト用のスケルトンを生成する

通知サービスのテストを追加する

3. 意味のあるテストケースを追加する

通知サービスにおけるエッジケースのテストケースを追加する

4. テストを実行して検証する

新しく追加したテストを実行し、失敗した場合は修正する

Qwen Code は、プロジェクト内で既に採用されているパターンや規約に従ったテストを生成できます。テストを依頼する際は、検証したい振る舞いについて具体的に指定してください。Qwen Code は既存のテストファイルを分析し、使用されているスタイル、テストフレームワーク、アサーションパターンに合わせてテストを生成します。

包括的なカバレッジを得るために、見落としがちなエッジケースを Qwen Code に特定してもらうよう依頼できます。Qwen Code はコード内の実行パスを分析し、エラー条件、境界値、予期しない入力など、見過ごされがちなテストケースを提案します。

プルリクエストの作成

変更内容を適切に文書化したプルリクエストを作成する必要があるとします。

1. 変更内容を要約する

認証モジュールに対して私が行った変更を要約してください

2. Qwen Code を使用してプルリクエストを作成する

プルリクエストを作成する

3. 確認・改善する

セキュリティ向上に関する追加のコンテキストを含めて、プルリクエストの説明を強化してください

4. テストに関する詳細を追加する

これらの変更がどのようにテストされたかについての情報を追加してください

ドキュメントの作成と管理

コードのドキュメントを追加または更新する必要があるとします。

1. ドキュメントが不足しているコードを特定する

auth モジュール内で適切な JSDoc コメントが付与されていない関数を検索する

2. ドキュメントを生成する

auth.js 内のドキュメントが不足している関数に JSDoc コメントを追加する

3. 確認・改善する

生成されたドキュメントを、より豊富な文脈や使用例を加えて改善する

4. ドキュメントを検証する

ドキュメントがプロジェクトの標準に準拠しているか確認する

参照ファイルおよびディレクトリ

Qwen Code がファイルやディレクトリを読み込むのを待たずに、@ を使用して素早くファイルやディレクトリを含めることができます。

1. 単一ファイルを参照する

@src/utils/auth.js のロジックを説明してください

このコマンドは、対象ファイルの全文を会話に含めます。

2. ディレクトリを参照する

@src/components の構造を教えてください

このコマンドは、ファイル情報付きのディレクトリ一覧を提供します。

3. MCP リソースを参照する

@github: repos/owner/repo/issues のデータを表示してください

このコマンドは、@サーバー: リソース の形式で接続済みの MCP サーバーからデータを取得します。詳細については、MCP を参照してください。

以前の会話を再開する

Qwen Code を使用してタスクを進めており、後続のセッションで中断した場所から作業を再開したい場合があります。

Qwen Code では、以前の会話を再開するための以下の 2 つのオプションが提供されています。

• --continue：最新の会話を自動的に再開
• --resume：会話選択画面を表示

1. 最新の会話を再開

qwen --continue

これは、プロンプトを一切表示せずに直ちに最新の会話を再開します。

2. 非対話モードで再開

qwen --continue --p "私のタスクを継続してください"

--continue と --print（--p）を併用すると、最新の会話を非対話モードで再開できます。スクリプトや自動化処理に最適です。

3. 会話選択画面を表示

qwen --resume

これは、以下を含むクリーンなリスト形式のインタラクティブな会話選択画面を表示します。

• セッションの要約（または初期プロンプト）
• メタデータ：経過時間、メッセージ数、Git ブランチ

矢印キーで移動し、Enter キーで会話を選択します。Esc キーで終了します。

# 最新の会話を再開
qwen --continue
 
# 最新の会話を特定のプロンプトで再開
qwen --continue --p "現在の進捗状況を表示してください"
 
# 会話選択画面を表示
qwen --resume
 
# 非対話モードで最新の会話を再開
qwen --continue --p "テストを再度実行してください"

Git worktree を使用して並列で Qwen Code セッションを実行する

複数のタスクを同時に処理する必要があり、各 Qwen Code インスタンス間で完全なコード分離を確保したいと仮定します。

1. Git worktree の概要を理解する

Git worktree を使用すると、同一リポジトリから複数のブランチを別々のディレクトリにチェックアウトできます。各 worktree は、独立したファイルを持つ独自の作業ディレクトリを持ちますが、同じ Git 履歴を共有します。詳細については、公式 Git worktree ドキュメント  を参照してください。

2. 新しい worktree を作成する

 
# 新しいブランチとともに新しい worktree を作成
git worktree add ../project-feature-a -b feature-a
 
# または、既存のブランチとともに worktree を作成
git worktree add ../project-bugfix bugfix-123

これにより、リポジトリの独立した作業コピーを持つ新しいディレクトリが作成されます。

3. 各 worktree で Qwen Code を実行する

 
# worktree に移動
cd ../project-feature-a
 
# この分離された環境で Qwen Code を実行する
qwen

4. 別の作業ツリーで Qwen Code を実行する

cd ../project-bugfix
qwen

5. 作業ツリーを管理する

 
# すべての作業ツリーを一覧表示
git worktree list
 
# 作業ツリーの完了後の削除
git worktree remove ../project-feature-a

Qwen Code を Unix 風ユーティリティとして使用する

検証プロセスに Qwen Code を追加する

Qwen Code をリンターまたはコードレビュー担当者として使用したいと仮定します。

ビルドスクリプトに Qwen Code を追加します：

// package.json
{
    ...
    "scripts": {
        ...
        "lint:Qwen Code": "qwen -p 'あなたはリンターです。main ブランチとの差分を確認し、タイプミスに関連する問題を報告してください。問題のあるファイル名と行番号を 1 行目に、問題の説明を 2 行目に記述してください。その他のテキストは一切出力しないでください。'"
    }
}

パイプ入力、パイプ出力

Qwen Code にデータをパイプ入力し、構造化された形式で結果を取得したいとします。

Qwen Code を通じてデータをパイプ処理する：

cat build-error.txt | qwen -p 'このビルドエラーの根本原因を簡潔に説明してください' > output.txt

出力形式の制御

Qwen Code の出力を特定の形式で取得する必要がある場合（特に、Qwen Code をスクリプトやその他のツールに統合する際）があります。

1. テキスト形式を使用（デフォルト）

cat data.txt | qwen -p 'このデータを要約してください' --output-format text > summary.txt

これは、Qwen Code のプレーンテキスト形式の応答のみを出力します（デフォルト動作）。

2. JSON 形式を使用

cat code.py | qwen -p 'このコードをバグについて解析してください' --output-format json > analysis.json

これは、コストや処理時間などのメタデータを含むメッセージの JSON 配列を出力します。

3. ストリーミング JSON 形式を使用

cat log.txt | qwen -p 'このログファイルからエラーを抽出・解析してください' --output-format stream-json

これは、Qwen Code がリクエストを処理する際にリアルタイムで一連の JSON オブジェクトを出力します。各メッセージは有効な JSON オブジェクトですが、出力全体を連結したものは有効な JSON にはなりません。

Qwen Code の機能について尋ねる

Qwen Code は、自身のドキュメントに組み込みでアクセスでき、その機能や制限に関する質問に答えることができます。

例となる質問

Qwen Code はプルリクエストを作成できますか？

Qwen Code は権限をどのように扱いますか？

利用可能なスラッシュコマンドは何ですか？

Qwen Code で MCP をどう使えばよいですか？

Amazon Bedrock 用に Qwen Code をどう設定すればよいですか？

Qwen Code の制限事項は何ですか？