一般的なワークフロー

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

このドキュメントの各タスクには、明確な手順、コマンド例、およびベストプラクティスが含まれており、Qwen Code を最大限に活用するのに役立ちます。

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

コードベースの概要をすばやく把握する

新しいプロジェクトに参加したばかりで、その構造をすばやく理解する必要があるとします。

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

cd /path/to/project

2. Qwen Code を起動します

qwen

3. 高レベルの概要を求めます

give me an overview of this codebase

4. 特定のコンポーネントについて詳しく調べます

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

関連コードの検索

特定の機能やロジックに関連するコードを探す必要があるとします。

1. Qwen Code に関連ファイルの検索を依頼

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

2. コンポーネント間の相互作用に関するコンテキストを取得

これらの認証ファイルはどのように連携しているのですか？

3. 実行フローを理解

フロントエンドからデータベースまでのログインプロセスをトレースしてください

効率的にバグを修正する

エラーメッセージに遭遇して、その原因を見つけて修正する必要があるとします。

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

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

2. 修正方法の提案を求める

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

3. 修正を適用する

user.ts を更新して、提案された null チェックを追加してください

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

古いコードを現代的なパターンとプラクティスを使用するように更新する必要があると仮定します。

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

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

2. リファクタリングの推奨事項を取得する

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

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

utils.jsをES2024の機能を使用するようにリファクタリングし、同じ動作を維持する

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

リファクタリングされたコードのテストを実行する

専門的なサブエージェントを使用する

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

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

/agents

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

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

Qwen Codeは自動的に適切なタスクを専門的なサブエージェントに委譲します：

最近のコード変更でセキュリティ問題がないかレビューしてください

すべてのテストを実行し、失敗があれば修正してください

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

認証モジュールをチェックするために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 でプルリクエストを生成する

PR を作成してください

3. 確認と修正

セキュリティの改善点に関する詳細なコンテキストを追加して、PR の説明を充実させてください

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 からデータを表示してください

これは、@server: resource の形式を使用して接続された MCP サーバーからデータを取得します。詳細については MCP を参照してください。

以前の会話を再開する

Qwen Codeでタスクに取り組んでいて、後続のセッションで中断したところから作業を続けたい場合があります。

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

• --continue：直近の会話を自動的に継続します
• --resume：会話選択画面を表示します

1. 直近の会話を継続する

qwen --continue

これにより、プロンプトなしで直近の会話を即座に再開できます。

2. 非インタラクティブモードで継続する

qwen --continue --p "Continue with my task"

--continueと--printを一緒に使用すると、非インタラクティブモードで直近の会話を再開でき、スクリプトや自動化に最適です。

3. 会話選択画面を表示する

qwen --resume

これにより、以下の情報を含むインタラクティブな会話選択画面が表示されます：

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

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

# 直近の会話を継続
qwen --continue
 
# 直近の会話を特定のプロンプトで継続
qwen --continue --p "Show me our progress"
 
# 会話選択画面を表示
qwen --resume
 
# 非インタラクティブモードで直近の会話を継続
qwen --continue --p "Run the tests again"

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

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

1. Git worktrees の理解

Git worktrees を使用すると、同じリポジトリから複数のブランチを別のディレクトリにチェックアウトできます。各 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 コードを実行する
qwen

4. 別のワークツリーで Qwen コードを実行する

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 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

Pipe in, pipe out

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

Qwen Code を通じてデータをパイプする:

cat build-error.txt | qwen -p 'concisely explain the root cause of this build error' > output.txt

出力形式の制御

Qwen Code の出力を特定の形式で取得する必要がある場合、特にスクリプトや他のツールに Qwen Code を組み込む際には以下のようにします。

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

cat data.txt | qwen -p 'summarize this data' --output-format text > summary.txt

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

2. JSON 形式を使用

cat code.py | qwen -p 'analyze this code for bugs' --output-format json > analysis.json

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

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

cat log.txt | qwen -p 'parse this log file for errors' --output-format stream-json

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

Qwen Code の機能について質問する

Qwen Code はドキュメントに組み込まれたアクセス権を持っており、自身の機能や制限事項に関する質問に回答できます。

質問例

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

Qwen Code はどのようにパーミッションを処理しますか？

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

MCP を Qwen Code で使用するにはどうすればよいですか？

Amazon Bedrock 向けに Qwen Code を設定するにはどうすればよいですか？

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