| name | make_plan |
| description | 当任务需要多步骤执行、有依赖关系或需要明确顺序时,先制定分步计划再执行。不要遇阻就放弃——换路径、换工具、换方法继续尝试。 |
| metadata | {"borrowed_from":"QwenPaw skills workflow","adapted_for":"dongxuelian-agent"} |
制定计划
当你面对复杂任务时,不要一上来就执行。先用 create_plan 创建计划,拆成明确步骤,再逐步执行。
何时需要制定计划
- 任务需要多步拆解
- 步骤之间有依赖关系
- 需要明确先后顺序、检查点
- 涉及多个工具、文件、系统
- 用户明确要求先给出计划
- 当前路径受阻,需要换方法
遇阻不放弃规则(重要)
当工具返回空结果、失败、或不理想时:
- 不要直接放弃。分析失败原因。
- 换工具——一个工具不行换另一个。
- 例:
query_logs 返回空 → 改用 execute_shell tail 或 read_file 直接读日志
- 例:搜索无结果 → 换关键词、换搜索引擎、读候选页正文
- 换路径——当前方法走不通,找替代方案。
- 不确定时——向用户说明尝试了什么、为什么失败、建议什么替代方案。
- 空结果 ≠ 问题不存在。空结果只说明当前查询没命中。
如何制定计划
- 分析任务:确定最终目标
- 拆步骤:每个步骤是可执行的独立动作
- 定顺序:标注依赖关系和推荐顺序
- 设检查点:每一步完成后如何验证
- 使用
create_plan 创建持久化计划,然后逐步执行 update_task_status
诊断任务的推荐步骤
当用户问 "服务器状态"、"查日志"、"有什么问题":
execute_shell 查进程 — ps aux | grep koishi
execute_shell 查端口 — ss -tlnp | grep -E '5140|5150'
read_file 或 execute_shell tail 读最近日志
query_logs 精确搜错误
execute_shell 查资源 — free -h
- 综合以上给出判断。不要只凭一个工具的结果下结论。
不要这样用
以下情况不要用:
- 你其实可以把任务直接完成
- 真正缺的是一个小事实,不是计划
- 你连任务目标都没理解清楚
计划质量标准
一份合格的计划应满足:
- 有明确步骤,而不是泛泛建议
- 步骤顺序清楚
- 每步是可执行动作
- 有必要的验证点
- 遇阻时有替代方案