feat: Add new agents and skills for Docker, TestLink, and OpenWrt

- 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.
2026-04-08 09:47:18 +03:00
parent b6eb535e25
commit e5dc08987d
21 changed files with 1261 additions and 2 deletions
@@ -0,0 +1,112 @@
+# 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