和 AI coding agent 协作前，先把任务讲清楚

学习目标

学完这一节，你应该能做到：

• 明确描述“我要做什么”
• 告诉 agent 当前卡点是什么
• 指出已有材料：报错、文件、链接、截图
• 说清最终验收标准

为什么很多人和 coding agent 沟通低效

不是因为模型太笨，而是因为任务描述太像一句愿望：

“帮我做个网站。”

这类请求通常缺少四个关键元素：

1. 目标
2. 当前状态
3. 可用上下文
4. 完成标准

一个更好的任务模板

你可以把任务压缩成下面这种结构：

我想做什么：
我现在卡在哪里：
我手头有什么材料：
我希望最终产出是什么：

示例

较弱的说法：

帮我做一个公告分析工具。

较强的说法：

我想做一个自动整理 A 股公告的小工具。我不会写代码。现在卡在不知道该用什么技术栈。手头有几份公告 PDF 和我想要的输出格式。希望你先帮我拆需求，再实现一个 MVP。

这一节真正想建立的能力

不是“写更长的 prompt”，而是学会把任务说成一个工程问题。

当你能说明输入、约束、目标和验收条件时，大多数 coding agent 的表现都会明显提升。

课后测验

下面哪一种任务描述最适合直接交给 coding agent？

A 帮我做个网站，酷一点。 B 我想做一个学习网站，现在没有代码。请先帮我拆首页、课程页、微课页和测验页，再实现 MVP。 C 你随便做一个东西给我看看。 D 我也不知道要什么，你先开始。

提示：先自己作答，再看解析。

课后行动

今天就把你脑中一个模糊项目，按下面四行写出来：

• 我想做什么
• 我卡在哪里
• 我手头有什么
• 我希望最后得到什么

参考文献

1. Anthropic, Claude Code documentation.
2. Astro documentation on content collections and MDX.
3. Personal notes on agent-assisted development workflow.