Audit Evolution

Automates agent self-audit by gathering evidence, summarizing runs, proposing minimal patches, and requesting human approval for safe incremental evolution.

让 Agent 每跑一轮，都变得更聪明。

当用户说“开始调用 Audit Evolution”、Agent 完成任务、跑完 benchmark、写完 worklog、超时、漂移、失败，或收到用户反馈时，使用这个 skill。

目标不是写更多日志，而是把一次运行变成下一轮可复用的能力提升。

一句话入口

用户不需要先整理材料。只要用户说：

开始调用 Audit Evolution

Agent 就先在当前上下文和允许访问的文件里寻找证据，再生成审计结果和进化建议。
不要要求用户先手动粘贴 benchmark、worklog、失败日志或 handoff，除非当前上下文和允许文件里确实找不到证据。

和普通 Memory Skill 的区别

Audit Evolution 不替代长期记忆库，也不要求引入数据库。它只在每次审计后沉淀少量高价值记忆：

verified_fact
user_feedback
decision
skill_patch
retrieval_key
next_run_bootstrap

普通 memory 常见问题是“什么都记，最后更乱”。Audit Evolution 的记忆原则是：

少记、准记、带证据、可过期、能触发下一轮行动。

如果项目已有 worklog、handoff、dashboard、员工/角色分工、Obsidian、Markdown vault 或其他记忆系统，Audit Evolution 应该把结果写成兼容的 Memory Ledger Entry，而不是另起一套重型系统。

三阶段工作流

start_audit -> propose_evolution -> ask_human_approval

1. start_audit

先找证据，不修改系统。

优先从这些位置寻找：

current_conversation
recent_user_feedback
recent_task_output
benchmark_report_or_receipt
worklog_or_field_note
failure_timeout_retry_log
handoff_or_snapshot
recent_skill_config_gear_change

如果可以读文件，最多读取 5 个最相关文件。读满 5 个仍不清楚就停止，不要继续追引用链。

2. propose_evolution

基于证据输出：

Evidence Pack
Snapshot
Evolution Card
Memory Ledger Entry
Minimal Skill Patch Proposal
Field Note
Next-Run Bootstrap

这里的 patch 只是提案，不得直接应用。

3. ask_human_approval

最后必须问人类：

是否批准开始进化？
可选项：
1. 只保存审计结果
2. 应用最小补丁并本地测试
3. 暂停，等待更多证据

在得到人类批准前，不得修改 skill、config、gear，不得执行外部动作。

短指令路由表

用户不需要学习完整协议。每轮输出最后，Agent 必须给人类一个可直接回复的短指令菜单。

你可以直接回复：
进化 / 保存 / 暂停 / 跑分 / 继续 / 详情

当用户回复短指令时，按下面规则路由：

开始:
  action: start_audit
  meaning: 自动寻找证据并生成审计结果，不修改系统。

进化:
  if no_evidence_pack:
    action: start_audit
  else if patch_proposal_exists and not_applied:
    action: ask_or_apply_local_patch
  else if patch_applied and missing_external_evidence:
    action: ask_or_run_one_approved_test
  else if benchmark_or_test_result_exists:
    action: propose_next_evolution
  else:
    action: ask_one_clarifying_question

保存:
  action: save_audit_only
  meaning: 只保存 Evidence Pack / Snapshot / Evolution Card / Field Note，不修改。

暂停:
  action: write_handoff_and_stop
  meaning: 写清当前状态、缺失证据、下一步建议，然后停止。

跑分:
  if official_benchmark_already_approved:
    action: run_exactly_one_benchmark
  else:
    action: ask_human_approval_for_one_benchmark

继续:
  action: next_small_safe_action
  meaning: 只执行当前审计结果里的 next_small_action。

详情:
  action: explain_evidence_and_decision
  meaning: 展开证据、推理依据、风险边界。

短指令不等于无限授权。publish/upload/install/vote/comment/message/spend/official benchmark 仍然需要明确授权。
如果用户只回复“进化”，Agent 可以应用本地补丁和本地测试；如果下一步需要 official benchmark，必须说明原因并请求“一次 benchmark”授权，除非用户已经明确批准。

每轮结尾格式

每次使用 Audit Evolution 后，最后都必须输出：

建议下一步:
<一句话说明>

你可以直接回复:
- 进化: <当前状态下会做什么>
- 保存: 只保存审计结果
- 暂停: 写 handoff 并停止
- 跑分: <如果需要外部 benchmark，说明是否还需授权>
- 详情: 展开证据和判断

自动触发规则

不要只等用户手动说 Use Audit Evolution。当出现以下任一事件时，Agent 必须主动调用 Audit Evolution：

benchmark_completed
user_corrected_agent
task_failed_or_timeout_or_retry
context_over_60_percent
more_than_5_files_read
uncertainty_language_detected
skill_config_or_gear_changed

对应的人类可读触发条件：

1. benchmark 完成。
2. 用户指出错误、纠正事实、质疑结论。
3. 任务失败、超时、重试、被阻塞。
4. 上下文超过 60%。
5. 本轮读取文件超过 5 个。
6. 输出里出现“大概、可能、我理解为、不确定”等不可靠表达。
7. 新增或修改 skill、config、gear、路由、答题范式后。

如果当前环境支持 hook / wrapper / runtime guard，把这些事件接到任务结束、上下文检查、外部动作前检查、skill 修改后的检查点。
如果当前环境不支持自动 hook，Agent 也必须在这些事件后主动生成一次 run record，再调用本 skill。

自动进化闭环

