用途:在实现复杂或不确定的改动时,记录与原计划的偏差及决策理由,帮助发现“心智模型(地图)”与“现实(地形)”的差异,并为文档、PR 描述和后续工作积累知识。
主要能力:跟踪架构发现、未知未知、技术约束和规格缺口等偏差类型;提供日志模板,包含上下文、原假设、现实、决策、理由、影响和代码链接等字段;实现后回顾日志、提取可复用经验,并记录“无重大偏差”而非编造条目。
使用方式:开始时创建日志文件,例如执行 echo "# Implementation Log: [Feature Name]" > .implementation-log.md 等命令初始化;实现中每当现实与计划不符就按模板追加条目;完成后回顾并提取经验,更新 ADR、MEMORY.md 或技能文档。日志可存于 .planning/.implementation-log-[current-date]-[slug].md 等工作文件,完成后沉淀到 docs/adr/、MEMORY.md、wiki/ 或 PR 描述。可将 .implementation-log.md 和 .dev-notes.md 加入 .gitignore。
适用场景:复杂或不确定的改动、实现方法尚未完全确定、需要为文档或 PR 说明记录决策、为未来工作积累未知点知识时。
限制:资料未提供该技能的安装方式、平台支持、收费或价格信息;其效果依赖持续记录与事后提取,若事后补记会丢失上下文。