用途:判断项目 lore 是否健康、是否仍有价值。仅在仓库存在 docs/lore/ 目录时有意义;若没有,应简短说明并建议使用 lore-init,而不是输出空审计。该技能为只读,不编辑、标记或删除任何内容,只生成报告并移交修复。
主要能力:执行七项检查并汇总为一份报告。①质量:按 lore-spec 边界测试判断条目是否可由代码自行推导,报告通过率。②覆盖度:对比代码库顶层领域与现有 areas,找出无 lore 的缺口,并按 README 核心标记加权。③链接健康:检查每个 code: 引用路径是否仍存在,报告断链数与比例。④时效:读取 updated: 与 status:,报告年龄分布、超过约 180 天的数量及 active/resolved/obsolete 分布。⑤可检索性:检查条目元数据是否完整可 grep,README Areas 表是否与实际文件夹一致。⑥采用情况:读取 docs/lore/.lore-feedback.jsonl,聚合每条被展示次数及 heeded/redundant/ignored 比例;日志缺失或为空时报告“暂无数据”。⑦语言:按 lore-spec 解析术语表,检查术语元数据、禁用名漂移与术语存活性,并纳入反馈日志中的采用情况。
使用方式:先阅读 ${CLAUDE_PLUGIN_ROOT}/reference/lore-spec.md,然后直接用文件工具(Read、Grep、检查路径存在)执行七项检查,无需运行脚本。报告每项单独一行,给出原始数字与绿/黄状态,不合并为单一分数,最后给出指向 lore-maintain、lore-capture 或 lore-ul 的具体下一步。交付后把当天日期以 YYYY-MM-DD 写入 docs/lore/.lore-last-check,并确保 docs/lore/.gitignore 忽略它;SessionStart 钩子据此在约 30 天后建议复查。
适用场景:显式询问 lore 健康状况或是否仍有用时,或 30 天心跳提示复查时。
限制:只读,所有修复均移交其他技能;黄色阈值是启发式的,不追求精确数字;无 docs/lore/ 目录时不做审计;反馈日志缺失属正常情况。