常见开发任务

​

概述

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

所有示例都在交互模式下进行。启动方式见 使用 CLI。

​

探索与理解代码

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

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

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

​

修复缺陷

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

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

一个稳妥的做法是让 Qoder 先复现问题、说明原因，再动手修改。对于影响面较大的问题，可以先用 Plan 确认方案，见 先规划再执行（Plan）。

​

重构

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

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

重构前后建议配合测试和代码审查确认行为没有改变，见 查看和审查代码改动。范围较大的重构适合用 Plan 先规划。

​

实现功能

从需求出发让 Qoder 编码：

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

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

​

编写与运行测试

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

让 Qoder 在写完代码后主动运行测试，可以形成”实现—验证—修正”的闭环。想让它持续修到全部通过，可以用 Goal，见 持续完成目标（Goal）。

​

提交与 PR

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

涉及 Git 操作时，Qoder 会在执行前根据权限设置请求确认。权限控制见 权限。

​

代码审查

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

审查我当前的改动，找出潜在问题
对比 main 分支，审查这个功能分支

也可以直接用 /review 选择审查范围，见 查看和审查代码改动。

​

小贴士

• 描述清楚目标和约束：说明你想要什么、不希望改动什么，能显著提升结果质量。
• 一次聚焦一件事：复杂任务拆成几步，比一次性描述所有需求更可控。
• 善用项目说明：把项目约定写进 AGENTS.md，Qoder 会在每次会话中遵守，见 记忆。
• 大型代码库：针对大仓库和 Monorepo 的做法，见 最佳实践与大型代码库。