cursor-diary

Cursor Diary 技能专为重视开发流程中可重现性与结构化文件的软件工程师而设计。通过维护细腻的实作日志，它能确保开发过程中的每个环节（包含意图、执行指令、错误输出与设计决策）皆被系统化记录。此工具作为个人知识库，连接了原始程式码变更与长期专案文件之间的断层。

• 自动将实作步骤链接至 docmgr 工单与工作空间，以进行统一的专案追踪。

• 完整撷取错误日志与失败过程，有助于后续侦错与根本原因分析。

• 鼓励小步提交（tiny-step commits），确保每一项变更皆独立且具备对应的提交杂凑值（commit hash）。

• 提供捕捉高价值资讯的模板，例如处理技术瓶颈的心得与适合进行程式码审查（code review）的观察点。

• 支援双向追踪，利用绝对档案路径将特定的原始程式码档案链接至日记条目。

• 透过自动化记录工单工作流，简化变更日志（changelog）的维护作业。

• 使用者应在开发会话或任务开始时启动日记，以确保涵盖完整的上下文资讯。

• 输入内容应包含任务意图、执行的命令、遭遇的错误及建构过程中的洞察。

• 工具依赖于 docmgr 工作空间，并建议使用者遵循约定的目录结构（通常位于 ttmp/ 目录下）。

• 最佳实践是将日记更新与程式码变更分开提交，以保持 Git 历史记录的整洁。

• 限制方面，需要持续使用 docmgr CLI 进行元资料（metadata）管理与档案关联。

• 输出结果经最佳化，适用于开发者自我回顾，或提供足够的背景资讯供他人进行程式码审查，确保所有技术工件与决策理由与程式码库保持一致。