Skip to main content
subagent GitHub Copilot official · GitHub

Refine Requirement or Issue — GitHub Copilot subagent

Enriches GitHub issues with testable acceptance criteria and technical dependencies directly in your repository.

Install into GitHub Copilot · Manually: put the files in place All methods and platforms ↓
.github/agents/refine-issue.agent.md
Open on GitHub

What 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.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

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

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor