文件溯源追踪

技能简介

Golden Master 用于建立和维护源文件与派生文件之间的可验证关系。通过加密校验和标记依赖关系，自动检测派生内容何时落后于源文件，帮助团队避免因文档过期导致的错误指令和用户困惑。

业务背景

文件溯源追踪解决文档版本混乱导致的决策失误问题。当技术文档、设计稿或配置模板存在多份派生副本时，系统自动标记源文件与衍生版本的关联关系，及时预警内容过期风险，确保各部门引用的是最新有效信息，减少因版本不一致引发的返工和客户投诉。

落地案例：产品团队维护一份核心API规范文档，运维和客服部门各自保存改编后的操作手册。某次接口变更后，系统检测到两份派生手册的校验和与源文件不匹配，自动推送过期预警。负责人在确认更新内容后刷新基准标记，各部门据此同步修订，避免了客户按旧文档调用报错的情况。

能做什么

• 扫描代码库，智能建议可能的源文件/派生文件配对
• 为确认的关系生成标准化元数据注释
• 批量验证所有派生文件的时效性状态
• 在手动更新后刷新校验和基准
• 定位具体变更位置，辅助内容同步

使用说明

安装要求：该技能无需额外安装，直接通过 Agent 调用即可使用。需在支持 golden-master 元数据解析的环境中运行。

第一步：分析关系
提供文件路径或目录，获取系统建议的源/派生配对及置信度评分：

{"operation": "analyze", "path": "docs/"}

第二步：建立追踪
确认关系后，生成需插入源文件和派生文件的元数据注释：

{"operation": "establish", "source": "docs/ARCHITECTURE.md", "derived": ["README.md"]}

第三步：验证时效
定期执行检查，获取过期报告：

{"operation": "validate", "path": "."}

第四步：刷新基准
手动更新派生文件后，同步最新校验和：

{"operation": "refresh", "file": "README.md"}

输入与输出

见下方输入与输出表格。

风险提示

• 仅识别关系和过期状态，不会自动修改任何文件内容
• 当前版本仅限单仓库范围，跨仓库支持待后续版本实现
• 关系发现结果需人工确认，避免误将偶然相似判定为派生关系
• 校验和比对基于文本内容，不感知语义层面的等价变换

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/leegitw/golden-master/SKILL.md
来源类型：GitHub 开源技能定义