START SMALL
马上使用 AI
简单任务直接做,只有风险上升时才增加结构
先选任务强度,再发出清楚的指令;不把简单问题变成流程工程。
读完得到一条边界清晰的任务指令,以及继续执行或停下来确认的判断。
查看全栈 46 节内容对照 ↗01 · 马上使用 AI
这是一份按任务使用的手册,不需要从头学习
默认原则只有一句
能直接说明就直接说明,只有风险上升时才增加结构
先理解任务强度和交付判断。
1 使用判断
1.1 从写代码到推动交付的五种判断
先问清用户问题,再拆需求和非目标,再看懂系统关系,然后跨栈实现,最后验证与交付。AI 能加速整理、解释、生成草稿和补漏,但不能替团队决定用户价值、风险底线和上线责任
前端补后端时重点看数据归属、状态、幂等和排障;后端补前端时重点看用户下一步、等待反馈、失败恢复和布局稳定。独立交付不是独自精通所有岗位,而是在缺少某个角色时仍知道下一步该确认什么,并能把专业判断交给合适的人
先用最小纵向切片串起入口、数据与结果,再根据真实风险扩展;不要因 AI 能很快生成就提前引入队列、微服务或大型框架。原型、可用功能、验收通过和生产可用分别判断
- 两分钟能说清的任务,不创建模板
- 一段文字能说明的任务,不创建新文件
- 项目原生能力可以完成的事,不再造工作流
- 没有执行证据的结论,不写成已经通过
- 没有真实数据前,不宣称已经提效
这套手册的目标不是让团队遵守更多流程,而是让简单任务更快完成,让高风险任务少返工
2 先判断任务大小
| 任务 | 默认做法 | 增加流程的条件 |
|---|---|---|
| 小修改 | 直接告诉 AI 问题、位置和预期 | 影响共享规则或修改范围扩大 |
| 普通功能 | 说明目标、范围和完成条件 | 涉及多个入口、角色或写操作 |
| 高风险交付 | 固定需求、测试范围和证据 | 数据、权限、金额、批量操作或发布 |
大多数日常任务不需要 AI-TASK、CONTEXT 和 AI-RESULT 三份文件
需要长期保留的事实写进现有需求、Bug、代码、测试或项目说明
按小改、普通功能、高风险任务选择指令,再走完已有名单案例。
3 小修改直接这样说
这个按钮点击后没有反馈
目标页面:PAGE_PATH
相关代码:FILE_OR_MODULE
预期:点击后进入提交中,成功后显示结果,失败后保留输入
先复现问题
只修改直接相关代码
完成后运行最小相关测试并告诉我仍未验证什么
如果 AI 已经能读取项目,不需要再复制项目背景和整本手册
4 普通功能只补四项
目标
用户最终要完成什么
范围
这次包含什么,不包含什么
完成条件
页面、请求、刷新后分别应得到什么结果
验证
需要运行哪些已有测试和页面检查
示例
为活动报名增加防重复提交
范围
只处理活动详情中的报名提交和刷新回显
不处理活动创建、支付和通知
完成条件
快速连点只产生一次请求
失败后可以重试
刷新后显示最终报名状态
先检查现有实现和测试
做最小修改并运行直接相关验证
5 只有高风险任务才升级
出现以下任一条件时,再固定任务说明和证据
- 改动权限、金额、名额或重要数据
- 同时影响多个用户入口
- 失败可能产生重复写入或数据污染
- 多人或多个 AI 同时修改
- 需要正式提测、产品验收或发布
- 规则存在争议,需要保留决策记录
高风险任务也只需要一份现有任务单
# 任务
- 目标
- 范围内
- 范围外
- 已确认规则
- 待决定问题
- 完成条件
- 必须验证
不要为每次执行再创建上下文文件和结果文件
AI 的结果直接写回任务单、Bug 单、代码评审或测试记录
6 三个角色的最短入口
6.1 产品
把下面想法整理成一页需求
只追问会改变用户结果的问题
区分已确认规则和待决定问题
最后生成可以执行的验收标准
6.2 开发
读取当前需求和相关代码
先说明最小修改范围
实现后运行已有相关测试
同时检查用户结果、业务状态和禁止副作用
输出修改、验证和未验证项
6.3 测试
根据当前需求和提测版本
列出最小必要场景
优先覆盖主路径、边界、失败恢复和重复操作
执行后按通过、失败、阻塞、未验证输出
7 用一条已有功能走完交付判断
以接龙大师已有的“指定部门保存与回显”为练习对象,先读参与名单合同和选择器调用链。目标是保存后重新进入仍显示用户明确选择的部门;不是新增组织管理系统。这是一份操作方法,不是本轮项目测试通过声明
- 理解问题。 构造成员甲同时属于 A、B 两部门的匿名测试数据,只选择 A。先写下预期“重进仍只选 A”,让 AI 说明为什么不能从成员重叠反推 B
- 限定切片。 沿选择器、提交参数、持久字段和重新编辑的恢复逻辑查真实入口。只修第一次偏离合同的位置;若现有实现已经正确,就记录证据,不为完成练习制造改动
- 分别验结果。 页面勾选正确、提交保存的 ID 正确、重新读取正确是三个观察点;再检查普通成员身份和其他名单来源未受影响。逻辑测试不能代替微信中的实际操作
- 形成交接。 让 AI 交付改动及实际运行结果,明确源码版本、未执行项和发布状态。上线后再按已授权范围核对发布版本与相同用户路径,不能把本地通过自动升级为线上通过
前端关心用户是否能继续,后端关心保存的是不是正确事实,测试关心反例能不能暴露错误。AI 可以协助三个阶段;负责人用合同和证据决定是否完成。后续技术细节分别查后端交付、底座与组件和验收测试,不在入门章重复铺开
最后核对完成报告与需要补充信息的条件。
8 AI 只需要回答四件事
日常任务完成后默认输出
做了什么
验证了什么
还没验证什么
下一步需要谁处理
没有跨角色交接时,不要求额外状态码或结果合同
9 什么时候应该停下来问人
- 需求有两种合理解释
- 修改会超出当前范围
- 缺少账号、数据或运行环境
- 现有测试与需求互相冲突
- 验证失败但根因还不清楚
- 需要产品决定新规则
AI 发现这些情况时应指出具体缺口,不继续扩大修改