From 527df936cb40de690958f6d916a2fe379b17ce45 Mon Sep 17 00:00:00 2001
From: Hugo Nijhuis <hugo@flowmade.one>
Date: Wed, 31 Dec 2025 16:53:49 +0100
Subject: [PATCH] Add tea comment command documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add Comments section to gitea skill with examples
- Update code-reviewer agent with explicit tea CLI commands
  for posting comments, approving, and merging PRs

Closes #6

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 agents/code-reviewer/AGENT.md |  6 +++---
 skills/gitea/SKILL.md         | 16 ++++++++++++++++
 2 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/agents/code-reviewer/AGENT.md b/agents/code-reviewer/AGENT.md
index b931eba..f0ccff1 100644
--- a/agents/code-reviewer/AGENT.md
+++ b/agents/code-reviewer/AGENT.md
@@ -13,7 +13,7 @@ You are a code review specialist that provides immediate, structured feedback on
 
 You will receive a PR number to review. Follow this process:
 
-1. Fetch PR diff using the gitea skill
+1. Fetch PR diff using `tea pulls <number> -f diff`
 2. Analyze the diff for issues in these categories:
    - **Code Quality**: Readability, maintainability, complexity
    - **Bugs**: Logic errors, edge cases, null checks
@@ -21,8 +21,8 @@ You will receive a PR number to review. Follow this process:
    - **Style**: Naming conventions, formatting, consistency
    - **Test Coverage**: Missing tests, untested edge cases
 3. Generate a structured review comment
-4. Post the review as a comment on the PR
-5. **If verdict is LGTM**: Auto-merge using rebase style
+4. Post the review using `tea comment <number> "<review body>"`
+5. **If verdict is LGTM**: Approve with `tea pulls approve <number>`, then auto-merge with `tea pulls merge <number> --style rebase`
 6. **If verdict is NOT LGTM**: Do not merge; leave for the user to address
 
 ## Review Comment Format
diff --git a/skills/gitea/SKILL.md b/skills/gitea/SKILL.md
index cadff41..66c71b0 100644
--- a/skills/gitea/SKILL.md
+++ b/skills/gitea/SKILL.md
@@ -112,6 +112,22 @@ tea repos <owner>/<repo>             # Repository info
 tea clone <owner>/<repo>             # Clone repository
 ```
 
+### Comments
+
+```bash
+# Add comment to issue or PR
+tea comment <number> "<comment body>"
+tea comment 3 "LGTM, ready to merge"
+
+# Multiline comments (use heredoc)
+tea comment 3 "$(cat <<'EOF'
+## Review Summary
+- Code looks good
+- Tests pass
+EOF
+)"
+```
+
 ### Notifications
 
 ```bash