mirror of
https://gerrit.googlesource.com/git-repo
synced 2026-07-16 13:47:03 +00:00
Gavin Mak
d32b70275c
With cl/930783235, this change sets up two AI review agents that run automatically on new changes. Bug: 522929179 Change-Id: I315a7ec327dd30af842ec890818cf697756fd55c Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/596721 Commit-Queue: Gavin Mak <gavinmak@google.com> Reviewed-by: Mike Frysinger <vapier@google.com> Tested-by: Gavin Mak <gavinmak@google.com>
43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# git-repo AI Review Agents (WIP)
|
|
|
|
**Note:** This project is a work in progress and is subject to change.
|
|
|
|
This directory contains configurations and skills for AI review agents that
|
|
automatically analyze changes in the `git-repo` codebase.
|
|
|
|
These agents help maintain code quality, enforce style guidelines, and catch
|
|
common pitfalls before code is merged.
|
|
|
|
## Directory Structure
|
|
|
|
* [`agent_configs.txtpb`](agent_configs.txtpb): Defines the active AI
|
|
agents, their configurations, and which skills they are equipped with.
|
|
* [`skills/`](skills/): Contains the "skills" (rules, guidelines, and traps)
|
|
used by the agents.
|
|
* [`code_review_workflow/`](skills/code_review_workflow/SKILL.md):
|
|
Guidelines for code review processes, commit messages, and testing.
|
|
* [`core_internals/`](skills/core_internals/SKILL.md): Technical
|
|
guidelines for `git-repo` core logic (sync, manifest, git integration,
|
|
etc.).
|
|
|
|
## How It Works
|
|
|
|
The agents defined in `agent_configs.txtpb` are configured to run
|
|
automatically on new changes. They analyze the diffs against the rules defined
|
|
in their respective skills and provide feedback in the code review interface
|
|
(e.g., Gerrit).
|
|
|
|
## Contributing
|
|
|
|
To improve the agent's review quality or add new rules:
|
|
|
|
1. **Update existing skills**: Modify the `SKILL.md` files under `skills/` to
|
|
add new rules, "What" explanations, "Why" rationales, and "Traps"
|
|
(Don't/Do code examples).
|
|
2. **Add new skills**:
|
|
* Create a new directory under `skills/`.
|
|
* Add a `SKILL.md` following the established format (see existing skills
|
|
for reference).
|
|
* Register the new skill in `agent_configs.txtpb` by adding it to the
|
|
`skills` field of an agent configuration.
|