一般的なワークフロー

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 に関連ファイルの検索を依頼する

find the files that handle user authentication

2. コンポーネント間の連携に関するコンテキストを取得する

how do these authentication files work together?

3. 実行フローを理解する

trace the login process from front-end to database

バグを効率的に修正する

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

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

I'm seeing an error when I run npm test

2. 修正方法を提案してもらう

suggest a few ways to fix the @ts-ignore in user.ts

3. 修正を適用する

update user.tsto add the null check you suggested

コードをリファクタリングする

古いコードを最新のパターンやプラクティスに合わせて更新する必要があるとします。

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

find deprecated API usage in our codebase

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

suggest how to refactor utils.js to use modern JavaScript features

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

refactor utils.js to use ES 2024 features while maintaining the same behavior

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

run tests for the refactored code

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

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

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

/agents

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

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

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

review my recent code changes for security issues

run all tests and fix any failures

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

use the code-reviewer subagent to check the auth module

have the debugger subagent investigate why users can't log in

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

/agents

「create」を選択し、プロンプトに従って以下を定義します。

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

テストを活用する

カバレッジが不足しているコードにテストを追加する必要があるとします。

1. テストされていないコードを特定する

find functions in NotificationsService.swift that are not covered by tests

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

add tests for the notification service

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

add test cases for edge conditions in the notification service

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

run the new tests and fix any failures

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

包括的なカバレッジを確保するには、見落としがちなエッジケースを Qwen Code に特定してもらいます。Qwen Code はコードパスを分析し、エラー条件、境界値、予期しない入力など、見落としがちなテストを提案できます。

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

変更内容に対して、適切にドキュメント化されたプルリクエストを作成する必要があるとします。

1. 変更内容を要約する

summarize the changes I've made to the authentication module

2. Qwen Code でプルリクエストを生成する

create a pr

3. レビューして改善する

enhance the PR description with more context about the security improvements

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

add information about how these changes were tested

ドキュメントを管理する

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

1. ドキュメント未記載のコードを特定する

find functions without proper JSDoc comments in the auth module

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

add JSDoc comments to the undocumented functions in auth.js

3. レビューして改善する

improve the generated documentation with more context and examples

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

check if the documentation follows our project standards

ファイルとディレクトリを参照する

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

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

Explain the logic in @src/utils/auth.js

これにより、ファイルの全内容が会話に含まれます。

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

What's the structure of @src/components?

これにより、ファイル情報を含むディレクトリ一覧が提供されます。

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

Show me the data from @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"

--print と --continue を組み合わせて使用すると、スクリプトや自動化に最適な非インタラクティブモードで最新の会話が再開されます。

3. 会話選択ツールを表示する

qwen --resume

これにより、以下の情報を表示するクリーンなリストビュー形式のインタラクティブな会話選択ツールが表示されます。

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

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

# Continue most recent conversation
qwen --continue
 
# Continue most recent conversation with a specific prompt
qwen --continue --p "Show me our progress"
 
# Show conversation picker
qwen --resume
 
# Continue most recent conversation in non-interactive mode
qwen --continue --p "Run the tests again"

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

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

1. Git worktrees を理解する

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

2. 新しい worktree を作成する

# Create a new worktree with a new branch
git worktree add ../project-feature-a -b feature-a
 
# Or create a worktree with an existing branch
git worktree add ../project-bugfix bugfix-123

これにより、リポジトリの別の作業コピーを含む新しいディレクトリが作成されます。

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

# Navigate to your worktree
cd ../project-feature-a
 
# Run Qwen Code in this isolated environment
qwen

4. 別の worktree で Qwen Code を実行する

cd ../project-bugfix
qwen

5. worktree を管理する

# List all worktrees
git worktree list
 
# Remove a worktree when done
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.'"
    }
}

パイプ入力とパイプ出力

Qwen Code にデータをパイプで渡し、構造化された形式でデータを受け取りたいとします。

Qwen Code を介してデータをパイプする:

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

出力形式を制御する

特に 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 はドキュメントへの組み込みアクセス権を持ち、自身の機能や制限に関する質問に回答できます。

質問の例

can Qwen Code create pull requests?

how does Qwen Code handle permissions?

what slash commands are available?

how do I use MCP with Qwen Code?

how do I configure Qwen Code for Amazon Bedrock?

what are the limitations of Qwen Code?