用途:eli5 是 PR Lens 的一个技能,面向完全不了解某段代码的读者,解释代码库、文件夹、功能、命令或拉取请求。它不写文章、不列文件、不做评审,而是生成一个逐步生长的画布,读者打开链接按播放即可。
主要能力:先写出一句不超过 48 字符的答案句,说明这段代码对人做了什么;再沿一条主路径画出 4 到 10 个节点、2 到 5 条泳道的图。画布从两个节点开始,每次增加 1 到 3 个新节点,最后才展示全貌,全貌里不再有新内容。泳道是读者能想象的位置,按路径顺序从左到右排列,而非文件夹树。节点标签用三个词以内说明该部分做什么,真实名称放在副标题。
使用方式:先阅读 PR Lens 手册与参考页,运行 npx @coldtea/pr-lens-cli@latest skill 和 npx @coldtea/pr-lens-cli@latest skill references。然后编写 .pr-lens/graph.json,遵循 references/graph-document.md 及本页规则,包括 provenance、视图、deltas、标题等覆盖项。校验与渲染:npx @coldtea/pr-lens-cli@latest validate .pr-lens/graph.json、npx @coldtea/pr-lens-cli@latest render .pr-lens/graph.json --theme light、npx @coldtea/pr-lens-cli@latest canvas push .pr-lens/<drawing>/drawn.graph.json。推送后得到视图链接 https://prlens.dev/c/{id},回复答案句和链接两行即可。
适用场景:向非工程读者解释一个功能、命令或整个代码库;需要按顺序逐步建立理解,而非一次性展示大图。
限制:不用于评审、文件清单、教程或架构文档;没有记录 bug、风险或意见的字段;不使用 leverages、orchestrates、pipeline 等词;每个视图最多新增 3 个节点(代码库视图例外);步数最多 9 步;最后两个视图必须不同。资料未提供收费、价格、平台支持范围等信息。