开发实践

使用编码助手

组织上下文、规划修改、处理工具审批,并审阅最终代码。

开发者与技术负责人约 6 分钟阅读
操作入口
桌面客户端 → 智能编码;IDE 插件 → 编码与对话
完成结果
从清楚的任务输入推进到可审阅的代码变更与验证结果。
本篇目录

1. 给任务足够的上下文

码哥可以在当前项目中结合文件和对话处理任务。高质量输入应同时说明目标、现状、范围和验收,而不是只写“帮我优化”。不要让它靠猜测决定重要业务规则。

码哥编码任务对话及执行卡片,展示演示任务的回复、代码片段、文件变更和执行详情入口
编码任务界面:任务对话、代码片段与执行记录保留在同一个工作现场,可继续展开执行详情或查看变更。 真实产品界面 · 演示数据
  • 说明当前行为和期望行为,必要时提供最小复现步骤。
  • 引用相关文件或选区,附上完整但已脱敏的错误信息。
  • 写明技术约束,例如沿用现有接口、组件库或目录结构。
  • 列出需要保留的现有改动,以及本次不涉及的功能边界。
任务示例结合实际环境调整
目标:修复保存后列表未刷新的问题。
现象:提交成功,但必须刷新浏览器才能看到新记录。
上下文:表单组件、列表查询逻辑与保存接口。
验收:新增后列表立即显示;失败时保留输入;不重复提交。
请先定位原因,再做最小必要修改。

2. 先理解,再实施

  1. 打开正确的工作区。多根 VS Code 工作区可通过视图标题的「切换项目」确认目标;各项目会话独立保存。
  2. 对跨文件或业务影响较大的任务,先要求说明当前实现、建议改动及验证方法。
  3. 确认计划中的路径、接口与业务规则正确,再进入实现。发现新约束时在同一会话中补充。
  4. 长任务按可验收的阶段推进;每阶段明确已完成内容、检查结果与剩余问题。

3. 理解工具操作与权限

执行工具时,界面可能要求你批准文件、命令或其他操作。授权前先看清目标、具体命令以及它会影响的范围。运行外部命令所需的环境和访问权限仍由你的项目与企业规则决定。

码哥工具调用审批窗口,展示运行测试的命令、项目目录、授权范围和审批按钮
工具调用审批:核对 pnpm run test 命令、项目目录和授权范围,再选择拒绝、允许一次或本次会话全部允许。 真实产品界面 · 演示数据
  • 核对操作发生在正确的项目目录。
  • 涉及依赖、数据库或外部系统时,确认目标环境与影响。
  • 不能理解的操作先要求解释;拒绝后可以补充允许的替代路径。
  • 不要把长期凭据或生产密钥直接粘贴进对话。

4. 审阅修改和验证结果

码哥开发调试界面中的文件树和代码差异示例,具体入口以安装版本为准
代码差异示例(开发调试界面):选定文件后对照修改前后的内容,核对关键逻辑。该图用于说明阅读方式,不代表正式 Git 工作台入口。 真实产品界面 · 演示数据
  1. 使用「修改审阅」查看实际变更,重点核对业务分支、异常处理和原有代码约定。
  2. 检查已执行的编辑,不要把已生效的变更误认为仍在等待确认。
  3. 要求提供实际运行的检查、结果与没有覆盖的场景,并自行复现关键路径。
  4. 需要撤销时先关注未保存编辑和正在运行的任务;在执行前确认不会覆盖自己后续的修改。