commit-with-reflection

# Git提交与反思报告技能 (Commit with Reflection) 自动化Git提交并生成深度调试反思报告的技能。将AI编码过程中的错误、调试经验和解决方案转化为结构化的知识文档,保存在GitHub仓库中供长期参考和学习。 ## 何时使用此技能 (When to Use) 在以下情况下使用此技能: - 用户说:"反思提交"、"智能提交"、"生成调试报告" - 用户说:"commit with reflection"、"reflective commit" - 完成了包含多次调试迭代的功能开发 - 修复了复杂的bug并希望记录解决过程 - 重构代码时遇到并解决了架构问题 - 希望将本次开发经验转化为可复用的知识 **相关信号（用于人工判断或路由参考）**: - 检测到会话中出现了错误消息 - 对同一文件进行了3次以上的修改迭代 - Git diff显示添加了调试相关代码(console.log, try-catch等) ## 不适用场景 (Not For) 此技能不适用于: - 简单的文字修改或格式调整(无错误发生) - 仅添加注释或文档的提交 - 初始化项目或添加依赖包 - 用户明确要求"简单提交"或"快速提交" **必需输入**: - 至少有一个修改过的文件(git status显示变更) - 会话中包含开发过程的上下文(如果无错误,会询问是否仍要生成报告) ## 快速参考 (Quick Reference) ### 核心工作流 **阶段1: 上下文收集** ```bash # 获取Git状态 git status # 获取所有变更 git diff # 分析会话历史提取: # - 错误消息和堆栈跟踪 # - 调试步骤和迭代 # - 解决方案和修复 ``` **阶段2: 生成反思报告** ``` 1. 读取统一模板 - 优先使用: project-root/docs/workflows/templates/unified-template.md - 回退使用: ~/.claude/skills/shared-templates/unified-workflow-report.md 2. 分析内容: - 错误分类(语法/类型/逻辑/架构/集成) - 严重程度评级(严重/重要/次要) - 根本原因分析 - 预防策略制定 - 经验提炼和模式识别 3. 填充模板 - 报告类型设为: reflection - 重点填充: 错误分析、根本原因、经验总结章节 报告格式: docs/workflows/YYYY-MM/DD_reflection_[type]_[desc].md ``` **阶段3: 创建Git提交** ```bash # 创建报告目录 mkdir -p docs/workflows/$(date +%Y-%m) # 生成并保存报告 echo "$REPORT" > docs/workflows/... # 提交所有变更 git add . git commit -m "type: description 遇到错误: N 调试迭代: N 详见反思报告: docs/workflows/... Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>" ``` **阶段4: 更新索引** ```bash # 自动更新 docs/workflows/INDEX.md # 包含: ...