SKILL.md
<!-- ================================================================ PROJECT CONFIGURATION — update these values for your project ================================================================ -->
Configuration
| Variable | Value |
|---|---|
ADO_PROJECT |
|
ADO_TEAM |
<!-- ================================================================ -->
Azure DevOps MCP — project scope
Scope
When using the user-ado (Azure DevOps) MCP server in this project, always restrict operations to {ADO_PROJECT}.
Default values
| Parameter | Value |
|---|---|
| project | {ADO_PROJECT} |
| team | {ADO_TEAM} |
Instructions
- Every ADO tool call: Pass
project: "{ADO_PROJECT}"when the tool accepts aprojectparameter. - Tools that need a team (e.g.
witlistbacklogworkitems,witlistbacklogs,witgetworkitemsforiteration,corelistprojectteams): Also passteam: "{ADO_TEAM}"when the tool accepts ateamparameter. - Search/filter tools (e.g.
searchworkitem): Useproject: ["{ADOPROJECT}"]in the project filter. - Override: Use a different project or team only when the user explicitly asks (e.g. "list issues in project X" or "show me the OtherProject board").
- User stories — ticket mention syntax: In this project, user stories are referenced with the syntax AB#[ticket_number] (e.g. AB#1183, AB#1020), not "US" or "AB-". When referencing user stories in PR titles, commit messages, or descriptions, use this format (e.g. "AB#1020" or "feat(AB#1020): …").
- Creating work items: When creating a new ticket/work item:
- Always create a User Story unless the user explicitly specifies a different work item type (e.g. Bug, Task, Epic). - Assign it to the current sprint based on today's date. Use witlistteam_iterations to find the active iteration whose date range includes the current date, then set the System.IterationPath field accordingly.
Examples
- "List work items" → call with
project: "{ADO_PROJECT}". - "List repos" → use project
{ADO_PROJECT}. - "Run query X" → pass
project: "{ADO_PROJECT}". - "List issues in Contoso" → use project "Contoso" (user override).