用途:该技能决定 Agent 与用户如何审阅既有作者内容的修改,适用于分析、提议、审阅或修改 OpenPress MDX/TSX 内容。新建文件属于格式技能范畴,此处用于后续修订。
四种模式:Answer 用于无修改请求的分析或审阅,不改源文件;Propose 用于非平凡编辑、预览或写作判断,只做审阅交接;Apply 用于明确要求套用当前 Preview,执行经审阅的精确替换;Direct 用于明确跳过审阅或小的机械性编辑,直接改源文件。
Propose 用法:读取当前源文件、工作区指令、相关写作/格式技能及待处理的 @openpress-comment 标记,不编辑 press/ 下的作者源文件,改写 .openpress/review/current.json 为完整提议集,每条含 path、before、after、note 四字段。before 须为当前源文本中非空且唯一的精确片段,after 为完整替换文本,note 为简短理由;插入时两值都含稳定邻近文本,删除时 after 置空,并按路径与源码位置排序。每轮整体替换交接文件,不保留 id、历史、哈希或旧反馈。完成后提示用户在 Workbench 打开 Changes,在编辑源文件前停止。
反馈刷新:替换前先读当前交接,将 accept、reject、more-info 与自由文本反馈作为输入,重读当前源文件并重新考虑整套改动,再写新的提议文件。
Apply 用法:仅在明确指令后执行,例如「套用目前 Preview」或「开始修改」。读取交接与所有目标文件,如存在 reject 或 more-info 则先刷新或回答;改前校验每个 before 恰好出现一次,缺失或有歧义则不做任何更改;精确套用每处替换,不添加未审阅措辞;只移除此番改动实际满足的 @openpress-comment 标记;全部成功后再删除交接文件。绝不部分套用 Preview。
Direct:遵循所属格式技能与 OpenPress 源边界,标记相关交由 openpress-apply-comments 处理,需视觉验证或交付时走统一审阅门。编辑含语义图表引用的正文时,保留既有 fig-* 与 tbl-* 目标 ID(除非明确要求重命名),以 @fig-稳定名 与 @tbl-稳定名 引用,不得把 圖 2、表 3 等已解析标签写回源;增删改移或重命名带标题目标时,须在同一提议或直接编辑中检查并更新所有对应提及;React 图表需确认稳定 ID 到达根 <figure>,Markdown 表格需保留在紧前的 <TableCaption id="tbl-...">。改动后构建 Press 以提前发现缺失、重复、格式错误或跨类型目标问题,再在 Workbench 点击代表性跨页引用验证。
安全与边界:openpress 负责 CLI 生命周期及源文件/生成物边界,格式与写作技能负责内容判断,openpress-apply-comments 负责标记机制,绝不发布,发布交由 openpress-deploy。