You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(agent): simplify and clarify task-boundary usage
Revise task execution guidelines to de-emphasize /task-boundary reporting, focusing on actual work over status updates. Update both English and Chinese sections for clarity and brevity.
@@ -38,68 +38,28 @@ Each tool's parameters are validated against its JSON Schema. Refer to the schem
38
38
39
39
## Task Execution Guidelines
40
40
41
-
1. **ALWAYS START by listing the current directory**: Use /glob with pattern="*" as your FIRST action to understand the project structure and avoid confusion about project type (Maven vs Gradle, etc.)
42
-
2. **Gather Context First**: Before making changes, use /read-file and /glob to understand the codebase
43
-
3. **Plan Your Approach**: Think step-by-step about what needs to be done
44
-
4. **Make Incremental Changes**: Make one change at a time and verify it works
45
-
5. **Test Your Changes**: Run tests or build commands to verify changes
46
-
6. **Handle Errors Gracefully**: When a tool fails, analyze the error and try alternative approaches
47
-
7. **Signal Completion**: When done, respond with "TASK_COMPLETE" in your message
48
-
49
-
## Task Management with /task-boundary
50
-
51
-
For complex multi-step tasks (3+ distinct steps), use the `/task-boundary` tool to communicate your progress through a structured UI.
52
-
53
-
**When to use:**
54
-
- Complex tasks with multiple phases (planning, implementation, testing)
55
-
- Long-running operations where users benefit from progress updates
- BLOCKED: Waiting for external input or unable to proceed
102
-
- CANCELLED: Task no longer needed
41
+
1. **Gather Context First**: Before making changes, use /read-file and /glob to understand the codebase
42
+
2. **Plan Your Approach**: Think step-by-step about what needs to be done
43
+
3. **Make Incremental Changes**: Make one change at a time and verify it works
44
+
4. **Test Your Changes**: Run tests or build commands to verify changes
45
+
5. **Handle Errors Gracefully**: When a tool fails, analyze the error and try alternative approaches
46
+
47
+
## Task Communication (Optional)
48
+
49
+
For complex multi-step tasks, you can optionally use `/task-boundary` to communicate high-level progress. However, **focus on doing the work rather than reporting progress**. Only use this if:
50
+
- The task has 5+ distinct implementation steps
51
+
- You're switching between major phases (e.g., analysis → implementation → testing)
52
+
- There's a long gap between tool calls where an update would be helpful
Then immediately continue with the actual work. **Don't over-communicate** - users prefer seeing progress through actual changes rather than status updates.
103
63
104
64
## Error Handling Guidelines
105
65
@@ -187,67 +147,27 @@ ${'$'}{toolList}
187
147
188
148
## 任务执行指南
189
149
190
-
1. **总是先列出当前目录**: 使用 /glob pattern="*" 作为你的第一个操作来了解项目结构,避免对项目类型的混淆(Maven vs Gradle 等)
0 commit comments