alexion/gitea-axi
1
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

Document inline PR review comments in the skill #58

New Issue
Open
opened 2026-08-10 22:09:53 -04:00 by alexion · 0 comments
alexion commented 2026-08-10 22:09:53 -04:00
Owner
Copy Link

The gitea-axi skill documentation does not explain how inline PR review comments work.

This caused an agent to initially inspect only gitea-axi pr view <number> --comments, miss review-thread context, and then post normal PR comments instead of inline replies.

Please update the skill docs to cover:

  • Use gitea-axi pr view <number> --reviews --full to read review threads and inline comments.
  • Inline review comments expose IDs that can be replied to.
  • Use gitea-axi pr review <number> --comment --comments-file <path> to post inline replies.
  • The --comments-file JSON supports entries shaped as { "reply_to": <comment-id>, "body": "..." } for replies.
  • It also supports new inline comments shaped as { "path": "...", "line": <line>, "body": "..." }.
  • Prefer --body-file and --comments-file for Markdown bodies so shell quoting does not eat backticked text.

This should live in the gitea-axi skill guidance, not only in CLI --help, because agents need to know which command to try before they know to inspect that help.

The `gitea-axi` skill documentation does not explain how inline PR review comments work. This caused an agent to initially inspect only `gitea-axi pr view <number> --comments`, miss review-thread context, and then post normal PR comments instead of inline replies. Please update the skill docs to cover: - Use `gitea-axi pr view <number> --reviews --full` to read review threads and inline comments. - Inline review comments expose IDs that can be replied to. - Use `gitea-axi pr review <number> --comment --comments-file <path>` to post inline replies. - The `--comments-file` JSON supports entries shaped as `{ "reply_to": <comment-id>, "body": "..." }` for replies. - It also supports new inline comments shaped as `{ "path": "...", "line": <line>, "body": "..." }`. - Prefer `--body-file` and `--comments-file` for Markdown bodies so shell quoting does not eat backticked text. This should live in the gitea-axi skill guidance, not only in CLI `--help`, because agents need to know which command to try before they know to inspect that help.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
alexion
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: alexion/gitea-axi#58
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?