From e8a149427a86b6910538f164b86131ae69c3ac47 Mon Sep 17 00:00:00 2001 From: Gronod Date: Fri, 22 May 2026 19:22:15 +0100 Subject: [PATCH] feat: add Gitea CLI integration rules and interaction skill documentation --- .agents/rules/tea-interaction.md | 116 ++++++++++++++++++++ .windsurf/skills/gitea-interaction/SKILL.md | 68 ++++++++++++ 2 files changed, 184 insertions(+) create mode 100644 .agents/rules/tea-interaction.md create mode 100644 .windsurf/skills/gitea-interaction/SKILL.md diff --git a/.agents/rules/tea-interaction.md b/.agents/rules/tea-interaction.md new file mode 100644 index 0000000..f95c3ed --- /dev/null +++ b/.agents/rules/tea-interaction.md @@ -0,0 +1,116 @@ +--- +trigger: model_decision +description: The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata. +--- + +```markdown +# Gitea CLI (tea) Integration Guidelines + +The repository is connected to a private Gitea instance. The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata. + +## 1. CLI Location & Login Context +- **Binary Path**: `/usr/local/bin/tea` +- **Gitea Base URL**: `https://git.i3omb.com` +- **Username**: `Gandalf` +- **Active Authenticated Login**: `sofarr` (Pre-configured with scopes `write:user,write:issue`) +- **Target Repository Slug**: `Gandalf/sofarr` + +## 2. Mandatory Non-Interactive Usage Rules +The CLI commands must be run non-interactively to avoid blocking terminal processes or prompting for user inputs. +- Always explicitly pass the `--login sofarr` (or `-l sofarr`) flag. +- Always explicitly pass the `--repo Gandalf/sofarr` (or `-r Gandalf/sofarr`) flag. + +## 3. Common Operations Reference + +### Listing Issues +```bash +/usr/local/bin/tea issues list --login sofarr --repo Gandalf/sofarr --state all +``` + +### Creating an Issue with Labels +```bash +/usr/local/bin/tea issues create \ + --login sofarr \ + --repo Gandalf/sofarr \ + --title "BUG: [Brief Title]" \ + --description "[Detailed description of the issue, reproducing steps, and context]" \ + --labels "Kind/Bug" +``` + +### Adding/Editing Labels on an Existing Issue +To add labels without removing existing ones: +```bash +/usr/local/bin/tea issues edit \ + --login sofarr \ + --repo Gandalf/sofarr \ + --add-labels "Kind/Bug,Priority/High" \ + +``` +To remove labels: +```bash +/usr/local/bin/tea issues edit \ + --login sofarr \ + --repo Gandalf/sofarr \ + --remove-labels "Priority/Low" \ + +``` + +### Commenting on an Issue/PR +```bash +/usr/local/bin/tea comment \ + --login sofarr \ + --repo Gandalf/sofarr \ + "[Resolution or update details]" +``` + +### Closing an Issue +```bash +/usr/local/bin/tea issues close \ + --login sofarr \ + --repo Gandalf/sofarr \ + +``` + +### Reopening an Issue +```bash +/usr/local/bin/tea issues reopen \ + --login sofarr \ + --repo Gandalf/sofarr \ + +``` + +## 4. Standard Labels Reference +Always use one or more of the following pre-configured labels when creating or updating issues: + +| Type | Label Name | Description | +|---|---|---| +| **Kinds** | `Kind/Bug` | Something is not working | +| | `Kind/Feature` | New functionality | +| | `Kind/Enhancement` | Improve existing functionality | +| | `Kind/Documentation` | Documentation changes | +| | `Kind/Security` | Security issues and patches | +| | `Kind/Testing` | Issue or PR related to testing | +| **Priorities** | `Priority/Critical` | Critical/blocking issue | +| | `Priority/High` | High priority | +| | `Priority/Medium` | Medium priority | +| | `Priority/Low` | Low priority | +| **Compatibility** | `Compat/Breaking` | Breaking change that won't be backward compatible | +| **Review** | `Reviewed/Confirmed` | Issue has been confirmed/verified | +| | `Reviewed/Duplicate` | Duplicate of another issue or PR | +| | `Reviewed/Invalid` | Invalid issue or question | +| | `Reviewed/Won't Fix` | Decision made not to address this issue | +| **Status** | `Status/Blocked` | Blocked by other dependencies/tasks | +| | `Status/Abandoned` | Work started but currently abandoned | +| | `Status/Need More Info` | Awaiting more feedback/information to proceed | + +## 5. Verification Check +To verify login configurations and connectivity without making modifications, use: +```bash +/usr/local/bin/tea logins list +``` +To list all active labels in the repository: +```bash +/usr/local/bin/tea labels list --login sofarr --repo Gandalf/sofarr +``` +``` +*** \ No newline at end of file diff --git a/.windsurf/skills/gitea-interaction/SKILL.md b/.windsurf/skills/gitea-interaction/SKILL.md new file mode 100644 index 0000000..7743d03 --- /dev/null +++ b/.windsurf/skills/gitea-interaction/SKILL.md @@ -0,0 +1,68 @@ +--- +name: gitea-interaction +description: The repository is connected to a private Gitea instance. The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata. +--- + +# Gitea CLI (tea) Integration Guidelines + + + +## 1. CLI Location & Login Context +- **Binary Path**: `/usr/local/bin/tea` +- **Gitea Base URL**: `https://git.i3omb.com` +- **Username**: `Gandalf` +- **Active Authenticated Login**: `sofarr` (Pre-configured with scopes `write:user,write:issue`) +- **Target Repository Slug**: `Gandalf/sofarr` + +## 2. Mandatory Non-Interactive Usage Rules +The CLI commands must be run non-interactively to avoid blocking terminal processes or prompting for user inputs. +- Always explicitly pass the `--login sofarr` (or `-l sofarr`) flag. +- Always explicitly pass the `--repo Gandalf/sofarr` (or `-r Gandalf/sofarr`) flag. + +## 3. Common Operations Reference + +### Listing Issues +```bash +/usr/local/bin/tea issues list --login sofarr --repo Gandalf/sofarr --state all +``` + +### Creating an Issue +```bash +/usr/local/bin/tea issues create \ + --login sofarr \ + --repo Gandalf/sofarr \ + --title "BUG: [Brief Title]" \ + --description "[Detailed description of the issue, reproducing steps, and context]" +``` + +### Commenting on an Issue/PR +```bash +/usr/local/bin/tea comment \ + --login sofarr \ + --repo Gandalf/sofarr \ + "[Resolution or update details]" +``` + +### Closing an Issue +```bash +/usr/local/bin/tea issues close \ + --login sofarr \ + --repo Gandalf/sofarr \ + +``` + +### Reopening an Issue +```bash +/usr/local/bin/tea issues reopen \ + --login sofarr \ + --repo Gandalf/sofarr \ + +``` + +## 4. Verification Check +To verify login configurations and connectivity without making modifications, use: +```bash +/usr/local/bin/tea logins list +``` +``` +*** \ No newline at end of file