AI BRIEF
捕捉变化,读懂下一步。
← 实战简报
FIELD NOTES / 001 · 首期公开

让 AI 接手旧项目,第一步怎么走?

先选工作方式,再交付一个小改动。用一份可下载的任务包,练习给上下文、设边界、看差异与做验收。

2026-10-30AI Brief 编辑 · AI 辅助整理
本期带走
  1. 选出适合自己的协作方式
  2. 写出有边界的任务说明
  3. 留下能复查的改动与记录
先给结论

先让 AI 修一个你能判断对错的问题。看得懂改动、能说明验收,再扩大任务范围。

方法与练习样刊 · 尚未进行产品对比实测

01

先判断:你要把哪一段工作交出去?

面对旧项目,最难的往往不是让 AI 写出代码,而是让它理解已经存在的约束:数据格式、启动方式、调用关系,以及哪些行为不能变。把整个项目交过去,再说一句“帮我优化”,很难得到可验收的结果。

本期建议先选一个小问题:输入已知,预期输出明确,只涉及少量文件。把环境准备和任务执行分开记录。一次练习能帮助你发现协作成本,但不足以证明某款工具整体更强。

02

三种工作方式,按你的审查习惯选

这是协作方式的划分,并不是产品能力排名。一款工具可能覆盖多种方式;开始前还要核对你自己的版本、账号权限和项目要求。

01

编辑器内协作

你希望边读代码、边看差异、边调整。

先圈定相关文件,让助手说明修改计划,再接受一小段改动。

留意
上下文是否选对;是否改了无关文件。
文档参考:Cursor Agent [1] ↗
02

终端内协作

你熟悉项目命令,也能判断命令的作用。

先说明目录、运行方式和允许操作;把探索、计划、修改分开。

留意
命令权限、工作目录和任务边界。
文档参考:Claude Code [2][3] ↗
03

委派任务,再审查 PR

仓库任务可以写清楚,你愿意稍后集中审查。

写明复现步骤与验收条件;审查提出的 PR,反馈后再决定是否合并。

留意
自动执行记录、改动范围、检查结果与遗留问题。
编辑建议 · 代码审查方法参考 [4] ↗
03

选一条你的试跑路线

三项选择,只按明确规则给出起步建议。它不预测模型表现,也不替你决定买哪款产品。选择只在当前页面使用。

你的起步路线

04

跟着做:修一个“跨日”问题

下载包里有一个刻意保留错误的 Python 小项目:从 JSON 读取任务,并按指定日期筛选。当前代码直接取原始时间戳的日期,没有先转成北京时间,所以部分 UTC 时间会被归到前一天。它是教学材料,不是生产代码,也不是某款 AI 工具的评测结果。

例如 b01 的原始时间是 2026-10-30T16:30:00+00:00,换成北京时间应是 10 月 31 日 00:30。你要让 AI 修复日期筛选,再单独添加状态筛选。固定日期只用于这份练习数据,与网站日常新闻抓取无关。

  1. 准备一份独立副本

    解压下载包,保留 starter 原件,复制一份用于练习。需要本机 Python 3.10 或更新版本;项目只使用标准库,没有依赖安装步骤。

  2. 先让助手解释,再让它修改

    给出 TASK.md 和相关文件,让助手定位时间处理逻辑、复述预期行为与修改范围。先完成日期修复,再处理 --status 参数。

  3. 照验收条件看输出

    检查 10 月 31 日应包含 b01、b03,筛选 open 后只包含 b01;11 月 1 日应包含 b04。无日期任务不应混入结果。命令和完整边界写在 ACCEPTANCE.md。

  4. 留下证据,再决定下一步

    看最终差异,记录耗时、人工纠正次数、通过和未通过的条件。能稳定说明这次改动,再换一个真实项目的小任务。

05

复制这段,开始第一轮协作

把下面的模板连同任务文件给助手。使用真实项目时,替换目录、行为和允许范围,避免把练习里的日期直接带过去。

TASK / 001
请先阅读 TASK.md、ACCEPTANCE.md 和 starter 中的文件,只分析,不修改。

目标:按北京时间正确筛选日期;日期问题验收后,再添加 --status open|done|all,默认保持 all。
约束:不添加第三方依赖,不修改原始 tasks.json;保留现有 JSON 输出结构;只改这份练习副本。

先给我:
1. 你理解的错误原因和相关文件;
2. 分两步实施的计划与影响范围;
3. 你准备如何核对验收条件,以及需要我确认的环境或命令。

我确认计划后再修改。结束时列出改动、实际执行的命令与结果、尚未核对的项目;不要把预期输出写成已经通过。

06

交付前,过一遍这六项

勾选只用于整理你的审查,不代表本站替你验收。刷新页面会重置,不上传或同步。

07

比较自己的结果,不急着给产品排座次

如果你想试两款工具,每次从同一份未修改副本开始,使用相同任务、输入和验收条件。记录工具、模型、版本或日期、权限、上下文、实际时间和人工干预,而不是只比较它们自报的“已完成”。

先回答实际决策:哪种方式让你更容易发现错误?哪些上下文必须补充?下一次是否敢把稍大一点的任务交出去?一次练习中的差异可能来自提示词、环境或操作者熟练度,不能直接归因为模型能力。

下载包中的 runs.csv 保持空白,供你填写真实结果。本期没有跑分表、胜负结论或效率承诺;后续如发布对比实测,将同时提供任务、环境、原始结果和失败记录。

08

把材料带走,现在就能开始

ZIP 内含中英文说明、教学代码和空白记录表。无需登录;本站不上传你的代码,也不记录你的练习答案。

下载完整练习包 · ZIP ↓

练习包 v1.0 · Python 3.10+ · 不含实测结果或第三方依赖。

09

来源与边界

以下是已阅读的官方文档及本期引用范围,核对日期为 2026-10-30。产品文档会变化;它们描述工作方式,不构成跨产品性能证明。

  1. Plan Mode | Cursor Docs ↗

    Cursor 的 Plan Mode 会研究代码库并生成可审阅的计划,确认后再进入构建。这支持本期“先说明计划,再做改动”的工作方式例子。

    属于 Cursor 的官方流程说明,不证明代码正确性,也不是跨工具性能比较。
  2. Best practices for Claude Code - Claude Code Docs ↗

    文档建议提供具体约束与验证方式,保持项目指引简洁,并对照规格审查结果。提示内容与可执行的约束机制需要区分。

    建议与机制针对 Claude Code;写进提示词不等于保证每次执行。
  3. Configure permissions - Claude Code Docs ↗

    Claude Code 有 allow、ask、deny 权限规则,按 deny、ask、allow 的顺序判断。权限由工具执行层处理,提示词或 CLAUDE.md 不会授予或撤销访问。

    具体可用模式依环境和设置而变;本期不建议跳过权限确认。
  4. Reviewing and Testing Code | Cursor Learn ↗

    官方教程建议查看差异并审查生成代码,留意遗漏的边界、重复逻辑和安全问题。本期把审查作为所有工作方式的共同步骤。

    仅引用审查方法;文中的通用 PR 路线属于本站编辑建议,不宣称该页面证明某项 PR 产品能力。
本期任务、提示词和规则式路线为本站编辑设计。没有将文档阅读写成实测,没有使用产品分数、排名或未经验证的速度结论。
来源摘要与历史资料分级展示;模型目录暂停评分
本站使用 AI 辅助整理;来源声明不等于独立验证。历史资料请留意核验状态。
RSS · 邮件版 · 归档 · 评分历史 · 搜索 · 知识库 · 关于