Welcome to the GitHub Copilot for Repository Management Quest — an interactive learning experience designed for content developers who want to master GitHub Copilot's native features for repository management workflows. This quest simulates real-world scenarios using real Microsoft Learn documentation, covering common challenges like taking over unfamiliar repositories, triaging issue backlogs, and managing complex pull requests.
What makes this quest unique: You'll work with actual Microsoft Learn modules while mastering GitHub Copilot's workspace agent, custom agents, PR review, and external integrations (MCP tools).
By completing this quest, you will:
- Master GitHub Copilot workspace exploration — Use
@workspaceto quickly understand unfamiliar repositories - Create custom agents and prompts — Build specialized AI assistants for documentation tasks
- Implement efficient issue management — Use Copilot to categorize, prioritize, and triage issues
- Develop PR review skills — Leverage native Copilot PR review and
#prcontext - Configure advanced agents — Use tool permissions, model selection, and structured outputs
- Integrate external tools — Use MCP (Model Context Protocol) for documentation verification
| Part | Duration | Scenarios | Focus |
|---|---|---|---|
| Part 1: Fundamentals | ~60 min | Module 0, Scenarios 1-2 | Workspace setup, exploration, issue triage |
| Part 2: Advanced | ~80 min | Scenarios 3-4 | PR review, advanced agents, MCP tools |
Total Time: ~2.5 hours (can be done in separate sessions)
| Scenario | Name | Challenge |
|---|---|---|
| Module 0 | Workspace Preparation | Create custom agents and reusable prompts |
| Scenario 1 | The Inheritance | Take over an unfamiliar documentation repository |
| Scenario 2 | The Backlog Battle | Triage 12+ open issues efficiently |
| Scenario 3 | The Big Merge | Review a large PR with native Copilot features |
| Scenario 4 | The Agent Arsenal | Configure advanced agents with MCP integration |
- Git fundamentals: Basic understanding of repositories, commits, branches, and pull requests
- Markdown knowledge: Familiarity with markdown syntax
- GitHub Copilot: Active GitHub Copilot subscription (individual, business, or enterprise)
- Tools: VS Code with GitHub Copilot extensions, Git client, GitHub account
| Term | Definition |
|---|---|
| Repository | A folder containing your project's files, history, and version control data |
| Fork | A personal copy of someone else's repository on your GitHub account |
| Clone | Downloading a repository from GitHub to your local computer |
| Branch | A parallel version of your repository for isolated changes |
| Pull Request (PR) | A proposal to merge changes from one branch into another |
| Issue | A task, bug report, or feature request in a repository's issue tracker |
| Feature | Location | Format | Use Case |
|---|---|---|---|
| Agents | .github/agents/ |
.agent.md |
Specialized roles (e.g., Documentation Auditor) |
| Prompts | .github/prompts/ |
.prompt.md |
Reusable templates (e.g., Content Audit) |
| Instructions | .github/copilot-instructions.md |
Markdown | Repository-wide guidance for Copilot |
| MCP Tools | VS Code settings | JSON config | External integrations (GitHub, Microsoft Docs) |
- VS Code — Download from https://code.visualstudio.com/
- GitHub Copilot extensions — Install both:
- Activate Copilot — Sign in and link to your enterprise license: https://copilot.github.microsoft.com/
- Add MCP servers (required for Part 2):
- GitHub MCP server
- Microsoft.docs.mcp server
- See: https://code.visualstudio.com/mcp
-
Fork this repository — Click "Fork" at the top-right of this page
-
Clone your fork:
git clone https://github.com/[your-username]/github-repo-management-quest-learn.git cd github-repo-management-quest-learn code .
Run the GitHub Actions workflows to create sample issues and PRs:
- Go to your fork's Actions tab
- Run "Setup Quest Issues" — Creates sample issues for Scenario 2
- Run "Setup Quest PR" — Creates sample PR for Scenario 3
- ✅ Repository open in VS Code with Copilot active
- ✅ Sample issues visible in Issues tab (labeled
quest-sample) - ✅ Sample PR visible in Pull Requests tab
| Ready for... | Go to... |
|---|---|
| Part 1 (first time) | Part 1: Fundamentals |
| Part 2 (completed Part 1) | Part 2: Advanced |
If your fork falls behind:
- Go to your fork on GitHub.com
- Click Sync fork → Update branch
- Pull changes locally:
git pull
Quest Version: 2.0
Last Updated: 2025-01-06
Content: Microsoft Learn
Estimated Time: ~2.5 hours (Part 1: 60 min, Part 2: 80 min)
Difficulty: Beginner to Advanced