基于DeepWiki梳理Agent应用开源项目核心流程

一句话讲透：这份提示词要 AI 以 Agent Harness 架构师的身份，把一个开源 Agent 项目的执行链路还原到”文件 / 类 / 函数”级别——它到底怎么把模型的一次思考，变成一次真正跑完的 Run。

什么时候用#

你要自己写一个 Agent 框架 / Harness，想先看清别人怎么分层的。
在几个 Agent 框架之间选型，功能表看起来都差不多，需要看真实的执行链路差异。
读了源码但找不到入口：不知道一次 Run 从哪个函数开始，上下文在哪一层组装。

提示词#

请从 Agent Harness 架构师的视角分析这个开源项目。

重点不是介绍功能，而是帮我快速看懂它"是怎么跑起来的"。

请回答：

1. 它解决什么核心问题？

2. 它的核心架构是什么？找出最关键的模块。

3. 一次 Agent Run 是怎么执行的？
   从 User → Agent → Context → LLM → Tool → Observation → Context → LLM → … → Final Response，
   根据源码还原真实执行链路，并标出关键文件 / 类 / 函数。

4. 用 Mermaid 绘制核心执行流程，重点体现 Agent Loop、Context、Tool、State、Middleware 等机制。

5. 总结 3～5 个最值得学习的设计亮点，并说明它们解决了什么问题。

请基于源码分析，不要停留在 README 层面。

和「框架流程版」的区别#

	框架流程版	本篇（Agent Harness 版）
视角	资深软件架构师	Agent Harness 架构师
输出粒度	不写类名、函数名、源码路径	必须标出关键文件 / 类 / 函数
重点	组件职责、数据流、可借鉴设计	Agent Loop、Context、Tool、State、Middleware
适合	看懂一个平台是怎么设计的	看懂一个运行时是怎么跑起来的

用的时候注意#

“不要停留在 README”这句话，光说没用。 模型拿不到源码时仍然会照 README 编。要么把仓库目录树、入口文件、一次 Run 的日志一起喂进去，要么直接用 DeepWiki 的仓库页面——它已经把代码结构索引好了，省掉一半功夫。
第 3 条最容易注水。 让它逐跳标注，并且明确要求：哪一跳这个项目没有（比如没有独立的 Observation 阶段、State 直接挂在 Context 上），就直接说”没有”。缺哪一跳，往往正好是这个框架的设计取向。
一次只问一个项目。 两个仓库一起丢进去，它会把两边的机制揉成一份”通用 Agent 架构”，看起来头头是道，实际上哪边都不对。
第 4 条要求画 Loop 的时候，让它把退出条件画出来（最大轮次、无工具调用、显式 finish）。Agent Loop 的坑几乎都在这条边上。

一个真实产出#

Phoenix 核心功能与实现流程是「框架流程版」的产出样例；如果你想看 Agent Harness 版的成品，找个 Agent 框架（OpenHands、SWE-agent、AutoGen 这类）跑一遍，重点看第 3 条的链路标注得细不细——那里最能看出这份提示词有没有生效。