JOJO/agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: refine todo guidance

Browse Source
This commit is contained in:
JOJO 2025-11-15 16:46:29 +08:00
parent dc1d566db3
commit 1f105e7497
3 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
core/main_terminal.py
View File

@ -1303,18 +1303,18 @@ class MainTerminal:
"type": "function", "type": "function",
"function": { "function": {
"name": "todo_create", "name": "todo_create",
"description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。建立前需向用户同步当前理解与约束，并在概述中记录关键目标。", "description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。概述请控制在 50 字以内，直接说明清单目标；任务列表只写 2~4 条明确步骤。",
"parameters": { "parameters": {
"type": "object", "type": "object",
"properties": { "properties": {
"overview": {"type": "string", "description": "对任务的思考与概述"}, "overview": {"type": "string", "description": "一句话概述待办清单要完成的目标，50 字以内。"},
"tasks": { "tasks": {
"type": "array", "type": "array",
"description": "任务列表，依次对应 task1~task8", "description": "任务列表，建议 2~4 条，每条写清“动词+对象+目标”。",
"items": { "items": {
"type": "object", "type": "object",
"properties": { "properties": {
"title": {"type": "string", "description": "单个任务描述"} "title": {"type": "string", "description": "单个任务描述，写成可执行的步骤"}
}, },
"required": ["title"] "required": ["title"]
}, },

8
sub_agent/core/main_terminal.py
View File

@ -1303,18 +1303,18 @@ class MainTerminal:
"type": "function", "type": "function",
"function": { "function": {
"name": "todo_create", "name": "todo_create",
"description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。建立前需向用户同步当前理解与约束，并在概述中记录关键目标。", "description": "创建待办列表，将多步骤任务拆解为最多 8 条可执行项。概述需控制在 50 字以内并直接说明目标，任务项写成 2~4 条“动词+对象+目标”的步骤。",
"parameters": { "parameters": {
"type": "object", "type": "object",
"properties": { "properties": {
"overview": {"type": "string", "description": "对任务的思考与概述"}, "overview": {"type": "string", "description": "一句话概述本次清单的目标（<=50 字）。"},
"tasks": { "tasks": {
"type": "array", "type": "array",
"description": "任务列表，依次对应 task1~task8", "description": "任务列表，建议 2~4 条，依次对应 task1~task8",
"items": { "items": {
"type": "object", "type": "object",
"properties": { "properties": {
"title": {"type": "string", "description": "单个任务描述"} "title": {"type": "string", "description": "单个任务描述，写成可执行动作。"}
}, },
"required": ["title"] "required": ["title"]
}, },

4
sub_agent/prompts/todo_guidelines.txt
View File

@ -9,12 +9,12 @@
## 如何编写 ## 如何编写
1. **概述**：一句话写清楚你正在完成的目标（≤50 字）。 1. **概述**：一句话写清楚你正在完成的目标（≤50 字）。
2. **任务项**：2~4 条即可，按执行顺序罗列。每条必须描述“对哪个对象做什么动作”，例如 “读取 sales.xlsx，统计月度汇总”。 2. **任务项**：2~4 条即可，按执行顺序罗列。每条必须描述“对哪个对象做什么动作”。
3. **粒度**：避免含糊词（“处理”、“完善”等）；能在十分钟内完成的最小可执行步骤即可。 3. **粒度**：避免含糊词（“处理”、“完善”等）；能在十分钟内完成的最小可执行步骤即可。
## 使用流程 ## 使用流程
1. **先规划**：在创建清单前，用自然语言写下你准备执行的流程，让自己确认无遗漏。 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**：每完成一项立刻勾选；若步骤发生变化，先写明原因再修改对应任务。 3. **todo_update_task**：每完成一项立刻勾选；若步骤发生变化，先写明原因再修改对应任务。
4. **todo_finish**：所有任务完成后调用。若仍有未完项但必须停止，先调用 `todo_finish`，再用 `todo_finish_confirm` 说明原因与后续建议。 4. **todo_finish**：所有任务完成后调用。若仍有未完项但必须停止，先调用 `todo_finish`，再用 `todo_finish_confirm` 说明原因与后续建议。