文档教程
第一个岗位任务
成员如何从岗位工作台开始，补充上下文、执行任务并检查结果。
这篇教程面向企业成员。用一个真实但不高风险的任务，走完“描述目标 → 补充上下文 → 执行 → 检查 → 收口”的完整链路。
第 1 步：从岗位工作台开始
Section titled “第 1 步：从岗位工作台开始”登录后先看首页的岗位工作台，而不是直接打开空白对话。工作台上的技能入口已经按岗位预置，例如：
| 岗位 | 典型入口 |
|---|---|
| 电商运营 | 商品标题优化、活动方案、客服话术、评价汇总 |
| 财税 | 政策查询、报表核对、凭证整理、风险提示 |
| 研发 | 代码审查、单元测试、接口文档、故障排查 |
| 行政 | 通知起草、会议纪要、流程说明、数据整理 |
如果工作台为空，先退出重登；仍然为空时联系管理员确认岗位和工作台是否已下发。
第 2 步：写清任务
Section titled “第 2 步：写清任务”一条可执行的任务描述通常包含四部分：
背景：我在做什么、给谁看目标：这次要产出什么范围：只能读哪些文件/数据，不要动哪些验收：什么算完成示例：
背景：我们是电商运营，本周店铺出现 37 条差评。目标：按问题类型归类，给出优先处理建议和客服回复模板。范围：只使用我引用的评价导出文件，不要修改原文件。验收：输出一张分类统计表、三条优先建议、两版客服话术。任务越具体，Agent 越少做无关探索，积分消耗也更可控。
第 3 步：补充上下文
Section titled “第 3 步：补充上下文”按需使用输入框的快捷入口：
| 入口 | 用途 |
|---|---|
@ |
引用工作区文件或文件夹 |
# |
关联历史会话 |
/ |
调用已保存的命令 |
$ |
调用技能 |
| 附件 | 上传截图、表格、需求文档 |
第一次任务只引用必要文件。引用整个代码仓库或大量文档会增加上下文长度和积分消耗，也可能引入无关信息。
第 4 步：先要计划，再执行
Section titled “第 4 步：先要计划，再执行”对涉及多步骤或文件修改的任务，先要求 Agent 给出计划：
先不要改文件。列出你准备检查的文件、步骤和验证方式，我确认后再执行。确认计划后再让它执行。执行过程中关注：
- 是否读取了不该读的文件；
- 是否准备执行高风险命令；
- 是否在等待权限确认；
- 是否出现重复调用或明显偏离目标。
企业版会在关键操作前进入确认流程。确认前看清目标、范围和影响，不要习惯性点“允许”。
第 5 步：检查结果
Section titled “第 5 步：检查结果”不要只看最终文字。按任务类型检查：
| 产出 | 检查方式 |
|---|---|
| 代码修改 | 看 diff、跑测试、确认没有无关改动 |
| 文档 | 核对事实、数字、链接和口径 |
| 数据表 | 核对来源、公式、异常值和总计 |
| 客服话术 | 核对品牌语气、承诺边界和合规要求 |
| 业务操作 | 确认目标系统、影响范围、回滚方式 |
发现错误时直接指出具体位置和期望结果，不要只说“重做”。例如：
第 2 节的统计口径错了：差评应按订单去重，不是按评价条数。请按订单去重后重算，并保留原始评价条数作为参考。第 6 步：收口
Section titled “第 6 步：收口”任务完成后：
- 把可复用的结果保存到企业知识库或指定目录；
- 把重复性流程保存为 Command 或 Skill；
- 在任务里记录结论、风险和后续动作；
- 清理临时文件和不再需要的附件；
- 确认积分消耗在预期范围内。
Agent 一直追问，给不出结果
Section titled “Agent 一直追问，给不出结果”补充背景、范围和验收标准；如果它缺少关键数据，明确告诉它可以用哪些文件或知识库。
结果看起来对，但引用了不存在的文件
Section titled “结果看起来对，但引用了不存在的文件”要求它列出实际读取的文件和引用来源；对关键结论做二次核对。
任务太大，执行很久
Section titled “任务太大，执行很久”拆成几个小任务：先梳理现状，再改一个模块，最后统一验证。长任务不等于高质量。
修改了不该改的文件
Section titled “修改了不该改的文件”立即停止，用 Git 或备份恢复。下一次在任务描述里明确“只允许修改哪些目录”。