v2.0.60 (+1339 tokens)

2025-12-11 15:09:06 -07:00
parent 1779eecf18
commit 7b38ff319d
9 changed files with 222 additions and 84 deletions
@@ -1,18 +1,55 @@
 <!--
 name: 'Tool Description: TaskUpdate'
 description: Description for the TaskUpdate tool, which updates Claude's task list
-ccVersion: 2.0.59
+ccVersion: 2.0.60
 -->
 Use this tool to update a task in the task list.

-You can update any combination of:
- subject: Change the task title
- description: Change the task description
- status: Change to 'open' or 'resolved'
- owner: Assign or change the task owner
- addComment: Add a comment with author and content
- addReferences: Link to other tasks (bidirectional)
- addBlocks: Mark that this task blocks other tasks
- addBlockedBy: Mark that this task is blocked by other tasks
+## When to Use This Tool

-All fields are optional - only provide the fields you want to update.
+**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"}}
+\`\`\`