Not withstanding the current contributor policy there are a number of areas that AI agents could be helpful for. This series introduces an AGENTS.md file which is the basic guide to the source tree and a number of "skills". Skills are like scripts except far less clearly defined. However I have found the issue triage skill quite useful for off-loading the drudgery of going through stuff by hand. I've also used the issue helper to automate the task of starting a debug session by pulling in test cases from the tracker.
These originally where a set of skills for ECA (eca.dev) but I've ported them across to the agent agnostic .agents directory. All the references to ECA should now be removed. I have some personal tweaks in my ~/.config/eca that make agent specific suggestions. I'm not suggesting this is ready for up-streaming (or indeed should even go upstream) but I'm posting the collected set for comment and I'd be interested how well these hold up across different agentic systems. v2 - re-organised all the skills, now prefixed qemu-FOO - update AGENTS.md as we add each skill - moved a bunch of stuff from agents to skills - added a new script/expand_macro.py - see bellow --- in each patch for details The expand_macro is an attempt to make the code explorer more efficient and stop it getting confused by our heavy macro use. However the skill generally isn't performing as well as I'd like. I suspect a semcode MCP server (https://github.com/facebookexperimental/semcode) would be a better way to get agents to efficiently navigate the code base. The issue triage skill has so far proved to be the most useful and has seen a fair bit of tweaking since the last version. Alex. Alex Bennée (10): AGENTS.md: add basic AGENTS.md for QEMU scripts/expand-macro.py: helper script exploding macros .agents/skills: add qemu-code-explorer skill .agents/skills: add qemu-build skill .agents/skills: add qemu-testing skill .agents/skills: add qemu-code-reviewer skill .agents/skills: add qemu-mail-thread skill .agents/skills: add qemu-issue-helper skill .agents/skills: add qemu-issue-triage agent skill MAINTAINERS: add a section for AI agents MAINTAINERS | 6 + .agents/skills/qemu-build/SKILL.md | 50 ++++ .agents/skills/qemu-code-explorer/SKILL.md | 119 ++++++++ .../qemu-code-explorer/evals/evals.json | 26 ++ .agents/skills/qemu-code-reviewer/SKILL.md | 93 ++++++ .agents/skills/qemu-issue-helper/SKILL.md | 47 +++ .agents/skills/qemu-issue-triage/SKILL.md | 112 ++++++++ .../qemu-issue-triage/assets/labels.txt | 133 +++++++++ .../skills/qemu-issue-triage/evals/evals.json | 18 ++ .../scripts/update_labels.sh | 16 ++ .agents/skills/qemu-mail-thread/SKILL.md | 34 +++ .../scripts/qemu_mail_parser.py | 98 +++++++ .agents/skills/qemu-testing/SKILL.md | 56 ++++ .gitignore | 1 + AGENTS.md | 85 ++++++ scripts/expand-macro.py | 272 ++++++++++++++++++ 16 files changed, 1166 insertions(+) create mode 100644 .agents/skills/qemu-build/SKILL.md create mode 100644 .agents/skills/qemu-code-explorer/SKILL.md create mode 100644 .agents/skills/qemu-code-explorer/evals/evals.json create mode 100644 .agents/skills/qemu-code-reviewer/SKILL.md create mode 100644 .agents/skills/qemu-issue-helper/SKILL.md create mode 100644 .agents/skills/qemu-issue-triage/SKILL.md create mode 100644 .agents/skills/qemu-issue-triage/assets/labels.txt create mode 100644 .agents/skills/qemu-issue-triage/evals/evals.json create mode 100755 .agents/skills/qemu-issue-triage/scripts/update_labels.sh create mode 100644 .agents/skills/qemu-mail-thread/SKILL.md create mode 100644 .agents/skills/qemu-mail-thread/scripts/qemu_mail_parser.py create mode 100644 .agents/skills/qemu-testing/SKILL.md create mode 100644 AGENTS.md create mode 100755 scripts/expand-macro.py -- 2.47.3
