evolution-engine

将 .codex/evolution/signals.local.jsonl 或兼容旧队列中的纠偏信号整理成需要用户批准的 harness 演进提案。用于会话开始、用户反复纠正之后,或规则/技能显得陈旧、重复、缺失时。

SKILL.md

GitHub

演进引擎

把纠偏信号转化为精确提案,用于改进或退役 harness 规则。

何时使用

当 .codex/evolution/signals.local.jsonl 或兼容旧队列 .codex/evolution/signals.jsonl 中存在待处理信号、用户要求改进工作流,或重复失败表明某条规则缺失/陈旧时使用此技能。

不要直接应用变更。所有提案都需要用户批准。

必要输入

  • .codex/evolution/signals.local.jsonl(本地纠偏信号,默认是脱敏元数据)
  • .codex/evolution/signals.jsonl(兼容旧队列或脱敏样例)
  • .codex/evolution/proposals.md
  • AGENTS.md
  • Relevant .agents/skills/*/SKILL.md
  • 当信号涉及确定性门禁或 sub-agent 行为时,读取相关 .codex/hooks.json 或 .codex/agents/*.toml

原则

  • 提出能防止失败的最小规则变更。
  • 添加新规则前,优先考虑强化、合并或退役已有规则。
  • 区分通用 harness 经验和项目特定偏好。
  • 将可复用的一般行为放入 AGENTS.md 或技能;将仅属于项目的事实放入项目文档,而不是框架。
  • 规则可以双向调整:添加有用约束,也可以退役过时或重复的约束。
  • 保留用户决策权。每个提案在编辑文件前都要请求批准。
  • 如果信号中没有原始 text 字段,只能基于摘要、hash、时间和当前可见上下文提出提案;不要编造用户原话。

验收标准

演进提案满足以下条件时才可接受:

  • 引用触发提案的信号、摘要或脱敏证据。
  • 指明精确目标文件或技能。
  • 说明变更类型是 add、edit、retire 还是 new-skill。
  • 解释它能防止的失败,或能降低的规则负担。
  • 无需重新解释整段对话即可执行。

产出

按 .codex/EVOLUTION.md 定义的格式更新或起草 .codex/evolution/proposals.md 条目。

用户批准后,只应用已批准的提案,并移除已消费的信号。如果用户拒绝某个提案,除非用户要求保留,否则移除该提案及其已消费信号。