evolution-engine
将 .codex/evolution/signals.local.jsonl 或兼容旧队列中的纠偏信号整理成需要用户批准的 harness 演进提案。用于会话开始、用户反复纠正之后,或规则/技能显得陈旧、重复、缺失时。
SKILL.md.agents/skills/evolution-engine/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.mdAGENTS.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 条目。
用户批准后,只应用已批准的提案,并移除已消费的信号。如果用户拒绝某个提案,除非用户要求保留,否则移除该提案及其已消费信号。