What problem does it solve?
This Skill prevents agents from accidentally deleting or drifting away from inline code review markers by tying each // @mai: comment to a backed mai ticket and enforcing a safe lifecycle for resolving them.
Core Features & Use Cases
- Create and manage inline review markers: Use // @mai: [pe-xxxx] comments to represent issues directly in code.
- Resolution tracking with mai tickets: Ensure each marker is backed by a mai ticket, supports adding resolution notes, and closing the ticket.
- Drift detection and guardrails: Detect when markers disappear without closing tickets and block edits that would cause drift.
- Thread visibility for agents: Let agents list, show, resolve, and check review comments as part of their editing workflow.
- Works with multi-line blocks: Capture continuation lines under the same comment prefix into a single ticket payload.
Quick Start
Use the review-comments Skill while editing the file containing // @mai: markers so the agent can list open comments, apply fixes, add resolution notes to the linked mai ticket, close it, and safely remove the corresponding // @mai: line.