Add workflow run URL detection and missing tool analysis to debug agent

[Copilot]

Task: Add Workflow Run URL Detection to Debug Agent

Plan

• Update debug-agentic-workflow.agent.md to detect workflow run URLs
  • Add URL detection pattern matching (https://github.com/*/actions/runs/*)
  • Extract run ID from URL
  • Automatically call gh aw audit <run-id> --json when URL is detected
  • Review missing tool reports from audit results
• Add instructions for analyzing missing tool calls
  • Parse safe-outputs section for missing tools
  • Identify which tool the agent tried to call but couldn't
  • Provide recommendations on fixing tool availability
• Add example flow for URL-based debugging
• Test the updated agent instructions manually
• Add note about using agentic-workflows tool when gh aw is not authenticated
• Use engine-agnostic tool names (not MCP-specific name mangling)
• Merge main branch

Changes Made

1. Added Quick Start Example - Shows how the agent should respond when given a workflow run URL
2. Enhanced Initial Discovery - Added support for accepting workflow run URLs in addition to workflow names
3. New Debug Flow: Workflow Run URL Analysis - Complete section with:
   • Run ID extraction from URLs
   • Audit command usage
   • Missing tool analysis steps
   • Common scenarios and fixes
   • Specific recommendations for different types of tool issues
4. Added Missing Tools Section - New subsection (Add workflow: githubnext/agentics/weekly-research #8) in "Common Issues to Look For" with:
   • Tool name mismatches
   • Configuration issues
   • Diagnostic steps
   • Common patterns and solutions
5. Added agentic-workflows Tool Alternative - Important note about using engine-agnostic agentic-workflows tool when gh aw is not authenticated
6. Used Engine-Agnostic Tool Names - Changed from MCP-specific names like agentic_workflows__audit to generic names like "Use the audit tool"
7. Merged main branch - Resolved conflicts and updated all lock files

Key Features

The debug agent now:

• ✅ Recognizes GitHub Actions workflow run URLs
• ✅ Extracts run IDs automatically
• ✅ Uses gh aw audit or agentic-workflows tool (engine-agnostic)
• ✅ Analyzes missing tool reports
• ✅ Provides specific fix recommendations
• ✅ Documents tool alternatives without MCP-specific name mangling
• ✅ Updated with latest changes from main branch

Original prompt

Investigate the reason there is a missing tool call in this run. It is not create a pull request

• update the debug agentic workflow agent source to detect workflow run URLs, use the audit tool to receive information about the run, review missing tools

Reference: https://github.com/githubnext/gh-aw/actions/runs/20135841934/job/57789059104#step:36:1

Custom agent used: debug-agentic-workflow
Debug and refine agentic workflows using gh-aw CLI tools - analyze logs, audit runs, and improve workflow performance

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot update the debug agentic workflow with this important note:

if gh aw is not auth (running in copilot agent), use the corresponding tools exposed by the GitHub-agentic-workflows MCP server

[Copilot]

@copilot update the debug agentic workflow with this important note:

if gh aw is not auth (running in copilot agent), use the corresponding tools exposed by the GitHub-agentic-workflows MCP server

Added note in commit abbd6a1. The debug agent now documents the GitHub-agentic-workflows MCP server tools as alternatives when gh aw is not authenticated:

• agentic_workflows__status → gh aw status
• agentic_workflows__audit → gh aw audit
• agentic_workflows__logs → gh aw logs
• agentic_workflows__compile → gh aw compile
• agentic_workflows__update → gh aw update
• agentic_workflows__add → gh aw add
• agentic_workflows__mcp_inspect → gh aw mcp inspect

The note appears in the "Key Commands Available" section and throughout the debug flows where CLI commands are referenced.

[pelikhan]

@copilot use agentic engine agnostic tool (MCP name mangling is specific)

[pelikhan]

@copilot continue work

[Copilot]

@copilot continue work

Updated in commit 14be8c7. Changed all MCP-specific references (agentic_workflows__audit, agentic_workflows__logs) to engine-agnostic tool names:

• Now uses: "Use the audit tool with run_id: ..."
• Now uses: "Use the logs tool with workflow_name: ..."
• References generic agentic-workflows tool instead of MCP name mangling

Both .github/agents/debug-agentic-workflow.agent.md and pkg/cli/templates/debug-agentic-workflow.agent.md have been updated.

[pelikhan]

@copilot merge main

[Copilot]

@copilot merge main

Merged main in commit 40ebdbb. Resolved conflict with .github/workflows/ai-triage-campaign.lock.yml (deleted file). Branch is now up to date with main.