1.3 把网页聊天变成本地任务¶
网页对话最有价值的产物不是一段代码,而是一份清楚的任务说明。
任务转换模板¶
让网页模型输出这个格式:
# Task Brief
## Goal
要完成什么,为什么要做。
## User / Scenario
谁会用,在什么场景下用。
## Requirements
- 必须实现什么。
- 必须保持什么。
## Out of Scope
- 本次不做什么。
## Context Pointers
- 本地 Agent 应该先读哪些文件或目录。
## Constraints
- 技术、风格、兼容性、安全边界。
## Done When
- 哪些现象、测试、命令证明完成。
## Risks
- 可能踩坑的地方。
给网页模型的提示词¶
我接下来要把这个需求交给本地 Claude Code / Codex / OpenCode 执行。
请不要写代码。
请把我们的讨论整理成 Task Brief,重点写清楚:
目标、范围、不做什么、上下文入口、约束、验收标准、风险。
输出要适合直接保存为 prd.md。
交给本地 Agent 前再做一次压缩¶
网页模型输出通常会偏长。交给本地 Agent 前,压缩成:
- 目标不超过 5 行。
- Requirements 不超过 10 条。
- Out of Scope 必须有。
- Context Pointers 必须是路径或明确对象。
- Done When 必须可验证。
反例¶
不要把这种东西交给本地 Agent:
帮我做一个像 Notion 一样的工具,要好看,要能登录,要有数据库。
这不是任务,是愿望。
更好的版本:
目标:实现一个最小 notes CRUD 页面。
范围:只做本地登录后的 notes 列表、新建、编辑、删除。
不做:协作、分享、富文本、权限系统。
上下文:先读 src/app/notes、src/lib/db、已有 auth middleware。
验收:新增 note 后刷新仍存在;删除后列表消失;相关测试通过。
本地 Agent 需要的是可执行任务,不是灵感描述。