跳转到内容
深度教程 / 03

编码任务交接:把需求、改动与验收写到可执行

以年付折扣从 15% 改为 20% 的合成需求为例,完成上下文清点、实现说明、计算验收与交付审阅。

shancha 整理6 个阶段 · 完整提示词6 份练习材料
本篇目录
  1. 先看输入与交付结果
  2. 准备与能力检查
  3. 执行与接管边界
  4. 01 把需求拆成行为与约束
  5. 02 建立改前改后的验收样例
  6. 03 写给执行者的具体任务书
  7. 04 核对执行环境,保留本地路径
  8. 05 实现后按行为验收,不只看截图
  9. 06 交付可审阅结果并清理临时进程
  10. 排错与验收清单
  11. 下载练习材料
  12. 来源与验证范围
先看结果

先确认输入,再对照完整交付物

下面保留了原始材料、逐项结果和完整报告。先独立处理输入,再用参考结果检查遗漏与分歧。

本页演示范围

仓库文件为合成片段,未启动云端 Agent、修改真实仓库、提 PR 或推送。默认停在本地任务书。

编码任务交接练习台
2 份文件片段 · 3 项价格验收

本站原创合成材料。先看输入独立练习,再切换参考结果对照。

原始合成材料
{
  "synthetic": true,
  "case": "cursor-cloud-agent",
  "data": {
    "request": "年付折扣改为 20%,FAQ 解释按 12 个月月费计算;月费保持不变。",
    "files": [
      {
        "path": "pricing.json",
        "content": {
          "monthly": 100,
          "currency": "CNY",
          "annual_discount": 0.15
        }
      },
      {
        "path": "faq.md",
        "content": "年付价格按当时定价页显示。"
      }
    ],
    "constraints": [
      "先在本机查看页面",
      "不部署",
      "不开子代理",
      "不推送"
    ],
    "unknown": [
      "真实仓库地址",
      "起点分支",
      "运行命令"
    ]
  }
}
本次处理规则
只做需求与合成片段分析。年付=100×12×(1-20%)=960,旧年付1020,月付100不变。上下文不足不猜文件路径或运行命令。云 Agent 可能自动推送,要求不推送时使用本地实现路径;真实启动另核对账号、费用、分支和提交行为。
这里展示完整输入与预期交付物,切换不会运行任务。第三方连接与写入需在自己的环境另行验收。
开始前

把材料与工具准备清楚

先用材料练习

  • 下载合成配置与需求,不需要连接仓库。
  • 手算旧价与新价,明确月费不变。
  • 先把未知仓库与运行命令列为待补。

接入真实环境时

  • 核对真实仓库、起点状态和项目说明。
  • 确认执行环境与可用命令;云端行为可能包含推送,不能只靠一句提示词关闭。
  • 模型、预算、分支、PR 和推送各按用户明确范围处理。

先用下面的材料和指令完成一次文件练习。接入自己的服务时,核对实际账号、可用工具与操作范围,再按每步的检查点继续。

先下载原始材料与规则 ↓
执行与接管

执行与接管边界

以下动作以已约定的输入、账号和范围为前提;设置 Routine 不会扩大授权范围。

可自动执行

分析已提供需求与代码片段,准备改动范围、计算对照和一次性验收计划。

需要确认

真实仓库写入、启动云 Agent、费用、分支、推送、PR 与部署按具体范围确认;当前案例不启动子代理。

失败后接管

上下文不足不猜文件或命令;执行行为不符合约束时停止远端任务,保留本地差异与日志,由你决定恢复路径。

STEP 01

把需求拆成行为与约束

先定义修改后用户看到的价格与文案,再列范围。上下文不足时任务书应保留缺项,不能装作已经找到了真实组件。

阶段 01 · 把需求拆成行为与约束
读取 source-data.json,列目标、允许文件片段、月费不变等约束与未知项。只交 task-scope.md,不读取其他仓库,不启动任何 Agent。
应拿到什么

清楚的需求边界。

检查点

真实仓库和运行命令仍待补,没有虚构路径。

STEP 02

建立改前改后的验收样例

折扣百分比和实际年费要同时验证。只改文字可能留下旧计算,只改配置也可能让 FAQ 仍展示旧说法。

阶段 02 · 建立改前改后的验收样例
计算旧年付与新年付,写月付、折扣、年付金额及 FAQ 四项对照。保留币种和取整约定,数字来自合成配置,不推导其他套餐。
应拿到什么

