当你接触一个新项目,想要知道这个项目的骨架的时候,如果这个项目很多分叉,也有很多公共节点,很乱,你想知道每个流程是怎么样运行的时候,可以使用这个提示词
使用claude-code的 /artifact-diagramming 效果最好
1 项目迷宫图
帮我梳理这个项目,但不要先从源码文件开始讲。
第一步先给我画一张完整的端到端流程图,把整个项目当成一张“迷宫地图”。
我要通过这张图解决两个问题:
1. 看懂整个项目的骨架:
一个请求从哪里进入,经过哪些阶段,在哪里判断、分叉、汇合,最后如何输出。
2. 看懂每一种合同的路线:
遇到具体合同后,我能够沿着流程图一路往下走,知道这个合同会经过哪些节点。
流程图中必须明确区分:
- 【公共节点】:多个合同都会经过,例如 Router、翻译、压缩、后处理等
- 【合同专属节点】:只有某一种合同会经过的逻辑
每个流程节点都要标注:
- 节点是做什么的
- 是公共逻辑还是合同专属逻辑
- 对应哪个 `.md` / Prompt
- 对应哪个 `.py`
- 这个 md / py 在当前节点主要负责什么
这里只讲文件职责,不要逐行解释代码,也不要展开函数和变量细节。
总流程图完成后,再分别为每一种合同抽一条“合同路线”。
例如:
入口
→ 公共 Router
→ 合同 A 判断
→ 合同 A 专属处理
→ 公共压缩
→ 公共翻译
→ 最终输出
然后沿着这条路线逐节点详细解释:
- 为什么会走到这里
- 这个节点解决什么问题
- 输入是什么
- 做了什么
- 输出到哪里
- 举一个具体例子
- 对应的 md / py 文件是什么
我要达到的最终效果是:
第一次看总图,我能理解整个项目的骨架;
以后遇到任何一种具体合同,我都能像走迷宫一样,从入口沿着箭头找到它完整的执行路线,并清楚知道哪些逻辑是它独有的,哪些逻辑是整个项目公用的。
如果出现新的概念,要第一次出现时用小白能理解的话解释,不要默认我知道 Agent、Router、Pipeline、Prompt 等概念。
整体优先保证“流程感”和“地图感”,不要变成文件列表或源码逐行讲解。
(Shared from: https://promptup.net/prompt/zh-%E9%A1%B9%E7%9B%AE%E8%BF%B7%E5%AE%AB%E5%9B%BE)