Refine Requirement or Issue — GitHub Copilot subagent
Enriches GitHub issues with testable acceptance criteria and technical dependencies directly in your repository.
.github/agents/refine-issue.agent.mdWhat Refine Requirement or Issue does
This subagent inspects existing GitHub issues and turns brief task descriptions into detailed requirements. It builds testable acceptance criteria and outlines technical dependencies. The agent also notes potential edge cases and adds suggestions for effort estimation.
Under the hood, the subagent relies on GitHub tools such as get_issue and update_issue. It modifies the issue description directly. Copilot needs read and write permissions for repository issues to complete these edits.
Install this subagent if your backlog suffers from vague, one-line issues. Teams that already manage specifications in external issue trackers can safely skip it.
What it helps with
- generate testable acceptance criteria for GitHub issues
- identify technical dependencies and edge cases early
- outline non-functional requirements in task descriptions
- estimate development effort for backlog tickets
Example prompts for the agent
- refine
- refine-issue
How to install Refine Requirement or Issue
Manually: put the files in place
.github/agents/refine-issue.agent.mdManually: put the files in place
.claude/agents/refine-issue.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention. Copilot names tools its own way in the tools field: remove it or rewrite it for Claude Code
Manually: put the files in place
.codex/agents/refine-issue.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/refine-issue.mdCursor also reads .claude/agents/
From the same set554
The whole set →Similar
Questions about Refine Requirement or Issue
How to install Refine Requirement or Issue for GitHub Copilot?
Add the agent configuration file to your repository at .cursor/agents/refine-issue.md or .claude/agents/refine-issue.md.
What does Refine Requirement or Issue do?
It reads an existing issue, gathers context, and rewrites the description with acceptance criteria, dependencies, and risks.
What tools does this subagent require?
It uses GitHub tools including get_issue, search_issues, and update_issue to inspect and edit repository issues.
Source text
refine-issue.agent.md · MIT
--- description: 'Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs' name: 'Refine Requirement or Issue' tools: [ 'list_issues','githubRepo', 'search', 'add_issue_comment','create_issue','create_issue_comment','update_issue','delete_issue','get_issue', 'search_issues'] --- # Refine Requirement or Issue Chat Mode When activated, this mode allows GitHub Copilot to analyze an existing issue and enrich it with structured details including: - Detailed description with context and background - Acceptance criteria in a testable format - Technical considerations and dependencies - Potential edge cases and risks - Expected NFR (Non-Functional Requirements) ## Steps to Run 1. Read the issue description and understand the context. 2. Modify the issue description to include more details. 3. Add acceptance criteria in a testable format. 4. Include technical considerations and dependencies. 5. Add potential edge cases and risks. 6. Provide suggestions for effort estimation. 7. Review the refined requirement and make any necessary adjustments. ## Usage To activate Requirement Refinement mode: 1. Refer an existing issue in your prompt as `refine <issue_URL>` 2. Use the mode: `refine-issue` ## Output Copilot will modify the issue description and add structured details to it.
© github · MIT · github/awesome-copilot