核心用法
Golden Master 是一款文档新鲜度追踪技能，专门解决"派生文档与源文件不同步"的长期痛点。它通过四个核心操作实现闭环管理：
Analyze（分析）：扫描文件内容，基于文本重叠度和结构相似性智能推荐源文件/派生文件关系，输出带置信度的候选关系列表。
Establish（建立）：为确认的关系生成标准化的元数据注释。源文件标记 golden-master:source，记录当前校验和及所有派生文件；派生文件标记 golden-master:derived，记录源路径、校验快照及派生时间。
Validate（验证）：重新计算源文件校验和并与派生文件存储的快照比对，输出「Fresh（当前）」或「Stale（过期）」状态报告，过期项会列明具体变更内容。
Refresh（刷新）：人工同步内容后，更新派生文件的校验和快照，建立新的基准线。
校验和采用 SHA256 并执行标准化预处理（统一换行符、去除行尾空白、剔除已有元数据注释），确保跨平台一致性。
显著优点
- 确定性验证：密码学校验和消除模糊判断，过期状态客观可复现
- 低成本运行：仅扫描元数据注释，无需解析完整文档结构
- 灵活部署：支持文件内嵌注释（推荐）或独立 YAML 清单
- 精准定位变更：验证报告可展示源文件具体修改行号和内容摘要
- 零侵入设计：不强制改造文档工作流，人工始终控制内容更新
潜在局限
- 语义盲区：仅追踪内容哈希变化，不验证派生内容是否正确理解并转述了源文件
- 单仓库限制：v1.0 不支持跨仓库追踪（路线图已规划）
- 关系确认依赖人工：AI 推荐的候选关系可能出现巧合相似，需用户审核
- 元数据污染风险：注释本身成为文件内容的一部分，在特定渲染场景可能暴露
适合人群
- 维护多层级文档的技术写作者（架构文档 → README → 快速入门）
- 需要确保代码示例与源码同步的开发者
- 合规要求严格的团队（需审计追踪文档变更血缘）
常规风险
- 错误的安全感：用户可能误以为「校验和匹配」等于「内容正确」，忽视语义层面的误传
- 元数据过时：手动编辑文件时可能意外破坏注释格式，导致追踪失效
- 分支冲突：多人协作时，派生文件更新与源文件变更可能产生竞态，需配合版本控制策略使用