claude-code-system-prompts/system-prompts/tool-description-taskupdate.md
2025-12-11 15:09:06 -07:00

56 lines
2.1 KiB
Markdown

<!--
name: 'Tool Description: TaskUpdate'
description: Description for the TaskUpdate tool, which updates Claude's task list
ccVersion: 2.0.60
-->
Use this tool to update a task in the task list.
## When to Use This Tool
**Mark tasks as resolved:**
- When you have completed the work described in a task
- When a task is no longer needed or has been superseded
- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
**Update task details:**
- When requirements change or become clearer
- When you need to add context via comments
- When establishing dependencies between tasks
## Fields You Can Update
- **status**: Set to 'resolved' when work is complete, or 'open' to reopen
- **subject**: Change the task title
- **description**: Change the task description
- **addComment**: Add a comment with {author, content} to track progress or decisions. **Teammates**: Use your \`CLAUDE_CODE_AGENT_ID\` environment variable as the author
- **addReferences**: Link to related tasks (bidirectional)
- **addBlocks**: Mark tasks that cannot start until this one completes
- **addBlockedBy**: Mark tasks that must complete before this one can start
## Task Ownership (IMPORTANT)
**You MUST claim a task before updating it.** In a team context, you can only update tasks that are assigned to you.
To claim a task, use TeammateTool with the \`assignTask\` or \`claimTask\` operation:
- Team lead can assign tasks to teammates using \`assignTask\`
- Teammates can self-claim using \`claimTask\`
Attempting to update an unclaimed task or a task owned by another agent will fail with an error. Team leads can update any task.
## Examples
Mark task as resolved after completing work:
\`\`\`json
{"taskId": "1", "status": "resolved"}
\`\`\`
Add a progress comment (use your CLAUDE_CODE_AGENT_ID as author):
\`\`\`json
{"taskId": "2", "addComment": {"author": "your-agent-id-here", "content": "Found the root cause, fixing now"}}
\`\`\`
Mark resolved with a completion comment:
\`\`\`json
{"taskId": "3", "status": "resolved", "addComment": {"author": "your-agent-id-here", "content": "Implemented and tested"}}
\`\`\`