用途
Provenance 技能用于追溯知识工件的谱系，将其链接回原始来源。它帮助用户了解一个工件从何而来、经历了哪些晋升阶段、在哪些会话中被讨论过，以及与其他工件有何关联。
主要能力
- 读取工件元数据：从工件文件中提取来源引用、会话 ID、日期和相关工件信息。
- 追踪来源链：通过 grep 搜索文件中的 source、session、from、extracted 等元数据，并使用 ao search 查找相关记录。
- 使用 CASS 搜索会话记录：通过 cass search 命令查找工件被创建或讨论的会话，解析返回的 JSON 结果（包含标题、源路径、创建时间、评分、代理等字段）。
- 构建谱系链：按照“会话记录（真相来源）→ Forge 提取（候选）→ 人工审核（晋升）→ 模式识别（升级）→ 技能创建（自动化）”的顺序构建完整链条。
- 生成溯源报告：输出包含当前状态（层级、创建日期、引用数）、来源链、会话引用表和相关工件的 Markdown 报告。
- 查找孤儿工件：通过 /provenance --orphans 扫描 .agents/learnings/ 和 .agents/patterns/ 目录，找出缺少 Source 或 Session 元数据的文件。
- 查找陈旧工件：通过 /provenance --stale 查找可能因来源变更而过时的工件（如超过 30 天未修改的文件）。
使用方式
基本用法为 /provenance <artifact>，其中 artifact 为工件路径。执行流程包括六个步骤：读取工件、追踪来源链、使用 CASS 搜索会话记录、构建谱系链、编写溯源报告、向用户报告结果。
查找孤儿工件：/provenance --orphans
查找陈旧工件：/provenance --stale
适用场景
- 需要审计知识工件的来源和可信度时。
- 追踪某个学习记录或模式从原始会话到当前层级的完整历史。
- 清理缺少来源追踪的未跟踪知识。
- 了解工件在哪些会话中被讨论过。
限制
- 如果工件在溯源追踪功能启用前创建，可能找不到来源元数据，需使用 CASS 回溯查找或手动添加 Source 字段。
- 如果 CASS 返回空结果，可能是会话未被索引或工件名称不匹配，需检查会话记录是否存在或尝试更宽泛的搜索词。
- 陈旧工件检查可能因 find 命令不可用或权限错误而失败。
- 如果晋升未记录在工件元数据中，谱系链可能不完整，需从 git 历史或会话记录中重建。