Reference for Azure DevOps work item fields, link types, and states. Use when the user needs to know field names, field paths, reference names, link types, or work item type configurations. Use when user mentions "field name", "field path", "what field", "link type", "relation type", "parent child", "work item type", or needs to set/update specific work item properties.
/plugin marketplace add JoshuaRamirez/ms-ado-az-claude-code-plugin/plugin install ado-work-items@ms-ado-azThis skill inherits all available tools. When active, it can use any tool Claude has access to.
| Display Name | Reference Name | Type | Description |
|---|---|---|---|
| ID | System.Id | Integer | Unique identifier |
| Title | System.Title | String | Work item title |
| State | System.State | String | Current state |
| Reason | System.Reason | String | Reason for state |
| Work Item Type | System.WorkItemType | String | Bug, Task, etc. |
| Assigned To | System.AssignedTo | Identity | Person assigned |
| Created By | System.CreatedBy | Identity | Creator |
| Created Date | System.CreatedDate | DateTime | Creation timestamp |
| Changed By | System.ChangedBy | Identity | Last modifier |
| Changed Date | System.ChangedDate | DateTime | Last modified |
| Area Path | System.AreaPath | TreePath | Area classification |
| Iteration Path | System.IterationPath | TreePath | Sprint/iteration |
| Tags | System.Tags | String | Semicolon-separated |
| Description | System.Description | HTML | Rich text description |
| History | System.History | HTML | Discussion entry |
| Rev | System.Rev | Integer | Revision number |
| Board Column | System.BoardColumn | String | Kanban column |
| Board Lane | System.BoardLane | String | Swimlane |
| Display Name | Reference Name | Type |
|---|---|---|
| Story Points | Microsoft.VSTS.Scheduling.StoryPoints | Double |
| Effort | Microsoft.VSTS.Scheduling.Effort | Double |
| Original Estimate | Microsoft.VSTS.Scheduling.OriginalEstimate | Double |
| Remaining Work | Microsoft.VSTS.Scheduling.RemainingWork | Double |
| Completed Work | Microsoft.VSTS.Scheduling.CompletedWork | Double |
| Start Date | Microsoft.VSTS.Scheduling.StartDate | DateTime |
| Finish Date | Microsoft.VSTS.Scheduling.FinishDate | DateTime |
| Display Name | Reference Name | Values |
|---|---|---|
| Priority | Microsoft.VSTS.Common.Priority | 1, 2, 3, 4 |
| Severity | Microsoft.VSTS.Common.Severity | 1 - Critical, 2 - High, 3 - Medium, 4 - Low |
| Value Area | Microsoft.VSTS.Common.ValueArea | Business, Architectural |
| Risk | Microsoft.VSTS.Common.Risk | 1 - High, 2 - Medium, 3 - Low |
| Display Name | Reference Name | Type |
|---|---|---|
| Repro Steps | Microsoft.VSTS.TCM.ReproSteps | HTML |
| System Info | Microsoft.VSTS.TCM.SystemInfo | HTML |
| Found In | Microsoft.VSTS.Build.FoundIn | String |
| Integration Build | Microsoft.VSTS.Build.IntegrationBuild | String |
| Display Name | Reference Name | Usage |
|---|---|---|
| Child | System.LinkTypes.Hierarchy-Forward | workItemLink |
| Parent | System.LinkTypes.Hierarchy-Reverse | workItemLink |
| Successor | System.LinkTypes.Dependency-Forward | workItemLink |
| Predecessor | System.LinkTypes.Dependency-Reverse | workItemLink |
| Related | System.LinkTypes.Related | workItemLink |
| Duplicate | System.LinkTypes.Duplicate-Forward | workItemLink |
| Duplicate Of | System.LinkTypes.Duplicate-Reverse | workItemLink |
| Tested By | Microsoft.VSTS.Common.TestedBy-Forward | workItemLink |
| Tests | Microsoft.VSTS.Common.TestedBy-Reverse | workItemLink |
| Affects | Microsoft.VSTS.Common.Affects-Forward | workItemLink |
| Affected By | Microsoft.VSTS.Common.Affects-Reverse | workItemLink |
| Referenced By | Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward | workItemLink |
| References | Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse | workItemLink |
| Test Case | Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward | workItemLink |
| Shared Steps | Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse | workItemLink |
az boards work-item relation list-type -o table
az boards work-item relation show --id 123 -o json
# Add child link (work item 123 becomes parent of 456)
az boards work-item relation add --id 123 --relation-type "Child" --target-id 456 -o json
# Add parent link (work item 123 becomes child of 789)
az boards work-item relation add --id 123 --relation-type "Parent" --target-id 789 -o json
# Add related link
az boards work-item relation add --id 123 --relation-type "Related" --target-id 456 -o json
Note: Friendly Names vs Reference Names
The CLI uses friendly names (from the "Name" column), not reference names:
- Use
"Parent"not"System.LinkTypes.Hierarchy-Reverse"- Use
"Child"not"System.LinkTypes.Hierarchy-Forward"- Use
"Related"not"System.LinkTypes.Related"Tip: Run
az boards work-item relation list-type -o tableto see all available friendly names in the "Name" column.
az boards work-item create \
--type "Bug" \
--title "Login fails" \
--fields "Microsoft.VSTS.Common.Priority=1" \
"Microsoft.VSTS.Common.Severity=2 - High" \
"System.Tags=urgent;login" \
-o json
az boards work-item update \
--id 123 \
--state "In Progress" \
--assigned-to "user@example.com" \
--fields "Microsoft.VSTS.Scheduling.RemainingWork=4" \
-o json
az boards work-item update --id 123 --discussion "This is my comment" -o json
az boards work-item list-fields -o table
<p>Description</p>Project\Area\SubArea2024-01-15T10:30:00Z4.5 not 4,5This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.