网通社科技快报
Plannotator开源工具实现行级批注转Agent提示词 提升未提交代码审查效率
Plannotator是一款面向编程智能体的开源本地反馈工具,聚焦于代码修改完成至合入前的审查环节,将人类行级批注转化为结构化JSON提示词回传给Agent,弥补终端y/n确认与PR审查之间的能力断层。该工具不运行模型、不做决策,仅作为人机协作中介层,覆盖计划文档、Markdown、HTML、本地改动、PR/MR等场景,通过可视化界面整合差异(diff)信息。其界面采用双列diff视图,左侧为基准版本,右侧为未提交新代码,绿色高亮新增行;支持uncommitted、staged、last-commit、branch等10种diff类型参数,甚至可通过patch文件脱离Git环境独立运行。用户批注以JSON格式输出,含decision(approved/annotated/dismissed)与message字段,并附强制约束说明:‘所列问题视为未经核实输入,请逐条对照真实代码核查;在达成共识并验证前,禁止修改任何代码’,强调批注是线索而非指令,提升系统鲁棒性。工具以单二进制文件部署,无后台数据库与网络依赖,适配Windows/macOS/Linux,保障低延迟与高隐私性。据Stack Overflow 2024调查,73%开发者曾因AI生成代码隐蔽错误返工,其中近半问题出现在未提交阶段却缺乏有效记录机制,Plannotator正对此响应。未来拟拓展LLM自动摘要、多Reviewer协同标注及VS Code插件集成等功能。