用途:把某个文档页标记为“已审阅”。做法是在该 Markdown 文件的前置元数据 reviewed_by 列表中追加一条 {date, name} 记录,记录会随多位审阅人逐步累积,供主题中的 ReviewBadge 组件渲染审阅状态。
用法:/secondbrain-review <page-path> [reviewer]。page-path 是 Markdown 文件路径,例如 docs/guides/setup.md;reviewer 为可选全名,省略时读取 .claude/data/config.yaml 中 review.default_reviewer,未配置则向用户询问。前置条件:项目需有 .claude/data/config.yaml 且包含 review 段,例如 default_reviewer 与 thresholds(fresh_days 默认 30、aging_days 默认 90);缺少 review 段时应询问用户是否添加并配置默认审阅人。
流程:解析参数、读取目标文件(须存在且为 docs/ 目录下的 Markdown)、更新前置元数据、展示旧新对比并等待用户明确确认、写入、最后输出摘要(被审阅文件、审阅人、日期、审阅总数)。前置元数据格式为 reviewed_by 列表,每条含 date(YYYY-MM-DD)与 name。若已有列表则追加;若为旧格式(reviewed_by 字符串加 last_reviewed 日期)则转换为列表格式,保留原记录为首条并删除 last_reviewed;若无 reviewed_by 则新增列表,若无前置元数据则新增该块。
强制规则:条目一律使用全名,不用别名或仅名字;列表只追加,不删除既有条目;同一人同一天不重复添加。
其他信息:VitePress 主题中的 ReviewBadge 组件会自动根据 reviewed_by 列表渲染状态,多条目时显示审阅人数量;陈旧度阈值可在 config.yaml 的 review.thresholds 下配置(fresh、aging、stale 对应绿、黄、橙);旧格式为向后兼容保留;审阅标记与新鲜度系统相互独立,前者记录人工审阅质量,后者(/secondbrain-freshness)跟踪实体记录时效。除上述内容外,其余细节资料暂未提供。