azure-devops-work-item-review
Use only when the user explicitly invokes `$azure-devops-work-item-review` or names `azure-devops-work-item-review` to review an Azure DevOps Work Item before implementation.
SKILL.mdskills/local/azure-devops-work-item-review/SKILL.md
GitHubAzure DevOps Work Item Review
Scope
Use this skill to review whether an Azure DevOps Work Item is ready for implementation in the current local repository. This skill is read-only.
Read ../azure-devops-common/references/context.md before resolving the Azure
DevOps target.
Target Resolution
- Require a Work Item ID, an Azure DevOps Work Item URL, or an unambiguous user reference.
- If no Work Item is provided, stop and ask for the ID or URL.
- If the URL points to another organization or project, stop and explain that this skill is current-repository only.
Workflow
- Resolve repository context with
git status --short --branch, git remotes, andaz devops configure --list. - Fetch the Work Item with
az boards work-item show --id <id> --expand all. - Inspect one-hop related Work Items and pull requests when relations are present and same-project.
- Check for duplicate or already-active work.
- Query active Work Items with relevant title terms when useful.
- List open PRs with
az repos pr listand look for linked Work Items, matching branches, or overlapping titles.
- Read local repository guidance and likely implementation areas with
rgandrg --files. - Apply the readiness gate.
- Ready only when acceptance criteria, scope boundary, and dependencies are clear and verifiable.
- Prefer "needs revision", "split", or "hold" for broad, ambiguous, blocked, or policy-setting Work Items.
Output Format
Respond in the user's language:
**Verdict**
- Ready to implement | Needs revision before implementation | Split before implementation | Hold
- <one-sentence reason>
**Critical Gaps**
- <missing acceptance criteria, ambiguity, dependency, or "None found">
**Scope & Dependencies**
- <related Work Items/PRs, blockers, sequencing, duplicates, or "No blockers found">
**Codebase Fit**
- <affected areas, feasibility, risks>
**Suggested Revision**
- <specific Work Item body changes>
**Implementation Notes**
- <guidance for the eventual implementer without starting implementation>
**Open Questions**
- <questions for the owner/user, or "None">
Guardrails
- Do not create, update, assign, tag, close, comment on, or transition Work Items.
- Do not create branches, worktrees, commits, or PRs.
- Do not install dependencies or edit manifests or lockfiles.
- Do not assume cross-project context.