event -> evidence_search -> Evidence Pack -> Snapshot -> Evolution Card -> Memory Ledger Entry -> Patch Proposal -> Human Approval -> Local Test -> Field Note -> Next-Run Bootstrap

自动化边界：

• 可以自动寻找证据、保存 run record、生成 evolution card、生成 memory ledger entry、提出 minimal patch、写 field note。
• 只有人类批准后，才可以应用本地补丁、跑本地 dry-run、写 receipt。
• 不可以自动 publish、upload、install、vote、comment、message、spend、official benchmark。
• 外部动作只能输出 human_approval_required。

没有现成 run record 时，先写一个最小记录：

event_type:
current_goal:
what_happened:
evidence_kept:
evidence_missing:
files_read:
context_pressure:
user_feedback:
next_small_action:

输入

优先自动寻找输入。也可以由用户粘贴任意一种：

benchmark_report
worklog
task_output
failure_log
handoff_note
user_feedback

必须输出

始终输出七段：

Evidence Pack
Snapshot
Evolution Card
Memory Ledger Entry
Minimal Skill Patch Proposal
Field Note
Next-Run Bootstrap

最后追加一句批准问题：

是否批准开始进化？

并追加短指令菜单：

你可以直接回复：进化 / 保存 / 暂停 / 跑分 / 详情

Evidence Pack

evidence_found:
evidence_missing:
files_or_context_checked:
authority_order:
privacy_notes:
audit_confidence:

Memory Ledger Entry

每次审计后，只记录值得下一轮复用的内容。默认先输出候选条目，不自动落盘；只有在人类回复“保存”或“进化”并允许本地写入时，才把它写进现有 worklog、handoff、dashboard、Obsidian vault 或项目自己的记忆文件。

memory_type: verified_fact | user_feedback | decision | skill_patch | retrieval_key | next_run_bootstrap
source_evidence:
confidence: high | medium | low
expiry: never | date | condition
retrieval_key:
owner_or_role:
write_target:
content:

写入规则：

• verified_fact: 必须有证据来源。
• user_feedback: 标记为用户偏好或纠错，不当作客观事实。
• decision: 记录人类批准、拒绝、暂停或授权边界。
• skill_patch: 只记录已批准或候选补丁，不混淆状态。
• retrieval_key: 用短键帮助下一轮优先找对文件或记录。
• next_run_bootstrap: 下一轮启动时最短 3-5 条指令。
• write_target: 如果不知道写到哪里，填 proposed_only，不要猜路径。

不要记录：

raw_secret
private_customer_data
unverified_guess
dirty_log_without_summary
entire_conversation_dump

推荐最小示例：

memory_type: skill_patch
source_evidence: "latest benchmark receipt + local dry-run receipt"
confidence: medium
expiry: "next benchmark or when contradicted"
retrieval_key: "act_direct_execution"
owner_or_role: "agent"
write_target: "proposed_only"
content: "Act 类任务优先输出：目标/边界 -> 最小工具链 -> action map -> idempotency -> evidence receipt -> stop condition。"

Snapshot

current_goal:
trusted_state:
uncertain_state:
files_read:
next_small_action:
stop_condition:
verification_plan:

Evolution Card

score_delta:
  previous:
  current:
  gain:
weak_dimension:
  - perceive | reason | act | memory | guard | autonomy
trusted_evidence:
stale_or_uncertain_claims:
minimal_patch:
promotion_gate:
  - dry_run
  - payload_audit
  - receipt
  - next_test

Minimal Skill Patch Proposal

只推荐一个最小补丁。

推荐补丁类型：

answer_pattern
field_schema
guardrail
verification_step
retrieval_key
context_stop_rule
handoff_brief

避免：

install_many_skills
rewrite_the_system
read_all_logs
trust_stale_state
claim_completed_without_evidence

Field Note

input_summary:
what_changed:
evidence_kept:
evidence_discarded:
next_test:
shareable_claim:

Next-Run Bootstrap

read_first:
do_first:
avoid:
verify:
stop_if:

Trust Ledger

每个重要 claim 都要分类：

verified_fact: 当前已验证，或有可复查证据支持
user_feedback: 用户偏好、纠错或反馈
stale_claim: 旧 claim，需要重新验证
model_inference: 模型推断，不是证据
unknown: 当前不知道

Stop Rules

遇到这些情况，停止扩展并写 snapshot：

more_than_5_files_needed
context_pressure_over_70_percent
score_authority_conflict
external_action_required
no_evidence_for_completed_claim

Public-Safe Rules

• 不暴露 API keys、credentials、cookies、私有路径、原始客户数据。
• 写 field note 前先脱敏。
• publish、upload、install、vote、comment、message、spend、official benchmark 等外部动作，必须有人类明确批准。
• 无法验证的 claim 必须标为 unknown 或 stale_claim。

30 秒提示词

开始调用 Audit Evolution。

请先从当前上下文和允许访问的文件里自动寻找最近的任务记录、用户反馈、失败/超时/重试记录、benchmark 或评测结果、worklog、handoff、receipt、最近修改过的 skill/config/gear。

Return:
1. Evidence Pack
2. Snapshot
3. Evolution Card
4. Memory Ledger Entry
5. Minimal Skill Patch Proposal
6. Field Note
7. Next-Run Bootstrap
8. Short Command Menu

Rules:
- 区分 verified_fact、user_feedback、stale_claim、model_inference、unknown。
- 最多读取 5 个最相关文件。
- 只推荐一个 next patch proposal。
- 没有 evidence 不许声明 completed。
- 外部动作标记为 human_approval_required。
- 未经批准不得修改 skill/config/gear。