Plannotator Conventions 是 satanlittlehelper/ai-dev-kit 中的一项约定型技能,定位为对 Plannotator 系列评审能力的上层行为规范。它本身不实现评审界面的具体机制,而是要求在实际执行时调用相关的 plannotator/plannotator-* 子技能来完成界面部分,本技能负责规定长时间运行进程在途期间的处理方式,以及评审过程中与提交相关的注意事项。
主要能力与规则:Plannotator 可跨工具使用(不限于当前会话),用于评审计划、变更和视觉产物。使用时应持续轮询直到获得最终结果——标注、批准、错误或退出码;空响应、无输出或轮询超时都属于中间状态,不代表完成,必须继续轮询。只要存在尚未返回最终结果的活跃 Plannotator 进程,就不应结束当前回合。收到标注后,应先处理这些标注再继续周边工作,不能搁置。此外,除非用户直接要求,评审过程中不得作为评审的一部分执行 git add、git commit 或创建 PR,通用规则可参见 repo-workflow-conventions。
使用方式:在启动 Plannotator 进程或对其进行轮询时触发本技能,并同时调用对应的 plannotator/plannotator-* 子技能获得具体评审 UI 操作;随后按上述规则保持轮询、保持回合开启、处理返回的标注。
常见错误与纠正:把空的轮询响应当作“评审已完成”——应继续轮询,空不等于完成;在评审仍在运行时结束响应——应保持回合开启直到最终结果到达;收到标注后不处理就继续——应先处理每一条标注;在评审收尾时顺带提交变更——仅在用户明确要求时才提交。
适用场景:适用于使用 Plannotator 进行计划评审、代码评审或标注且进程需要长时间运行、需要轮询获取结果的开发流程。限制:资料未提供具体安装命令、代码示例、支持的平台、收费信息或效果数据,暂未提供。