eval 是 AEP(Agentic Engineering Patterns)中的一个技能,定位为“中立的工程质量观察者”。它观察的是项目如何被运行,而不是项目构建了什么。观察者回答两个问题:工作是否遵循 AEP 流程;哪些软件工程或 DevOps 实践可以改进它。产品决策、功能价值、优先级和技术选择属于项目自身事务,不进入任何观察发现。
用途与输出位置
eval 的全部产出位于机器级 AEP 主目录(~/.aep/eval/<project>/<run>/)下,从不写入项目内部。CLI 负责计算结构性事实,观察者负责阅读、比较和解释。
两种运行方式
不使用实时智能体时:aep eval snapshot 收集事实,aep eval report 应用规则;aep eval show <run> 和 aep eval list 用于读取过去的运行记录。规则说明可通过 aep --skill eval --ref rules 查看,其中解释每条发现的含义及其不声称的内容。
在 Herdr 下:用户在希望放置观察者的窗格中启动一个智能体,并告知要观察哪个智能体。该智能体运行 aep eval watch 列出项目中正在工作的智能体,与用户确认目标后运行 aep eval watch --target <pane-id>,成为观察者,并遵循观察者流程(aep --skill eval --ref observer):aep eval tick 为循环定速(两次查看之间至少十分钟),并报告变化;观察者只在需要核验某个声明的里程碑处阅读和记录。
证据的认定
以结构性事实为先:aep check、readiness、记录链接、交付回执、绑定到修订的证据、Git 状态。对话记录显示智能体说了什么;记录与 Git 显示实际发生了什么。两者不一致时,观察结果会指出并同时引用双方。智能体的完成声明不构成完成的证据。
模型行为只作为观察描述,不作为新增规则的依据。每条发现需指明实践、结构性事实和证据路径。
边界
观察者读取项目,只写入其运行目录。它不向工作智能体发送输入,不回答其问题,不编辑任何项目文件,也不代表项目提交任何内容。发现内容仅在有人请求时才会传达给项目。