17 · 用任务说明驱动 AI 开发

本页为文字教程；视频与配套媒体仍以实际发布状态为准。

返回课程总览 · 返回模块

本课交付：三张连续任务卡与一次变更记录

你已经有页面结构、状态表和文案，本课不再让 AI 从一句“做个网站”重新设计产品。将首版拆成三个能够单独验收的任务：输入与校验、接口与错误、结果与复制。每张卡都交代依赖、允许改动范围、完成标准和交付证据。

贯穿站生成的是可编辑英文初稿，不是自动核实商品事实。这个边界需要贯穿提示、代码与测试。文中示例是任务说明模板，不表示某个 AI 产品必然执行同样流程，也不替代你对真实文件的检查。

跟做一：准备一页项目事实

写出项目用途、当前技术、运行版本、重要目录、已有接口和可运行检查命令。为每项提供真实文件或配置作为依据，不把理想架构写成现状。若尚无后端，就明确说明只有原型；若没有测试命令，也不要复制一个并不存在的 npm test 当作已验证流程。

GitHub 的仓库自定义指令文档介绍了提供构建与验证上下文的用途。Adding repository custom instructions | GitHub Docs 具体工具支持哪种文件名需要按当前文档核对，但“让实现者知道事实与边界”的原则可以通用。长期规则保持短而稳定，某次界面微调的要求放进任务卡，不让项目规则堆满过期细节。

跟做二：拆出最小可观察变化

第一张任务卡只做字段、必填说明和长度校验，使用明确标注的演示输出；第二张接上服务端契约，覆盖失败状态；第三张展示结果与复制并保留编辑入口。这样的拆分能让你在每一步判断问题来自哪里，不必等整个系统完成才开始检查。

为第一张卡写一个负例：用户只填空白时，不发起上游调用，而是指出需要补充事实。第二张卡写超时反例：保留输入，不显示成功。第三张卡写复制反例：权限失败时仍能手动选择文本。不要只给正常截图，否则实现很容易把复杂状态忽略。

跟做三：写明可改与不可改

例如：“允许修改输入组件、校验函数和相关测试；不得改变现有登录、套餐与线上配置。”如果实现者发现必须扩大范围，应先说明原因与最小影响，不要自行重构。范围不是限制思考，而是保护已经存在的工作与证据。

GitHub 对 AI 代理的说明提醒输出需要人工监督，可能不准确或不完整。Application card: GitHub Copilot Agents 因此，在任务卡中要求报告实际读取的关键文件、改了什么、运行了什么，以及仍需人工核对的内容。你要检查这些报告是否能对应真实差异，而不是根据语气是否自信判断质量。

跟做四：让验收在修改前就清楚

为每张卡准备输入、期望行为、失败行为与检查方法。可自动验证的部分包括空输入、字段边界、响应结构与权限；英文初稿是否保留事实，则需要人工样本核对。把两类证据分开，避免把类型检查通过解释成文案质量已经通过。

GitHub 的 Node.js CI 文档展示了持续构建与测试流程。Building and testing Node.js | GitHub Docs 你可以在任务完成后运行项目已有检查，并在后续接入自动流程。命令失败时先保留错误与环境，不允许通过删除测试、跳过校验或替换真实接口为假数据来假装完成。

跟做五：使用一次准确的修复提示

如果结果出现问题，给 AI 一条可以复现的说明：“在输入两项能力后提交，接口返回校验错误；预期显示可修正提示，实际页面只留下旋转图标。”再附请求状态、响应字段和相关组件位置，不附敏感文本与凭据。让它先提出原因并解释下一步如何验证。

不要连续发送“再修一下”而不确认发生了什么。每次尝试都应增加证据；若反复绕圈，就缩小复现、暂时固定外部响应，并回到上一个可工作的基线。保留失败记录可以避免下一位代理重新试一遍相同路径。

加练：对同一个要求写两种任务说明

把“加一个好看的生成结果”改写为可检查任务：显示初稿、事实核对提示和复制入口；生成失败不出现成功卡；只修改结果组件与测试。再写出验收所需输入与失败样例，并指出哪一项需要人工英文判断。

将两种说明给另一个人阅读，比较他还需要猜测哪些决定，而不是比较哪段更长。好的任务卡减少高影响猜测，同时保留实现上的合理空间，不必规定每一行代码。若任务卡本身还混入未验证功能，先回到产品范围修正。

完成实际修改后，逐一标注任务卡中的条件是否有证据。如果某项没有运行条件，列成未验证，而不是让 AI 用一句“理论上支持”补齐。这份对应表会成为下一次交接的起点。

独立作业：让第三人审查交付

提交三张任务卡、一次实际完成的修改、代码差异、检查输出与未验证项。请另一个人只看这些材料，判断是否实现目标、是否越界、是否存在没被覆盖的失败情况。若还没有运行环境，可以提交说明与待执行清单，但不能标成开发完成。

再把这次发现的一个稳定项目事实补回上下文，例如真实构建命令或关键路由位置。不要把每个临时错误都写成永久规则。经过这一轮，你应得到一条可复用协作流程：清楚目标，读取事实，小范围实现，提供证据，再进入下一张任务卡。