> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见开发任务

# 概述

这篇文档汇总了用 Qoder CLI 处理日常开发工作的常见做法——从探索陌生代码、修复缺陷、重构，到写测试、提交和审查。每一类都给出可以直接照着说的提示词示例，你可以在此基础上按自己的项目调整。

所有示例都在交互模式下进行。启动方式见 [使用 CLI](https://docs.qoder.com/zh/cli/03-使用QoderCLI/01-开始一个任务/using-cli.md)。

# 探索与理解代码

面对陌生的代码库时，先让 Qoder 帮你建立整体认识：

```text theme={null}
帮我梳理这个项目的整体架构和主要模块
这个功能是在哪里实现的？涉及哪些文件？
从入口开始，讲清楚一次请求是怎么被处理的
这个函数被哪些地方调用？
```

Qoder 会自主搜索代码、读取相关文件，并给出带有文件位置的解释。你可以顺着它的回答继续追问，逐步深入。

# 修复缺陷

描述现象，让 Qoder 定位并修复：

```text theme={null}
这个测试为什么失败？帮我修复它
运行 npm test，找出报错原因并修复
这个接口在并发下会偶发报错，帮我排查
```

一个稳妥的做法是让 Qoder 先复现问题、说明原因，再动手修改。对于影响面较大的问题，可以先用 Plan 确认方案，见 [先规划再执行（Plan）](https://docs.qoder.com/zh/cli/03-使用QoderCLI/01-开始一个任务/plan.md)。

# 重构

重构往往涉及多个文件，描述清楚目标和约束：

```text theme={null}
把 utils 里的日期处理函数抽成独立模块，并更新所有引用
统一这个目录下的错误处理方式，保持对外行为不变
给这些回调改造成 async/await，注意不要改变逻辑
```

重构前后建议配合测试和代码审查确认行为没有改变，见 [查看和审查代码改动](https://docs.qoder.com/zh/cli/03-使用QoderCLI/04-管理会话和改动/review.md)。范围较大的重构适合用 Plan 先规划。

# 实现功能

从需求出发让 Qoder 编码：

```text theme={null}
实现一个 Express 中间件，做请求频率限制
按这个接口文档，补全对应的客户端方法
给这个页面加上表单校验和错误提示
```

Qoder 支持多模态输入。你可以附加设计稿或截图，让它据此生成代码。

# 编写与运行测试

```text theme={null}
给这个模块补充单元测试，覆盖主要分支
为刚才的改动写一个回归测试
运行测试并修复失败的用例
```

让 Qoder 在写完代码后主动运行测试，可以形成"实现—验证—修正"的闭环。想让它持续修到全部通过，可以用 Goal，见 [持续完成目标（Goal）](https://docs.qoder.com/zh/cli/03-使用QoderCLI/02-任务自动化/goal.md)。

# 提交与 PR

```text theme={null}
帮我生成这次改动的提交信息
把相关改动分成几个语义清晰的提交
总结这个分支相对 main 的改动，写一段 PR 描述
```

涉及 Git 操作时，Qoder 会在执行前根据权限设置请求确认。权限控制见 [权限](https://docs.qoder.com/zh/cli/06-配置与安全/permissions.md)。

# 代码审查

在提交前对改动做一次审查：

```text theme={null}
审查我当前的改动，找出潜在问题
对比 main 分支，审查这个功能分支
```

也可以直接用 `/review` 选择审查范围，见 [查看和审查代码改动](https://docs.qoder.com/zh/cli/03-使用QoderCLI/04-管理会话和改动/review.md)。

# 小贴士

* **描述清楚目标和约束**：说明你想要什么、不希望改动什么，能显著提升结果质量。
* **一次聚焦一件事**：复杂任务拆成几步，比一次性描述所有需求更可控。
* **善用项目说明**：把项目约定写进 `AGENTS.md`，Qoder 会在每次会话中遵守，见 [记忆](https://docs.qoder.com/zh/cli/04-扩展QoderCLI/memory.md)。
* **大型代码库**：针对大仓库和 Monorepo 的做法，见 [最佳实践与大型代码库](https://docs.qoder.com/zh/cli/03-使用QoderCLI/05-优化使用体验/best-practices.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.