用途:在完成含多次调试迭代的开发、修复复杂bug或重构后,自动收集上下文、生成中文反思报告,并创建带报告引用的Git提交,把开发经验沉淀为仓库内可复用知识。
主要能力:执行git status、git diff、git log收集变更;分析会话历史提取错误消息、调试步骤、解决方案与迭代次数;按语法/类型/逻辑/架构/集成分类错误并评级,做根因分析、预防策略、可复用模式与反模式提炼;填充统一模板生成报告,更新索引INDEX.md,并创建含报告路径的提交。
使用方式:用户说出触发词后执行工作流。阶段1收集上下文;阶段2按模板生成报告,路径如docs/workflows/YYYY-MM/DD_reflection_[type]_[desc].md;阶段3用mkdir -p创建目录、git add .、git commit提交;阶段4更新索引。报告类型设为reflection,提交类型分feature/bugfix/refactor/docs。模板优先用项目本地docs/workflows/templates/unified-template.md,回退到全局共享模板。
适用场景:含错误消息、同一文件3次以上迭代、添加调试代码(console.log、try-catch)或用户明确请求时;用于功能开发、bug修复、重构的经验记录。
限制:仅支持中文报告;需在Git仓库环境运行;依赖会话历史完整;错误检测为启发式规则,可能误判;不适用于简单文字或格式修改、仅注释文档提交、初始化项目或加依赖、用户要求简单快速提交。简单修改无错误时会先询问是否仍生成报告。可选ToolSearch插件增强非必需。