交接后仍能找到全部引用文件
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 安装有不同依赖范围,须按真实交付方式判断;本篇不执行上游安装命令。
原文与版本
- addyosmani/agent-skills · Reference closure in the received artifact
查看此版本的文件9d0c60d406b4 - affaan-m/ECC · Manual installation: tree and ECC-owned namespace
查看此版本的文件ef648e01899b - affaan-m/ECC · Preserve package-relative resources across installation cache relocation
查看此版本的文件ef648e01899b