用途：reviewr-comments 让代理与 herdr-reviewr 侧边栏共享同一 worktree 的评论存储，用于读取用户留下的代码审查评论、在代码中逐条处理，并留下自己的说明。
主要能力：列出未处理评论（人类可读、id 在前，或 --json 输出完整文档）；将评论标记为已解决；新增按文件与行范围锚定的评论，附带 diff 片段与文字说明。新增评论默认作者为 agent，会在一秒内以卡片形式显示在用户侧边栏，无需额外通知步骤。
使用方式：先定位二进制 herdr-reviewr，在 PATH 中查找（插件安装会链接到 ~/.local/bin）；若未找到且设置了 $HERDR_PLUGIN_ROOT，则使用 $HERDR_PLUGIN_ROOT/bin/herdr-reviewr；否则向用户询问插件根目录。所有命令需在正在工作的仓库中运行。常用命令：herdr-reviewr comment list、herdr-reviewr comment list --json、herdr-reviewr comment resolve <id>，以及带 --file、--start、--lines、--text 的 herdr-reviewr comment add。
处理循环：先 list 查看未处理项，再在代码中逐条处理，然后 resolve 标记完成；未实际处理的不要 resolve，应如实说明。留下自己的评论时，每条发现只写一条，使用能展示问题的最紧行范围，--text 保持一两句话。
限制与规则：不要用 comment rm 删除用户评论，resolve 归代理，rm 归用户。行号可能因代码变动而失效，应以评论附带的 lines 片段为准，在文件中找到该片段后再处理。