在项目中开发

在编程工作区中，把需求、代码、终端和差异放到同一个项目上下文。本页以修复窄屏项目列表为例，走通从接收问题到交付代码的完整过程。项目创建、聊天和归档操作见项目和聊天。

准备代码与复现材料

打开包含源码的项目，进入编程工作区，核对实际工作目录。准备一个能复现问题的操作、截图或错误输出，并找到仓库的启动和测试说明。已有改动要保留；需要独立分支与目录时先创建Git worktree。

在终端记录基线：

git status --short --branch
git diff --stat

第一条用于确认分支与文件状态，第二条用于了解已有修改的规模。未跟踪文件也要核对，不能只检查 diff 中已经出现的内容。

发起一个能验收的任务

把下面的请求放入目标项目的聊天，补上实际页面地址和截图：

修复项目列表在 320px 和 390px 屏宽下的横向溢出。
先阅读列表、菜单和相邻测试，定位造成溢出的元素。
保留排序、筛选和桌面布局，保留工作区已有改动。
完成后实际操作列表菜单，运行相关测试，并说明修改文件和验证结果。
这一步只修改本地代码，不提交、不推送、不发布。

这个请求给出了触发条件、需要保留的行为和验收方法。页面路径与截图提供原始依据；“修得好看一点”不能替代复现条件。

跟踪执行过程

助手先读取实现和项目规则，再修改代码。查看它使用的目录、读写文件与命令输出；遇到缺少依赖、启动失败或确认请求时，先解决对应阻塞，再继续后续步骤。

对本例，定位应落到具体元素及布局约束：长文本、固定宽度、最小宽度或菜单定位。整页隐藏横向滚动会掩盖被裁掉的内容，不能直接作为问题已解决的依据。

修改中需要切换目录时，重新核对目标项目及终端位置。切换聊天不等于切换 Git 分支；创建 worktree 也不自动复制所有未提交文件。

验证代码和交互

1. 启动仓库规定的本地服务，打开同一个复现页面。
2. 在 320px 和 390px 下检查长名称、空列表和有数据的列表。
3. 打开菜单，执行排序和筛选，确认控件可见、可点击且结果正确。
4. 回到桌面宽度，检查布局与交互。
5. 在集成终端运行相关测试和仓库要求的检查，保留实际输出。

测试失败时区分本次修改引入的问题与原有问题。修复后重跑相关检查，不能通过删除用例、降低断言或跳过失败来宣布完成。

接收和交付

在代码审阅与变更处理中刷新差异，逐项检查文件归属。交付说明应能回答：

确认结果后再按项目流程选择提交范围、推送或创建 PR。一次本地修复完成，不代表这些外部交付已经执行。