用途:为 secondbrain 项目生成新鲜度报告,帮助发现需要关注的过期条目。触发场景包括用户要求“freshness check”“freshness report”“what needs attention”“stale items”“review backlog”等。
主要能力:读取 .claude/data/config.yaml 获取启用的实体、各实体新鲜度阈值和月度分区设置;对每个实体加载记录,检查 created、date、date_updated 等日期字段,与阈值比较后按过期程度分类:Critical(2 倍阈值,需立即处理)、Stale(1 倍阈值,应审查)、Warning(0.75 倍阈值,临近过期)。报告按实体和紧急程度输出,包含汇总表、各分类明细表及推荐操作。支持摘要、完整报告(默认)和 JSON 导出三种格式。
使用方式:需先确认 secondbrain 已初始化,即存在 .claude/data/config.yaml,否则提示未找到项目。执行后按步骤加载配置、分析实体、生成报告、提供修复建议,并更新配置中的 meta.last_freshness_check 时间戳。
默认阈值:ADRs 30 天(Critical 60 天)、Tasks 14 天(28 天)、Notes 30 天(60 天)、Discussions 7 天(14 天),可按实体配置。终态条目会被跳过,如 ADRs 的 implemented、tested、rejected、canceled,Tasks 的 done、completed、canceled,Notes 和 Discussions 的 archived。
适用场景:定期(如每周或冲刺后)审查项目中的 ADR、任务、笔记和讨论,优先处理最旧条目,及时归档或更新。
限制:依赖 secondbrain 项目结构和配置文件;具体安装命令、收费与平台信息暂未提供。