开始使用
提示词技巧
用自然语言把任务交给 agent 的实用指南：任务描述公式、小步迭代、计划先行、审批沟通与纠错
给 agent（智能体）下任务不需要任何特殊语法，用自然语言即可。但描述得越清楚，agent 越少来回猜测、越少返工。这一页把高效的提示词方法拆成几个要点，无论你是 Vibe Coding 还是办公场景都适用。
任务描述公式：目标 + 上下文 + 完成标准
一条好的任务提示词包含三部分：
- 目标：要达成什么结果；
- 上下文：agent 需要知道的关键信息，例如文件路径、命令、报错信息；
- 完成标准：怎样才算完成，越具体越好。
agent 的视野就是工作区加上你的描述，所以把这三样写全，能大幅减少来回确认。
模糊 vs 具体
❌ 「帮我优化项目」——没有范围，agent 只能反复猜。
✅ 「运行 pnpm test 会在 src/parser.ts 报错，请定位原因并修复，直到测试全部通过」——命令、文件与验收标准都清楚。
- 写代码：「把这段脚本里重复的代码抽成一个函数，保持行为不变，并运行测试确认通过」
- 办公：「把
notes/下的 20 篇会议纪要合并成一篇周报，按主题分节，每节不超过 100 字，输出为weekly-report.md」
小步迭代
一次只做一件事，做完立刻验证，比一次性丢出大任务更稳：
- 一次一件事：把大任务拆成小步骤，逐步推进；
- 改完立刻验证：每完成一步就检查产物文件或结果；
- 让 agent 自己验证：让 agent 运行测试或构建来确认自己的改动有效，而不是你替它检查。
计划先行
复杂任务不要直接开跑，先让 agent 列出计划再执行。agent 会维护一份计划；你可以随时让它展示或解释当前计划，确认方向对了再放行。这一步成本很低，却能避免它在错误方向上埋头做很久。
审批沟通
agent 执行写文件、跑命令等敏感操作前，Web UI 会弹出审批请求。审批不是被动点「是/否」，而是可以沟通的：
- 看不懂就先问：让 agent 先解释它要做什么、为什么这么做，再决定是否批准；
- 可以只让它分析：不确定的写操作可以先拒绝，要求它只做分析、不改动文件；
- 可以明确拒绝某一步：告诉它哪一步不做、改成什么方式，它会基于你的反馈继续。
纠错与继续
不满意时，基于当前状态继续对话，不要每次都从头开始：
- 说出具体哪里不对：是结果方向错了，还是某个文件改错了，指出来而不是只说「不对」；
- 让 agent 在现有文件上继续改，而不是重来一遍。
善用技能与目标
有两样东西能放大提示词的效果：
- skill（技能）：可复用、按需加载的指令包，让 agent 按某个领域的最佳实践工作，例如
code-reviewskill 会以代码审查标准检查改动； - 目标：附着在会话上的持久完成目标，适合跨多轮的长期任务，一句自然语言请求即可创建，agent 会自动多轮推进。
两者详见技能与目标。
常见反模式
避免这些写法
- 模糊目标：「优化一下」没有方向；
- 一次要太多：一口气塞进十几个改动，验证变得困难；
- 不给验收标准：agent 不知道何时算完成，只能猜；
- 把敏感操作全自动批准：审批是最后一道防线，不要盲目「全部允许」。
下一步
- Web GUI 快速上手：从发送第一个任务开始；
- Vibe Coding 入门：写代码场景的第一课；
- AI 办公实践：文档、表格与日常办公；
- 配置模型：选择合适的模型；
- 技能与目标：深入 skill 与目标；
- Subagent 与工作流：并行委派与编排；
- 常见问题：遇到问题先查这里。