ВяткинАртём
e5dc08987d
- Introduced "Docker Build & Test Engineer" agent for building and testing Docker images. - Added "TestLink Autotest Engineer" agent for generating and verifying autotests from TestLink cases. - Created "Branch Review Engineer" agent for reviewing branch diffs and proposing improvements. - Developed "OpenWrt VPN & Network Engineer" agent for designing and implementing OpenWrt networking with VPN. - Established a structured directory for agents, skills, prompts, instructions, and hooks under `.github/`. - Implemented detailed skills for branch review processes, including reading code, analyzing improvements, and applying changes. - Added skills for OpenWrt network discovery, VPN routing, and hardening. - Created README files for better documentation and navigation of the repository structure.
112 lines
4.5 KiB
Markdown
112 lines
4.5 KiB
Markdown
# Agents Index
|
|
|
|
This file is the top-level index for the custom agents in this repository.
|
|
|
|
## Layout Convention
|
|
|
|
- Canonical agent file: `.github/agents/<agent-name>.agent.md`
|
|
- Canonical skills: `.github/skills/<skill-name>/SKILL.md`
|
|
|
|
The `agents` directory contains only agent definitions.
|
|
All skills are centralized under `.github/skills/`.
|
|
|
|
## Agent Overview
|
|
|
|
| Agent | Purpose | Canonical Agent File | Canonical Skills Dir | Tools |
|
|
|---|---|---|---|---|
|
|
| Branch Review Engineer | Reviews branch diffs, proposes improvements, checks TestLink coverage for changed autotests, and applies approved fixes | `branch-review.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo` |
|
|
| Docker Build & Test Engineer | Builds, validates, and repairs Docker images and container startup flows | `docker-build-test.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `ms-azuretools.vscode-containers/containerToolsConfig`, `todo` |
|
|
| OpenWrt VPN & Network Engineer | Designs and validates OpenWrt VPN routing with DNS policy, split tunneling, GeoIP/ASN selectors, and selective tunnel rules by destination IP/domain | `openwrt-network.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `web`, `io.github.upstash/context7/*`, `todo` |
|
|
| TestLink Autotest Engineer | Generates autotests from TestLink cases, reviews them, and stabilizes the resulting test runs | `testlink-autotest.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo` |
|
|
|
|
## Skills by Agent
|
|
|
|
### Branch Review Engineer
|
|
|
|
- Agent: [branch-review.agent.md](branch-review.agent.md)
|
|
- Tools: `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo`
|
|
- Skills:
|
|
- `branch-review-read-code`
|
|
- `branch-review-analyze`
|
|
- `branch-review-check-testlink`
|
|
- `branch-review-propose`
|
|
- `branch-review-apply`
|
|
- Workflow shape:
|
|
- read branch context and `pyproject.toml`
|
|
- analyze improvements
|
|
- optionally verify changed autotests against TestLink
|
|
- propose improvements
|
|
- apply only approved items
|
|
- Confirmation points:
|
|
- before applying proposed fixes
|
|
- when risky refactoring would exceed the changed scope
|
|
|
|
### Docker Build & Test Engineer
|
|
|
|
- Agent: [docker-build-test.agent.md](docker-build-test.agent.md)
|
|
- Tools: `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `ms-azuretools.vscode-containers/containerToolsConfig`, `todo`
|
|
- Skills:
|
|
- `dockerfile-builder`
|
|
- `dockerfile-tester`
|
|
- Workflow shape:
|
|
- build draft container setup
|
|
- validate build and runtime
|
|
- loop on targeted repairs up to the retry limit
|
|
- Confirmation points:
|
|
- after retry limit is hit
|
|
- when required runtime inputs cannot be inferred
|
|
|
|
### TestLink Autotest Engineer
|
|
|
|
- Agent: [testlink-autotest.agent.md](testlink-autotest.agent.md)
|
|
- Tools: `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo`
|
|
- Skills:
|
|
- `testlink-decompose`
|
|
- `autotest-writer`
|
|
- `python-review`
|
|
- `test-runner`
|
|
- `testlink-to-autotest`
|
|
- Workflow shape:
|
|
- fetch and decompose TestLink case
|
|
- write autotests from mini-tests
|
|
- review and improve test code
|
|
- run and stabilize tests
|
|
- Confirmation points:
|
|
- after mini-test decomposition
|
|
- after optional green-tier suggestions from review
|
|
|
|
### OpenWrt VPN & Network Engineer
|
|
|
|
- Agent: [openwrt-network.agent.md](openwrt-network.agent.md)
|
|
- Tools: `execute`, `read`, `edit`, `search`, `web`, `io.github.upstash/context7/*`, `todo`
|
|
- Skills:
|
|
- `openwrt-network-discovery`
|
|
- `openwrt-vpn-routing`
|
|
- `openwrt-network-hardening`
|
|
- Workflow shape:
|
|
- discover topology, policy constraints, and MCP/webhook requirements
|
|
- design VPN and routing for xray/sing-box/WireGuard/OpenVPN
|
|
- harden deployment and validate split tunnel/GeoIP/ASN behavior
|
|
- Confirmation points:
|
|
- after discovery summary and before config planning
|
|
- before execution of routing changes
|
|
- when MCP/webhook integration data is incomplete
|
|
|
|
## Canonical Paths
|
|
|
|
These are canonical and should remain stable:
|
|
|
|
- `.github/agents/branch-review.agent.md`
|
|
- `.github/agents/docker-build-test.agent.md`
|
|
- `.github/agents/openwrt-network.agent.md`
|
|
- `.github/agents/testlink-autotest.agent.md`
|
|
- `.github/skills/*`
|
|
|
|
## When to Update This File
|
|
|
|
Update this index when:
|
|
|
|
- a new agent is added
|
|
- an agent gains or loses skills
|
|
- confirmation points or workflow stages change materially
|
|
- compatibility exports are renamed or removed |