用途:当页面存在原型批注或收到 /editor-todo 处理要求时,使用本技能读取本地原型批注并落实修改。术语边界:批注指 Commentary 中的改稿意见;标注指 AnnotationViewer 的说明层(如 annotation-source.json、@axhub/annotation),不在处理范围。
读取:先定位 src/prototypes/<prototype-id>/,读取 src/prototypes/<prototype-id>/.spec/prototype-comments.json。文件不存在时结合用户上下文和当前代码判断目标,不调用 CLI/API,也不依赖运行中页面。核心字段为 comments、tasks、images;comments 含 locator、comment、marker 及 text/style/tweak 的修改前后,tasks 按 elementKey 保存待处理任务,images 只记 metadata 和 images[].assetPath,图片位于 .spec/prototype-comment-assets/。有新图片素材时放入 assets 目录并引用路径,不要把 base64 写回 JSON。
处理流程:读取 JSON 理解修改意图与定位,按 assetPath 查看批注图片辅助理解,修改 src/prototypes/<prototype-id>/ 下实现文件并保持改动聚焦;完成一个任务后只清理本地批注文档,删除对应批注和任务记录,不写进度字段;按项目规则完成预览验证,无法验证时说明原因。
删除规则:以 comments[].elementKey 为主键删除已完成批注及同 key 的 tasks;删除 elementKey 匹配且不再被其他批注引用的 images 记录;对 .spec/prototype-comment-assets/ 只删除被移除 images[].assetPath 对应且不再被引用的文件。无 elementKey 时用 locator/label 人工辅助匹配,不确定则保留。
完成回复:用自然语言说明哪些批注已修改完成、是否还有未处理或异常批注、做了哪些验证,不写成 CLI 日志。限制:仅适用于采用该本地目录与文件结构的原型项目,其他情况暂未提供。