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: 上下文收集

# 获取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提交

# 创建报告目录
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: 更新索引

# 自动更新 docs/workflows/INDEX.md
# 包含:
# - 按日期/类型/错误类型分类
# - 统计信息
# - 搜索标签

报告模板结构

# 开发反思报告

**日期**: 2026-02-15 14:30:00
**提交类型**: feature | bugfix | refactor | docs
**会话时长**: 45 分钟
**修改文件数**: 5 个文件

## 1. 概述
简要描述本次修改的内容和目的

## 2. 修改内容
### 修改的文件
- `client/src/components/Feature.tsx` - 实现新功能
- `server/routers.ts` - 添加API端点

### 主要变更
- 添加了用户认证功能
- 修复了CORS跨域问题