用途:把已批准的改进候选应用到单个目标文件,支持变更前自动备份与后续回滚;也可在真正执行前预览效果。属于 orchestrator pipeline 第 4 阶段,输入是 discriminator 产出的 ranking 格式。
主要能力:支持 4 种 action——append_markdown_section(在文件末尾追加新 section)、replace_markdown_section(按 heading 精确匹配重写已有 section)、insert_before_section(在指定 heading 前插入内容)、update_yaml_frontmatter(对 YAML frontmatter 做深层合并,保留已有键)。每次 apply 都会创建原始文件的完整副本并产出 receipt,包含原始内容哈希、备份绝对路径和时间戳,用于精确回滚。
使用方式:核心入口为 execute.py,接收 ranking artifact 与 candidate ID,输出 result.json;rollback.py 接收 receipt.json 还原变更前状态,两个命令均支持 --dry-run 预览。示例:python3 scripts/execute.py --input ranking.json --candidate-id CANDIDATE_ID --output result.json;python3 scripts/rollback.py --receipt receipt.json;python3 scripts/rollback.py --receipt receipt.json --dry-run。对 replace、update_yaml 等高风险变更建议先跑 --dry-run。回滚前会校验备份文件的 SHA256 哈希,防止备份被篡改;不要手动编辑 receipt.json,否则会导致回滚失败。
适用场景:批量执行 ranking 中多个候选的变更、对 YAML frontmatter 做字段级合并、在指定 heading 前插入新内容,以及需要验证变更可逆性的场合。
限制:executor 只执行变更,不做质量判断(打分用 improvement-discriminator),不做门禁验证(用 improvement-gate),不负责全流程编排(用 improvement-orchestrator),也不评估 skill 结构(用 improvement-learner)。候选未通过评分时不应直接调用。它只处理单文件内容修改,不用于批量重命名或目录结构变更。没有 ranking.json 时不可调用。因可能在无 git 仓库的环境运行,故用文件备份而非提交;每次 apply 会完整复制原文件,以磁盘空间换取安全性。