add task skill: guidance on task_plan and task_complete
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
5436ee4119
commit
e88e8b6b94
|
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
name: task
|
||||
intent: plan, task, todo, steps, checklist, decompose, track
|
||||
description: Guidance on using task_plan and task_complete to decompose goals and track progress.
|
||||
---
|
||||
|
||||
# Task Planning
|
||||
|
||||
Use `task_plan` to decompose a multi-step goal into an ordered checklist. Use `task_complete` to mark steps done as you finish them.
|
||||
|
||||
## When to plan
|
||||
|
||||
- The user asks you to do something with three or more distinct steps
|
||||
- The work spans multiple files, tools, or phases
|
||||
- You want to show the user a clear picture of what you're about to do before starting
|
||||
|
||||
## Workflow
|
||||
|
||||
1. Call `task_plan` to create the checklist
|
||||
2. Rename `__todo` → `__wip` when work begins (via `file_edit` or shell)
|
||||
3. Call `task_complete` after each step finishes
|
||||
4. Use `file_*` tools to add, remove, or revise steps as the plan evolves
|
||||
5. Rename `__wip` → `__done` when the goal is fully realized
|
||||
|
||||
## How to use
|
||||
|
||||
```
|
||||
execute_tool: task_plan (or use the built-in task server directly)
|
||||
args: ["<goal>", "<step1>", "<step2>", ...]
|
||||
```
|
||||
|
||||
```
|
||||
execute_tool: task_complete
|
||||
args: ["<plan-filename>", "<step-title-substring>"]
|
||||
```
|
||||
|
||||
`task_complete` matches the step title case-insensitively and errors if no unchecked step matches — silent skips are caught.
|
||||
|
||||
## Notes
|
||||
|
||||
- Plan files live in `pl/` under the ollie mount
|
||||
- List plans: `file_glob` on `ollie/pl/`
|
||||
- Inspect a plan: `file_read` on the plan file
|
||||
- Bulk edits: `file_edit` or `execute_code`
|
||||
Loading…
Reference in New Issue