/work-item

PURPOSE

Provide a unified interface for retrieving and managing work items across multiple DevOps platforms, enabling developers to quickly access and filter work item information.

EXECUTION

1. Platform Detection

   • Automatically detect available work item platforms
   • Use configured credentials from workspace configuration
   • Fallback to specified platform if provided

2. Work Item Retrieval

   • Connect to selected platform's API via MCP TOOL
   • Apply provided filters sequentially
   • Retrieve work items matching filter criteria

3. Output Processing

   • List View: Format multiple results in standardized CLI-friendly table
   • Detail View: Display complete work item information when a specific work item is specified
   • Normalize work item attributes across platforms
   • Handle platform-specific metadata

DELEGATION

MANDATORY: Always invoke the agents defined in this command's frontmatter for their designated responsibilities. Never skip, replace, or simulate their behavior directly.

• zzaia-devops-specialist — Retrieve, query, and manage work items across Azure DevOps and GitHub

WORKFLOW

sequenceDiagram
    participant U as User
    participant C as /behavior:devops:work-item
    participant A as WorkItem Agents
    participant P as DevOps Platforms

    U->>C: Execute with filters
    C->>A: Translate filters
    A->>P: Query work items
    P-->>A: Return work items
    A->>C: Process and normalize results
    C-->>U: Display formatted work items

ACCEPTANCE CRITERIA

• Successfully connect to at least one DevOps platform
• Apply all specified filters correctly
• Return work items in consistent format
• Handle platform-specific variations
• Provide clear error messages for configuration issues

EXAMPLES

# List recent project work items
/behavior:devops:work-item --project "Finance" --limit 10

# Find specific work item (detailed view)
/behavior:devops:work-item --id 46104

# Filter by assignee and status
/behavior:devops:work-item --assignee "john.doe" --status "Active"

# Time-based filtering
/behavior:devops:work-item --since "2025-09-01" --project "Crypto Hub"

# Specify platform explicitly
/behavior:devops:work-item --platform azure --project "Engineering"

OUTPUT FORMAT

List View (Multiple Work Items)

PLATFORM  ID     TITLE                      STATUS   ASSIGNEE   UPDATED
---------------------------------------------------------------
Azure     46104  Implement OAuth Flow       Active   john.doe   2025-09-10
GitHub    1205   Fix Authentication Bug     Open     jane.smith 2025-09-08
GitLab    9876   Update Documentation       Closed   team-lead  2025-09-05

Detailed View

• Complete work item information display

CONFIGURATION REQUIREMENTS

• Platform-specific API credentials stored in secure workspace configuration
• OAuth/Personal Access Token support
• Extensible plugin architecture for new platforms