用途:该技能面向 Obsidian 笔记库中的 Trails(轨迹/项目线索),提供交互式复盘与更新流程。它会先列出可用的 Trails,供用户多选要打卡的内容,然后针对每条 Trail 走一遍结构化提问,记录进展、更新标记并反思方向。
主要能力:扫描 Trails/ 文件夹并提取 Trail 名称、状态(active/paused/completed)、最后更新日期与目标摘要;支持多选后逐条提问,涵盖自上次打卡以来的进展、要新增的里程碑标记、可标记完成的任务、需新增的任务、待更新的指标、新出现或已解决的开问题、状态变更以及下次复盘日期;随后更新每条 Trail 文件中的进展标记、指标、任务状态、开问题、last_updated 日期与下次复盘日期,并返回更新摘要。脚本还提供 list 与 show 接口,返回 JSON 供程序化使用。
使用方式:运行 /trail-checkin 启动交互式打卡;或直接调用 python3 ~/.Codex/skills/trail-checkin/scripts/trail_checkin.py。脚本 API 示例:python3 scripts/trail_checkin.py list;python3 scripts/trail_checkin.py show "Mental Health Tech"。
适用场景:每周复盘、项目里程碑时刻、在多个 Trail 之间切换上下文时、月度反思会议,以及某条 Trail 需要更新状态时。
前置条件与限制:需要满足前置条件,即位于 ~/Brains/brain 的 Obsidian 库,Trails 位于 ~/Brains/brain/Trails/,且 Trail 文件遵循 Trail - *.md 命名模式。基础目录为 ~/.Codex/skills/trail-checkin。其余如收费、平台支持范围等信息暂未提供。