AEP 是一个围绕项目上下文、工作记录和验证证据的命令行工具，所有相关记录都保存在代码仓库中。它本身不决定产品意图，也不运行模型；其职责是维护记录并检查已声明的约束，具体流程由智能体根据用户请求选择。
用途 AEP 用于在使用它的项目中构建项目上下文、管理有范围的工作，并验证实际结果。智能体依据用户请求挑选相关流程和工作单，CLI 负责落地记录与约束检查。
主要能力
- 状态与环境检查：aep status 查看当前状态，aep doctor 检查配置，aep --help 及 <command> --help 获取命令与参数说明。
- 上下文构建：aep context STORY-ID 沿显式链接和被接受的相关决策构建上下文，可结合代码与运行时行为检查。需要完整结构化记录时可使用 --json。
- 流程指引：aep --skill NAME 输出完整流程，aep --skill NAME --ref REFERENCE 输出配套资源，引用名称可以是目录名或 Markdown 链接路径。这些说明直接从可执行文件或项目读取，无需模型密钥或安装插件。提供的流程包括 design、validate 等，并包含项目内发现的流程。
- 观察其他智能体：aep --skill eval 与 aep eval watch 可列出项目中工作的智能体，经用户确认目标后通过 --target <pane> 成为观察者；观察者只读项目、不向被观察智能体发送内容，且只写入机器级 AEP 主目录。
- 验证与证据留存：使用项目自身的验证流程和配置检查，将结果绑定到实际候选和环境，保留失败检查与缺失证据，遵循项目独立审查要求。导入的完成状态在被核对验证前仅作为历史上下文。
- 原生存储与迁移：原生工作写入配置的原生存储，旧文件保留为迁移来源；迁移流程用于工作流切换，并保持未解决上下文可见。
使用方式 开始前阅读 AGENTS.md、项目 README 和索引的项目规则，遵守选定工作流与用户范围。.aep/config.toml 标识原生存储、可执行检查与审查策略。常用命令包括 aep status、aep context STORY-ID、aep --skill project。端到端工作可在验证就绪后按 aep --skill deliver 的收尾指引继续；明确的仅分析、审查或候选请求保持其声明范围。产品重新聚焦、优先级或基准决策可使用 aep --skill roadmap，选定变更需要契约时继续进入 design。
适用场景 适用于采用 AEP 的项目中进行上下文构建、范围化工作管理、验证证据留存、智能体工作观察和流程迁移等工程活动。
限制 AEP 不决定产品意图、不运行模型；是否实施、审查、集成或发布由用户授权决定。原生存储、检查与审查策略的具体内容以项目配置为准。部分流程与资源细节暂未提供。