P240 · 上下文管理

交接后仍能找到全部引用文件

Reference closure in the received artifact

在接收方的实际目录结构中检查引用,不只在作者仓库里检查。

编辑审核

以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。

使用场景

你把单个 Skill 目录交给另一台设备,入口引用 ../../references/checklist.md。作者的仓库有这个文件,但接收方只得到 skills/reviewer/。教学清单区分必需 checklist 与可选 examples;作者环境可读不代表交付环境可读。

具体做法

列出入口和后续必需文件引用,从每个引用所在文件的位置解析相对路径。用实际交付布局检查文件、版本和内容;依赖在包外时,选择交付完整包或把许可允许的必需资料移入包并更新引用。可选资料缺失有明确替代,必需资料缺失则报告不能完整执行。

反例

只复制上述 skills/reviewer/ 正文,保留 ../../references/checklist.md。因为作者仓库里能打开,所以告诉接收者引用已经通过检查。

改进写法

验证接收方实际得到的 Skill 包。列出必需 checklist 与可选 examples,从各引用文件所在目录解析路径并逐个打开。当前 ../../references/checklist.md 未随单 Skill 交付,应完整交付所需包结构,或在许可允许时打包 checklist 并更新引用。缺必需文件报告阻碍;缺可选例子使用说明过的替代。按交付布局复验,不引用作者电脑的通过结果。

为什么这样改

相对路径的结果取决于接收目录和随包文件。作者侧测试只能证明作者布局;接收侧遍历引用能发现单目录复制和扁平化造成的依赖缺失,让指针在真正执行的位置仍然可用。

如何验证

示意检查表应把当前 checklist 标为缺失,而不是通过;补齐包布局后再次打开它,确认路径和版本。若两个目录有同名文件,检查没有因扁平复制而覆盖。

核对每个必需引用都有接收侧结果,可选项有替代说明。文件存在但无法读取也不能算通过。

适用边界

文件可达不证明许可、语义或安全适合当前用途,不应未经授权复制私人材料。整包和单 Skill 安装有不同依赖范围,须按真实交付方式判断;本篇不执行上游安装命令。

原文与版本

如何收录这些方法