Defame1297
0f2bb242ad
Regenerates `plugins/*/skills`, `plugins/*/agents`, both per-plugin `plugin.json` manifests and the two marketplace mirrors from `.apm/` per ADR-0017, via `scripts/sync-plugin-content.sh --all`. The manifests matter beyond tidiness here: `plugin.json` carries the plugin version and wins over the marketplace entry at install time (calculatePluginVersion precedence). Until this ran, the patch bumps in the preceding commit were inert for anyone installing these plugins. ADR: 0017 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EeH8SCbcrCAQrtymkNuhKP
64 lines
3.9 KiB
Markdown
64 lines
3.9 KiB
Markdown
---
|
|
name: gitea-labels-milestones
|
|
|
|
description: >
|
|
Use when reading or writing Gitea labels or milestones — "create a label", "what labels does
|
|
this repo have", "close the milestone" — or to resolve label names to IDs, or infer a
|
|
Kind/Priority/Status label from context, even when the user does not say "Gitea".
|
|
Not applying them to an issue -> `gitea-issues`. Not to a PR -> `gitea-prs`.
|
|
|
|
compatibility: Requires Gitea MCP server configured with write:issue and write:repository token scopes.
|
|
|
|
metadata:
|
|
category: integration
|
|
source_keys:
|
|
- gitea-mcp-repo
|
|
- gitea-mcp-slim-go
|
|
- context7-websites-gitea
|
|
- context7-gitea-tea-cli
|
|
version: "0.1.5"
|
|
|
|
allowed-tools: Bash mcp__gitea__label_read mcp__gitea__label_write mcp__gitea__milestone_read mcp__gitea__milestone_write
|
|
---
|
|
|
|
## Gotchas
|
|
|
|
- **Applying a label takes a numeric ID, but issue/PR responses slim labels down to name strings.** An issue's existing labels yield no IDs — resolve name → ID with `label_read`.
|
|
- **`pull_request_read` returns `milestone` as a bare title string** where `issue_read` returns `{id, title}` — recover the milestone's ID by listing milestones and matching the title.
|
|
- **Never assume a `Kind/*`/`Priority/*`/`Status/*` scope is exclusive — read each label's own `exclusive` field.** `list_repo_labels` returns it on every repo label, so it is always *readable* per label; `label_write` documents it as "(org only)" because it is only *settable* through the org create methods. Where it is `true` Gitea enforces one-per-scope itself, and replacing rather than stacking on a label whose `exclusive` is `false` destroys a valid label.
|
|
|
|
## Step 1 — Resolve owner, repo and org
|
|
|
|
Before any tool call, extract `owner` and `repo` from the git remote (skip this if an orchestrating caller already passed them in):
|
|
|
|
```bash
|
|
rtk git remote get-url origin
|
|
```
|
|
|
|
If origin is not set or the URL is not a Gitea URL, stop and report: "No Gitea remote found — set origin to your Gitea instance URL."
|
|
|
|
The `*_org_label*` methods take `org`, not `owner`/`repo`. Pass that same `owner` as `org` — it is the org name whenever the owner is an organisation, and the remote URL does not say whether it is one.
|
|
|
|
Read the failure text before interpreting it. `list_org_labels` needs the `read:organization` token scope, which this skill's declared scopes (`write:issue`, `write:repository`) do not carry, so it fails with `token does not have at least one of required scope(s), required=[read:organization]` *before* it ever determines org-vs-user. Report that: the org pool went unchecked, not empty. Only a not-found response is evidence the owner is a user account with no org pool.
|
|
|
|
## Step 2 — Dispatch
|
|
|
|
| Task | Tool | method |
|
|
|---|---|---|
|
|
| Resolve a label name to its ID | `label_read` | `"list_repo_labels"`, then `"list_org_labels"` |
|
|
| List repo labels | `label_read` | `"list_repo_labels"` |
|
|
| Get one repo label by ID | `label_read` | `"get_repo_label"` |
|
|
| List org labels | `label_read` | `"list_org_labels"` |
|
|
| Create a repo/org label | `label_write` | `"create_repo_label"` / `"create_org_label"` |
|
|
| Edit a repo/org label | `label_write` | `"edit_repo_label"` / `"edit_org_label"` |
|
|
| Delete a repo/org label | `label_write` | `"delete_repo_label"` / `"delete_org_label"` |
|
|
| List milestones | `milestone_read` | `"list"` |
|
|
| Get one milestone by ID | `milestone_read` | `"get"` |
|
|
| Create a milestone | `milestone_write` | `"create"` |
|
|
| Update / close a milestone | `milestone_write` | `"update"` |
|
|
| Delete a milestone | `milestone_write` | `"delete"` |
|
|
|
|
Every list method paginates manually — `per_page` defaults to 30, so iterate `page: 1, 2, ...` until a page returns fewer results than `per_page`. A truncated list silently breaks name → ID resolution.
|
|
|
|
If the task is a label operation, read `references/labels.md`; if a milestone operation, read `references/milestones.md`. If the label to apply has to be derived from conversation context rather than named, read `references/label-inference.md`.
|