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 ever 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. v3 - split AGENTS.md into two commits (so first can go upstream) - symlink GEMINI.md as it doesn't fallback to AGENTS.md - significantly de-scoped qemu-code-explorer - various other suggestions from last review 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. I have found the semcode MCP server (https://github.com/facebookexperimental/semcode) does a pretty good job of navigating code flows so I've de-scoped the code explorer just to deal with the trickier aspects of navigating the QEMU 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 (11): AGENTS.md: introduce a very basic guide for AI agents AGENTS.md: expand with information on skills, layout and style 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 | 88 ++++++ .../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 | 40 +++ .../scripts/qemu_mail_parser.py | 98 +++++++ .agents/skills/qemu-testing/SKILL.md | 56 ++++ .gitignore | 2 + AGENTS.md | 91 ++++++ GEMINI.md | 1 + scripts/expand-macro.py | 274 ++++++++++++++++++ 17 files changed, 1151 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 120000 GEMINI.md create mode 100755 scripts/expand-macro.py -- 2.47.3
