先查找,再创建
生成、下载或复制资源前,先确认项目归属,再按名称、版本、内容哈希与用途查找现有候选。名称相同或字节相同都不能代替归属和许可核对。
资源库放在对应项目自己的主目录内。不同项目保持独立,不能因为主题、名称或哈希相同就共用一个跨项目池。
选择合适的使用方式
只读使用可以建立具名引用视图,让多个名称指向同一个已固定内容对象。需要修改时,生成独立可写文件;需要交付时,导出不依赖资源库的独立文件。
macOS/APFS 上的写时复制需要实际后端支持。其他存储方式以公开命令说明为准;允许普通复制会产生相应复制成本,不能保证任意平台都达到相同效果。
安装与依赖
公开仓库根目录的 SKILL.md 是 Skill 入口,按所用 Agent 的技能安装方式安装完整目录。也可以从源码运行命令行。Python 需要 3.9 或更新版本,资源库操作使用标准库。
完全重复文件的扫描与批量计划另需 fclones。脚本不会自动安装依赖;先阅读公开 README 的安装、复核计划与导出步骤。
边界与证据
原始文件保留。项目不提供自动删除、后台监听、操作系统写入拦截或跨项目自动共享。资源库和引用视图应排除在发布包、源码副本与恢复快照之外。
只读视图依赖对应资源库,不是独立备份。示例中的复制成本对比不是已经释放的磁盘空间,也不是对其他数据集保证相同节省。