feat(gitea): add gitea-workflow skill (human-facing dispatcher)

Adds the human-facing entry point and dispatcher for the Gitea
integration per docs/adr/0011-gitea-skill-deep-modules.md. Preserves
the retired flat skill's default no-args status view (open issues +
open PRs, composed via list_issues/list_pull_requests) and extends
its dispatch table to route ambiguous requests across all 6 domain
skills (issues, labels/milestones, prs, branches, files, releases) —
the old table only covered 4 of these. The skill only calls
gitea-mcp tools directly for the composed status view; every other
operation is a routed handoff to the owning sibling skill, keeping
execution logic (call signatures, gotchas, confirmation gates) owned
in one place.

Bumps plugins/gitea version 1.1.0 -> 1.2.0 in both manifests for the
new skill. Passed structural validation, provenance validation, and
an independent clean-context skill-audit recheck (one finding fixed:
allowed-tools was missing the Skill tool needed for routing).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FNJWdVvdgvZCHi1hZGqgVQ
This commit is contained in:
2026-07-05 11:16:31 +00:00
parent bc094819a5
commit 0f138f27db
6 changed files with 175 additions and 2 deletions

View File

@@ -0,0 +1,48 @@
# Sources
**Note on scope:** this skill has no fresh research corpus of its own — it is pure composition/
routing over the 6 already-researched domain skills and the retired flat skill. The two entries
below that carry `context7`/`gitea.com` URLs back the two gitea-mcp tool calls this skill makes
directly (`list_issues`, `list_pull_requests`, for the composed status view); the routing table
itself is sourced from the domain skills' own descriptions and the flat skill's dispatch table
(the `gitea-flat-skill-dispatch` entry below).
## gitea-mcp-repo
- **URL:** https://gitea.com/gitea/gitea-mcp
- **Description:** Official gitea-mcp repository (v1.3.0); operation/*.go source files documenting all 55 MCP tools, their parameters, and CLI flags. Backs the `list_issues`/`list_pull_requests` call shapes used in the composed status view.
- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
- **Contributing files:** SKILL.md
- **Status:** `extracted`
## gitea-mcp-slim-go
- **URL:** https://gitea.com/gitea/gitea-mcp/raw/branch/main/operation/issue/slim.go
- **Description:** Slim response shape structs from gitea-mcp source; confirms `list_issues`/`list_pull_requests` return one page per call with no server-side issue/PR type filter, informing why the status view calls both tools separately rather than assuming a combined feed.
- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
- **Contributing files:** SKILL.md
- **Status:** `extracted`
## context7-websites-gitea
- **URL:** context7:/websites/gitea
- **Description:** Official Gitea docs mirror on Context7 (docs.gitea.com content) — general issue/PR/branch/release vocabulary used to phrase the routing table's trigger examples consistently with Gitea's own terminology.
- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
- **Contributing files:** SKILL.md
- **Status:** `extracted`
## context7-gitea-tea-cli
- **URL:** context7:/git_gitea_com/gitea_tea
- **Description:** Official `tea` CLI (reference Gitea client) docs on Context7 — practitioner command patterns for issues, PRs, and releases. Consulted for completeness against the shared research doc; this skill is pure routing/composition with no CLI-command-pattern content of its own, so it contributes nothing here (see `gitea-issues`/`gitea-releases` for where this source actually informs content).
- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md
- **Contributing files:** (none)
- **Status:** `extracted`
## gitea-flat-skill-dispatch
- **Description:** This org's retired flat Gitea skill (`plugins/bin/skills/gitea/SKILL.md`) — its "Step 2 — Dispatch" table (5 domains: issues, labels, milestones, PRs, branches) and "Status (default)" behavior are the direct lineage this skill's routing table and default status view generalize across all 6 current domain skills, adding `gitea-files` and `gitea-releases` as new routing targets per `docs/adr/0011-gitea-skill-deep-modules.md`.
- **Source:** org-internal (`plugins/bin/skills/gitea/SKILL.md`, kept in place as a fallback reference, not deleted)
- **Research doc:** none — org-internal skill lineage, not part of the plugin's external research corpus (same pattern as `git-workflow`'s `org-git-conventions` entry)
- **Contributing files:** SKILL.md
- **Status:** `extracted`