feat: add Gitea CLI integration rules and interaction skill documentation

2026-05-22 19:22:15 +01:00
parent 548aca6bee
commit e8a149427a
2 changed files with 184 additions and 0 deletions
@@ -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" \
+  <issue_index>
+```
+To remove labels:
+```bash
+/usr/local/bin/tea issues edit \
+  --login sofarr \
+  --repo Gandalf/sofarr \
+  --remove-labels "Priority/Low" \
+  <issue_index>
+```
+
+### Commenting on an Issue/PR
+```bash
+/usr/local/bin/tea comment \
+  --login sofarr \
+  --repo Gandalf/sofarr \
+  <issue_index> "[Resolution or update details]"
+```
+
+### Closing an Issue
+```bash
+/usr/local/bin/tea issues close \
+  --login sofarr \
+  --repo Gandalf/sofarr \
+  <issue_index>
+```
+
+### Reopening an Issue
+```bash
+/usr/local/bin/tea issues reopen \
+  --login sofarr \
+  --repo Gandalf/sofarr \
+  <issue_index>
+```
+
+## 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
+```
+```
+***
@@ -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 \
+  <issue_index> "[Resolution or update details]"
+```
+
+### Closing an Issue
+```bash
+/usr/local/bin/tea issues close \
+  --login sofarr \
+  --repo Gandalf/sofarr \
+  <issue_index>
+```
+
+### Reopening an Issue
+```bash
+/usr/local/bin/tea issues reopen \
+  --login sofarr \
+  --repo Gandalf/sofarr \
+  <issue_index>
+```
+
+## 4. Verification Check
+To verify login configurations and connectivity without making modifications, use:
+```bash
+/usr/local/bin/tea logins list
+```
+```
+***