开发实践

项目与文件上下文

打开正确的工作目录,用文件引用和清晰的边界帮助码哥理解任务。

在本地项目中开展编码工作的成员约 5 分钟阅读
操作入口
桌面端 → 智能编码 → 添加项目;输入框 → @ 引用工作区文件
完成结果
任务绑定正确项目,引用文件可定位,目标与验收条件明确。
本篇目录

1. 确认任务在哪个项目执行

项目目录决定编码任务可读取的文件和执行命令的位置。桌面端的「Code / 智能编码」按项目组织本机会话;插件使用宿主当前选定的项目。需要访问其他电脑时,使用独立的「协同」入口,先选择执行电脑,再选择其工作区。名称相似时,应同时核对电脑和实际路径。

  1. 本机工作选择「Code / 智能编码 → 添加项目」,在文件夹选择器中选中项目根目录。
  2. 点击侧栏项目可切换工作目录与对应会话,折叠按钮独立控制展开。新会话首页也可先填写任务、选择项目和获授权模型,核对后开始。
  3. 在对应项目旁新建会话,再发送任务;继续旧会话时确认其所属项目。客户端重启会按当前账号恢复上次项目与会话,仍应核对文件是否已变更。
  4. VS Code 多根工作区通过视图标题「切换项目」选择目标,各项目会话独立保存。

2. 引用与问题直接相关的文件

  1. 在编码输入框中输入 @,继续输入文件名或路径,从候选列表选择工作区文件。
  2. 涉及多个模块时,分别引用调用方、实现文件和相关测试;不要用大量无关文件替代任务说明。
  3. IDE 中可选中代码后使用码哥右键动作,将局部问题带入对话。
  4. 发送前核对文件引用与选区是否仍对应当前版本,删除无关或误选内容。

3. 把上下文变成可执行的输入

文件提供实现细节,任务描述提供目标与判断标准。先说明现象、期望结果和限制;业务规则不明确时,让码哥先提出问题。跨模块修改先要求解释现状与计划,确认后再实施。

码哥编码任务对话及执行卡片,展示演示任务的回复、代码片段、文件变更和执行详情入口
编码任务对话与执行记录示例:任务说明、代码片段和文件变更在同一会话中展示,可用于核对实际处理内容。 真实产品界面 · 演示数据
任务示例结合实际环境调整
项目:当前已打开的客户门户。
现象:提交成功后列表仍显示旧内容。
相关文件:@列表页面 @保存接口调用 @页面测试
范围:保留现有接口与分页规则,不调整权限逻辑。
验收:新增记录立即可见;失败保留输入;不会重复提交。
请先定位原因,并说明准备修改的文件。

4. 判断上下文是否有效

找不到文件时,先确认项目选择和目录权限,再尝试更完整的文件名。发现回复针对错误项目,停止继续修改,重新打开正确会话并补充路径。长任务更换主题时,新建会话并附上已有结论、必要文件和剩余目标,避免无关历史持续干扰。

  • 回复中指出的路径、入口和调用关系与项目一致。
  • 建议检查命令来自当前项目配置,而非默认猜测。
  • 遇到缺失资料时明确列出问题,未擅自补造业务规则。