价格与文案验收表。

检查点

旧价1020、新价960、月费100,三项能独立核算。

STEP 03

写给执行者的具体任务书

任务书包含背景、允许修改、禁止扩展和验收步骤。执行者可以先检查真实结构,再提出最小改动,不需要重写整个页面。

阶段 03 · 写给执行者的具体任务书
输出 implementation-brief.md:先定位实际配置与组件,再改折扣与 FAQ;写清960公式、月费不变、截图要求和单次检查。命令从仓库说明取得,缺少就报告;不加依赖或重构无关模块。
应拿到什么

可审阅的实现说明。

检查点

每个目标对应一个验收动作,没有扩成改套餐或支付系统。

STEP 04

核对执行环境,保留本地路径

云端代理可能在完成时推送分支或创建 PR,设置与当前 API 行为需要先核对。明确要求不推送时,本地工作比启动远端后再制止更可控。

阶段 04 · 核对执行环境,保留本地路径
先列本地与云端执行条件:账号、仓库、起点、费用、是否推送/提PR。当前约束不推送、不开子代理,因此只给本地实施方案,不启动云Agent、不创建分支或远端任务。
应拿到什么

符合约束的执行计划。

检查点

没有把提示词里的“不推送”当作已验证的云端开关。

STEP 05

实现后按行为验收,不只看截图

截图能证明显示,计算和配置仍需核对。实际获准实现时,先检查改动范围,再运行合适的一次性命令。

阶段 05 · 实现后按行为验收,不只看截图
若后续批准真实本地实现,先读取项目说明并记录起点,再按确认文件修改。验收价格、FAQ、手机布局,报告实际运行命令与结果;截图来自实际页面。不要推送、提PR、部署或委派。
应拿到什么

本地改动、验证与实际截图,或阻塞说明。

检查点

显示与计算一致,未把计划或设计图写成完成。

STEP 06

交付可审阅结果并清理临时进程

交接时提供改了什么、为何这样改和如何验证,让用户能决定下一步。临时服务器有需要才保留,已有用户进程不能随意终止。

阶段 06 · 交付可审阅结果并清理临时进程
汇总改动文件、价格对照、一次性检查结果、实际预览入口和剩余未知。清理本任务启动且不再需要的进程;不停止原有服务。保持未推送、未合并、未部署。
应拿到什么

完整交付说明。

检查点

改动与验证可复查,没有无关后台进程或远端动作。

排错与验收

卡住时先看证据,再决定下一步

折扣改了金额没变

检查是否还有硬编码价格,并对照配置与页面计算。

云端默认推送怎么办

当前禁止推送就保持本地路径;不能把未核对的设置当保证。

截图漂亮但测试没跑

分别报告视觉与计算验证,未运行的明确列出。

执行者想重构整站

回到允许范围和四项验收,只处理实现需求必要部分。

完成前,逐项核对

勾选用于本次自查,刷新后重置;不代表真实服务已经通过验证。

已核对 0 / 6 项

练习材料

原始输入与参考答案分开下载

第一次先交原始材料和规则,不提前提供参考答案。验收后,再下载报告与全部提示词保存。

来源与验证范围

把官方能力与练习结果分别核对

内容更新日期: · 修改页面不等于重新核验资料或实操。

资料核验:未核验 · 暂无核验日期
尚无本案例单独核验官方资料的记录;下列来源供复核,不能视为已核验。

实操核验:未核验
未核验真实账号、外部工具写入、定时执行或长期运行效果;合成练习与页面自查不能替代实操核验。

仓库文件为合成片段,未启动云端 Agent、修改真实仓库、提 PR 或推送。默认停在本地任务书。

  1. Cursor:Cloud Agents API ↗

    核对起点、分支、PR 与推送行为;本页没有启动代理。

  2. Grok Bot:应用与共享电脑 ↗

    核对连接方式、可见范围与账号内共享状态。

  3. Grok Bot:Skills 与 Routines ↗

    先验证一次手动任务,再保存与安排重复运行。

下一步

用自己的小批材料,再验收一次

保留原始输入和操作记录,先确认每项结果能回查,再增加连接与重复运行。

相关外部资料 217 条 →官方资料和原作者分享,每条附核验范围说明。

最近更新: