This provides basic instructions for fetching issue details and summarising details about the issue for other agents.
Signed-off-by: Alex Bennée <[email protected]> --- .agents/skills/qemu-issue-helper/SKILL.md | 47 +++++++++++++++++++++++ AGENTS.md | 1 + 2 files changed, 48 insertions(+) create mode 100644 .agents/skills/qemu-issue-helper/SKILL.md diff --git a/.agents/skills/qemu-issue-helper/SKILL.md b/.agents/skills/qemu-issue-helper/SKILL.md new file mode 100644 index 00000000000..15ab983f083 --- /dev/null +++ b/.agents/skills/qemu-issue-helper/SKILL.md @@ -0,0 +1,47 @@ +--- +name: qemu-issue-helper +description: Summarize QEMU issue analysis. Help sub-agents report findings (build config, CLI, tests, GitLab issue data). Trigger when analyzing QEMU bugs/GitLab issues. +license: GPL-2.0-or-later +--- + +# QEMU Issue Helper + +Help sub-agent summarize issue analysis for main agent. + +## Fetch Issue Data + +Use `glab` for GitLab issues. Repo: `qemu-project/qemu`. + +### Commands +- **View issue**: `glab issue view <ID_OR_URL> -R qemu-project/qemu` +- **View comments**: `glab issue view <ID_OR_URL> -R qemu-project/qemu --comments` +- **Search issues**: `glab issue list -R qemu-project/qemu --search "<KEYWORDS>"` + +## Report Format + +Sub-agent MUST use this format for GitLab issue summary: + +### 1. Issue Context +- **Source**: GitLab URL/ID. +- **Title**: Brief description. +- **Reporter**: Username. +- **Relevant Commits**: Related commits mentioned in issue. + +### 2. Build & Reproduction (from issue) +- **Environment**: Host OS, CPU, QEMU version. +- **Build Config**: Required `configure` flags. +- **Reproduction CLI**: Exact QEMU command. + +### 3. Proposed Fixes & Series +- **Proposed Fixes**: Suggested code snippets or logic fixes. +- **Patch Series**: Linked patch series or MRs. + +### 4. Discussion Summary +- **Consensus**: Community understanding of bug. +- **Constraints**: Blockers, requirements, maintainer feedback. +- **Next Steps**: Action needed to proceed. + +## Rules +- **No Independent Analysis**: Summarize ONLY issue tracker data. No self-made root cause analysis. +- **Terse**: Keep it brief and technical. +- **Links**: Include direct links to comments or patches. diff --git a/AGENTS.md b/AGENTS.md index 9e373c98573..d842fc62e98 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,6 +51,7 @@ You should use the following specialized skills for common tasks: - `qemu-testing`: For finding, listing, and running individual tests (Unit, QTest, Functional, TCG). - `qemu-code-reviewer`: For pulling and applying patch series from mailing lists. - `qemu-mail-thread`: For analyzing and parsing mailing list threads. +- `qemu-issue-helper`: For fetching and summarising issue details from the bug tracker. ## Source Code Layout (see `docs/devel/codebase.rst`) - **`accel/`**: Hardware accelerators (KVM, TCG, HVF, Xen, etc.) and architecture-agnostic acceleration code. -- 2.47.3
