SuperAPI AI 工具集

gm-emit

测试与质量

查看项目

更新于 10-15 16:49

技能介绍

用途:gm-emit 是 gm 技能链中的 EMIT 阶段,把已规划的意图落成磁盘上的实际改动。之所以单独设为一个闸口,是因为只写不校验会让智能体以为已发出的内容与磁盘实际内容之间产生静默偏差。

主要能力与流程:

  1. 预写入(Pre-Emit):写入前调试计划状态,读取将被触及的目标路径,确认当前内容与 diff 所基于的假设一致;未新读过的文件不能直接打 diff。范围大时可批量预读,少量时串行 Read 也可接受。发现不一致则回退 PLAN。
  2. 发出前同步:供 EMIT 使用的 rs-codeinsight 与 rs-search 结果必须来自刚完成的索引,缓存结果需与实时文件系统摘要匹配才可用;默认调用总是跑最新,仅当 .codeinsight.digest 完全匹配时才允许 --read-cache,不匹配则自动刷新;基于未验证或部分索引发出属于强制闭合,等同于虚报。
  3. 写入:每个产物一次 Edit 或 Write,不做多文件批量以免掩盖失败文件;载荷较大时经 in/nodejs/ 中转。
  4. 发出后校验(Post-Emit Verify):每次写入后从磁盘重读该文件,确认变更已存在,Read 工具是发出后的见证者;Write 返回成功不算见证,经过验证的磁盘状态才算。
  5. 就地修复(Fix on Sight):EMIT 期间暴露的问题(如写入时发现隐藏的导入错误、生成文件与来源不再匹配)在当轮就根因修复、重新发出并再次校验;若修复扩大范围,需先把遗留项写入 PRD 再过渡。
  6. 调度与过渡:过渡前用 phase-status 检查 FSM 状态,将重要读写留档以便审计;读取 out/<N>.json::nextSkill 并立即调用 Skill(skill="gm:<nextSkill>"),出现新的未知情况则 Skill(skill="gm:planning")。

适用场景:需要把规划结果可靠落地并防止“以为写了”与“实际写了”不一致的流程化编码或文件产出任务。

限制:资料未提供独立运行方式、安装命令、依赖环境、平台支持及性能数据;具体命令细节除上述提及项外暂未提供。