From 1f105e7497d27e0706795974d30c19c1c3e2662b Mon Sep 17 00:00:00 2001 From: JOJO <1498581755@qq.com> Date: Sat, 15 Nov 2025 16:46:29 +0800 Subject: [PATCH] docs: refine todo guidance --- core/main_terminal.py | 8 ++++---- sub_agent/core/main_terminal.py | 8 ++++---- sub_agent/prompts/todo_guidelines.txt | 4 ++-- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/core/main_terminal.py b/core/main_terminal.py index c2888c8..2e9d46a 100644 --- a/core/main_terminal.py +++ b/core/main_terminal.py @@ -1303,18 +1303,18 @@ class MainTerminal: "type": "function", "function": { "name": "todo_create", - "description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。建立前需向用户同步当前理解与约束，并在概述中记录关键目标。", + "description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。概述请控制在 50 字以内，直接说明清单目标；任务列表只写 2~4 条明确步骤。", "parameters": { "type": "object", "properties": { - "overview": {"type": "string", "description": "对任务的思考与概述"}, + "overview": {"type": "string", "description": "一句话概述待办清单要完成的目标，50 字以内。"}, "tasks": { "type": "array", - "description": "任务列表，依次对应 task1~task8", + "description": "任务列表，建议 2~4 条，每条写清“动词+对象+目标”。", "items": { "type": "object", "properties": { - "title": {"type": "string", "description": "单个任务描述"} + "title": {"type": "string", "description": "单个任务描述，写成可执行的步骤"} }, "required": ["title"] }, diff --git a/sub_agent/core/main_terminal.py b/sub_agent/core/main_terminal.py index 6c9f7a2..8a29368 100644 --- a/sub_agent/core/main_terminal.py +++ b/sub_agent/core/main_terminal.py @@ -1303,18 +1303,18 @@ class MainTerminal: "type": "function", "function": { "name": "todo_create", - "description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。建立前需向用户同步当前理解与约束，并在概述中记录关键目标。", + "description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。概述需控制在 50 字以内并直接说明目标，任务项写成 2~4 条“动词+对象+目标”的步骤。", "parameters": { "type": "object", "properties": { - "overview": {"type": "string", "description": "对任务的思考与概述"}, + "overview": {"type": "string", "description": "一句话概述本次清单的目标（<=50 字）。"}, "tasks": { "type": "array", - "description": "任务列表，依次对应 task1~task8", + "description": "任务列表，建议 2~4 条，依次对应 task1~task8", "items": { "type": "object", "properties": { - "title": {"type": "string", "description": "单个任务描述"} + "title": {"type": "string", "description": "单个任务描述，写成可执行动作。"} }, "required": ["title"] }, diff --git a/sub_agent/prompts/todo_guidelines.txt b/sub_agent/prompts/todo_guidelines.txt index fae2617..5d7f898 100644 --- a/sub_agent/prompts/todo_guidelines.txt +++ b/sub_agent/prompts/todo_guidelines.txt @@ -9,12 +9,12 @@ ## 如何编写 1. **概述**：一句话写清楚你正在完成的目标（≤50 字）。 -2. **任务项**：2~4 条即可，按执行顺序罗列。每条必须描述“对哪个对象做什么动作”，例如 “读取 sales.xlsx，统计月度汇总”。 +2. **任务项**：2~4 条即可，按执行顺序罗列。每条必须描述“对哪个对象做什么动作”。 3. **粒度**：避免含糊词（“处理”、“完善”等）；能在十分钟内完成的最小可执行步骤即可。 ## 使用流程 1. **先规划**：在创建清单前，用自然语言写下你准备执行的流程，让自己确认无遗漏。 -2. **todo_create**：把概述与任务数组一次性写对，创建后尽量不要反复删除重建。概述 ≤ 50 字，直接写清“我要做什么”（例如“整理 deliverables/result.md”）；任务数组写 2~4 条“动词＋对象＋目标”的步骤，例如“读取 physics_problems.txt，列出 5 道题”“在 result.md 中总结风险”。 +2. **todo_create**：把概述与任务数组一次性写对，创建后尽量不要反复删除重建。概述 ≤ 50 字，说明清单目标；任务数组写 2~4 条“动词＋对象＋目标”的步骤。 3. **todo_update_task**：每完成一项立刻勾选；若步骤发生变化，先写明原因再修改对应任务。 4. **todo_finish**：所有任务完成后调用。若仍有未完项但必须停止，先调用 `todo_finish`，再用 `todo_finish_confirm` 说明原因与后续建议。