commit-with-reflection

1# Git提交与反思报告技能 (Commit with Reflection)
2 
3自动化Git提交并生成深度调试反思报告的技能。将AI编码过程中的错误、调试经验和解决方案转化为结构化的知识文档,保存在GitHub仓库中供长期参考和学习。
4 
5## 何时使用此技能 (When to Use)
6 
7在以下情况下使用此技能:
8 
9- 用户说:"反思提交"、"智能提交"、"生成调试报告"
10- 用户说:"commit with reflection"、"reflective commit"
11- 完成了包含多次调试迭代的功能开发
12- 修复了复杂的bug并希望记录解决过程
13- 重构代码时遇到并解决了架构问题
14- 希望将本次开发经验转化为可复用的知识
15 
16**相关信号（用于人工判断或路由参考）**:
17- 检测到会话中出现了错误消息
18- 对同一文件进行了3次以上的修改迭代
19- Git diff显示添加了调试相关代码(console.log, try-catch等)
20 
21## 不适用场景 (Not For)
22 
23此技能不适用于:
24 
25- 简单的文字修改或格式调整(无错误发生)
26- 仅添加注释或文档的提交
27- 初始化项目或添加依赖包
28- 用户明确要求"简单提交"或"快速提交"
29 
30**必需输入**:
31- 至少有一个修改过的文件(git status显示变更)
32- 会话中包含开发过程的上下文(如果无错误,会询问是否仍要生成报告)
33 
34## 快速参考 (Quick Reference)
35 
36### 核心工作流
37 
38**阶段1: 上下文收集**
39```bash
40# 获取Git状态
41git status
42 
43# 获取所有变更
44git diff
45 
46# 分析会话历史提取:
47# - 错误消息和堆栈跟踪
48# - 调试步骤和迭代
49# - 解决方案和修复
50```
51 
52**阶段2: 生成反思报告**
53```
541. 读取统一模板
55   - 优先使用: project-root/docs/workflows/templates/unified-template.md
56   - 回退使用: ~/.claude/skills/shared-templates/unified-workflow-report.md
57 
582. 分析内容:
59   - 错误分类(语法/类型/逻辑/架构/集成)
60   - 严重程度评级(严重/重要/次要)
61   - 根本原因分析
62   - 预防策略制定
63   - 经验提炼和模式识别
64 
653. 填充模板
66   - 报告类型设为: reflection
67   - 重点填充: 错误分析、根本原因、经验总结章节
68 
69报告格式:
70docs/workflows/YYYY-MM/DD_reflection_[type]_[desc].md
71```
72 
73**阶段3: 创建Git提交**
74```bash
75# 创建报告目录
76mkdir -p docs/workflows/$(date +%Y-%m)
77 
78# 生成并保存报告
79echo "$REPORT" > docs/workflows/...
80 
81# 提交所有变更
82git add .
83git commit -m "type: description
84 
85遇到错误: N
86调试迭代: N
87 
88详见反思报告: docs/workflows/...
89 
90Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
91```
92 
93**阶段4: 更新索引**
94```bash
95# 自动更新 docs/workflows/INDEX.md
96# 包含:
97…