用途:diary 技能在非平凡实现工作中主动记录工作叙事,包括新功能、缺陷修复、重构和研究性探索。它把每一步的动机、动作、结果与经验沉淀为可追溯的日记,便于复盘和审查。
主要能力:按“实现—更新日记—按需一起提交”的循环推进;每个逻辑步骤记录作者、原始提示词与理解、做了什么、为什么、成功之处、失败之处(含原始错误和命令)、学到什么、难点、需审查点及后续工作。日记文件位于项目根目录下 docs/diary/YYYY-MM-DD-<slug>.md,日期为任务开始日,一个任务一个文件,跨天步骤累积在同一文件。
使用方式:在实现代码变更后更新当前步骤;用户要求提交时,将日记文件与对应代码一起纳入提交。调用该技能本身不等于提交请求,需等待用户明确要求再执行 git commit。若 docs/diary/ 目录不存在则创建。
限制:不适用于一行修复、配置微调、代码库快速提问等琐碎变更;不得修改旧日记条目,只有当前会话创建的日记文件才可编辑,后续工作应新建文件;所有章节每步都要写,失败要立即以原始错误和命令记录;路径以项目根为基准。