常见工作流程

了解使用 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. 理解执行流程

从前端到数据库追踪登录过程

高效修复 bug

假设你遇到了一个错误信息，需要找到并修复其来源。

1. 与 Qwen Code 分享错误信息

运行 npm test 时出现错误

2. 请求修复建议

建议几种修复 user.ts 中 @ts-ignore 的方法

3. 应用修复

更新 user.ts 以添加你建议的 null 检查

重构代码

假设你需要更新旧代码以使用现代模式和实践。

1. 识别需要重构的遗留代码

在我们的代码库中查找已弃用的 API 使用情况

2. 获取重构建议

建议如何重构 utils.js 以使用现代 JavaScript 特性

3. 安全地应用更改

重构 utils.js 以使用 ES 2024 特性，同时保持相同的行为

4. 验证重构结果

运行重构代码的测试

使用专业子代理

假设你想使用专业的 AI 子代理来更高效地处理特定任务。

1. 查看可用的子代理

/agents

此命令会显示所有可用的子代理，并允许你创建新的子代理。

2. 自动使用子代理

Qwen Code 会自动将适当的任务委派给专业的子代理：

审查我最近的代码更改中的安全问题

运行所有测试并修复任何失败

3. 显式请求特定子代理

使用 code-reviewer 子代理检查认证模块

让 debugger 子代理调查用户无法登录的原因

4. 为你的工作流创建自定义子代理

/agents

然后选择“create”，并按照提示定义以下内容：

• 描述子代理用途的唯一标识符（例如，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 提供了两种恢复之前对话的方式：

• 使用 --continue 自动继续最近一次的对话
• 使用 --resume 显示对话选择器

1. 继续最近一次对话

qwen --continue

此命令将立即恢复你最近一次的对话，无需任何提示。

2. 在非交互模式下继续

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

结合使用 --print 和 --continue 可以在非交互模式下恢复最近一次的对话，非常适合用于脚本或自动化流程。

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 用作 linter 或代码审查工具。

将 Qwen Code 添加到你的构建脚本中：

// package.json
{
    ...
    "scripts": {
        ...
        "lint:Qwen Code": "qwen -p '你是一个 linter。请查看与 main 分支的差异，并报告任何与拼写错误相关的问题。在一行中报告文件名和行号，在下一行中描述问题。不要返回任何其他文本。'"
    }
}

管道输入，管道输出

假设你想将数据通过管道传入 Qwen Code，并以结构化格式获取返回的数据。

通过 Qwen Code 传输数据：

cat build-error.txt | qwen -p '简洁地解释此构建错误的根本原因' > 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 有哪些限制？