SuperAPI AI 工具集

lode-session-recap

通用与其它

查看项目

更新于 10-16 06:22

技能介绍

用途:在开发者结束一次工作会话时,读取本次对话历史,提取并生成结构化变更条目,用于周报。它强调记录 git 提交难以传达的“为什么”——意图、探索路径与推理。

主要能力:按顺序提取决策背景、探索路径、实际变更、影响与开放问题;优先记录已交付或明显推进的能力、技术决策与取舍、风险与阻塞、跨模块契约变更等;将相关工作合并为逻辑单元,最多 5 条,默认 1-3 条。条目字段包括 timestamp、type(feature/fix/refactor/decision/risk)、summary、context、related_docs、source、status、impact,以及可选的 motivation、exploration_paths、abandoned_alternatives、open_questions、sync_suggestions。

使用方式:零配置模式下,直接在对话中输出结构化 Markdown,不写文件;配置知识库后,条目写入 {vault}/raw/weeks/{ISO-week}/{project-slug}.json。配置解析优先级为项目根 .lode/config.yaml、~/.lode/config.yaml、$WEEKLY_PPT_PATH、~/.weekly-ppt/。可用 python <this-skill>/scripts/lode_raw.py resolve-config --cwd "$PWD" 检查配置,用 append-entry 写入。

适用场景:开发者收工、结束一天工作、需要为周报整理变更记录时。

限制:不记录文件移动、格式、注释、导入整理等琐碎变更;不编造未发生的内容;不主动请求确认;不拆分相关工作;不将价值门槛设在配置之后。具体脚本路径与完整规范以技能内 references/weekly-ppt-convention.md 为准。