azure-ticket-drafting
Draft azure boards work items (ticket/bug/user story)
- License 许可
- MIT
- 所属仓库
- srafis/skills
- 最近更新
- 2026-10-16
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- azure-ticket-drafting
- description
- Draft azure boards work items (ticket/bug/user story)
02 资源文件 1
- 参考文档agents/openai.yaml233 B
03 SKILL.md 正文
Azure Ticket Drafting
Produce work items that a developer can implement without guessing the expected output. Default to drafting in chat; do not create or change Azure Boards items unless the user explicitly authorizes it.
Build the evidence base
- Read the relevant source material supplied or named by the user. This can be requirements, a specification, design, current work item, meeting transcript, MoM, email, spreadsheet, prototype, or repository code.
- Establish source priority from the user's instruction or the artifacts themselves. If sources conflict and no priority is clear, call it out as an open decision instead of silently choosing.
- Separate confirmed requirements from assumptions, proposals, future work, and unresolved decisions. Do not turn an inference into a requirement.
- Record explicit exclusions, dependencies, integration boundaries, and acceptance constraints where they prevent scope creep.
- When a source artifact defines a canonical field list, workflow, contract, or terminology, preserve it. Do not substitute an implementation-defined version.
Title standard
Write a title that stands alone. A developer should understand the concrete output without opening the description.
User Story titles
The title is the user story sentence. Use exactly:
As a …, I need …, so that …
- Name a real role in the first clause (
CineMotion operator,poster-board owner,technician). - State the need in plain business language in the second clause.
- State the outcome or benefit in the third clause.
- Do not repeat the title as a separate “User story” field in the description.
- Prefer
As a poster-board owner, I need to update from the mobile app without losing my playlists, so that I can stay current without a technician visitoverImprove updates.
Task and Issue titles
Child tasks and issues use verb-led, implementation-output-focused titles:
- Start with a clear verb:
Implement,Build,Deliver,Track,Show,Move, orProve. - Name the resource or surface, the key behavior, and the critical constraint when it changes the work.
- Prefer
Implement the import API with duplicate detection and a review outcomeoverImprove imports. - Do not use vague titles such as
Support,Improve,Update,Handle,Investigate, or a source-document heading unless the output is obvious.
User-story draft format
Use this structure:
- Title —
As a …, I need …, so that …(this is the Azure Boards title; do not duplicate it elsewhere). - Detailed description — desired business outcome, end-to-end flow, data created/changed, roles, API behavior, security/reliability constraints, and the one supported creation/mutation path.
- In scope — concrete capabilities and records.
- Acceptance criteria — numbered, observable outcomes. Cover happy path, permissions, invalid actions, conflicts/retries, and data integrity where relevant.
- Definition of Done — implementation evidence: migration/configuration, API/UI, automated tests, security/audit proof, accessibility for UI, and zero-warning quality gate.
- Explicitly out of scope — only meaningful boundaries from the sources.
- Child-ticket decomposition — independently deliverable tasks with outcome-based titles.
- Sources — exact documents and relevant sections.
Child-task draft format
Make each task independently implementable and testable. Include:
- Standalone title
- Description — precise component/resource, inputs and outputs, data/persistence behavior, routes, permission model, and relevant architecture constraints.
- Acceptance criteria — concrete API/status/data/role outcomes.
- Definition of Done — migration/configuration, implementation, tests, security/audit evidence, and quality commands.
- Out of scope — adjacent work intentionally left to another task or phase.
Use exact API paths, HTTP status codes, entity names, workflow transitions, security rules, transaction boundaries, and retry/idempotency behavior only when supported by the source evidence. If a detail is not specified, label it as a decision rather than asserting it.
Quality bar
- Use simple English, but retain exact technical names where they remove ambiguity.
- Separate business outcome from implementation mechanism.
- Treat validation, authorization, encryption, auditability, rollback, and idempotency as acceptance criteria when applicable, not vague quality notes.
- For UI tasks, include keyboard access, visible focus, labels, validation messaging, empty/error states, and server-enforced authorization.
- For API/data tasks, include strict schemas, error behavior, unauthorized/out-of-scope behavior, persistence, and automated test cases.
- Do not duplicate a parent story in every child task. Give each task one clear, non-overlapping responsibility.
- Do not make a task about an external-system integration when the source material only requires tracking, manual hand-off, or another narrower behavior.
- Do not add infrastructure, automation, integrations, or process steps that are not supported by the evidence.
Estimation and hierarchy
- Default hierarchy is the user's stated iteration/sprint → User Story → child Tasks. Do not add Epic or Feature unless requested.
- Estimate child tasks, not the parent story, unless the user asks otherwise.
- Make estimates additive and show the total. If a budget is given, allocate exactly to it.
- When requested, set Original Estimate and Remaining Work to the same initial value on every new task.
- Keep test/quality work visible as dedicated child tasks; do not hide it inside every implementation estimate.
Publishing to Azure Boards
Publish only after explicit user authorization.
- Use the
azure-axiskill and CLI for Azure Boards operations. - Use the project from
AGENTS.mdunless the user specifies another project. - Never assume the current iteration is the intended sprint. Use the exact iteration path supplied by the user; if the target is ambiguous or has a similarly named sprint, ask before creating anything.
- Create the User Story first, then create every child Task with that story as parent.
- Attach the detailed Markdown description, assign requested estimates, and set Remaining Work equal to Original Estimate when requested. If the wrapper cannot set Remaining Work, use the narrow Azure Boards field update only for the newly created task IDs.
- Verify only the explicitly targeted work items and report the created IDs, hierarchy, iteration, total estimate, and any board-side automation such as state changes.
Default response
Lead with the draft and state clearly whether Azure Boards was changed. Offer to publish only after the user approves the wording.
04 同仓库更多 Skills
work
Runs an Azure ticket delivery loop: fetch tickets, plan against design docs, implement via sub-agents, record before/after videos, run quality gates and CodeRabbit, then post ticket comments and commit only when asked. Use when the user says /work, names an Azure ticket or user story, or asks for a before/after video or ticket comment.
video-to-transcript
Use when the user wants to convert a local video or meeting recording into a text transcript, especially MP4/MOV recordings. Covers extracting audio with ffmpeg and transcribing locally with faster-whisper.
ui-ux-pro-max
UI/UX design intelligence for web and mobile. Searchable local database with 84 styles, 192 color palettes, 74 font pairings, 192 product types, 98 UX guidelines, 104 icon entries, 16 GSAP motion presets, and 25 chart types across 22 stacks (React, Next.js, Vue, Nuxt, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, WPF, WinUI, Avalonia, Uno Platform, UWP, Three.js, and HTML/CSS). Use when designing, building, or reviewing UI: pages, components, color schemes, typography, layout, accessibility, animation, or data visualization.
ship-work
Use when shipping a software task end to end, with scope control and verified completion.
quick
Delegate task to fast model
meeting-mom
Use when the user wants to create Minutes of Meeting