name	extract-learnings
description	从近期开发会话中萃取可复用的模式 / 决策 / 教训。当用户提到提取教训 / 复盘 / lessons learned / 知识沉淀 / 经验萃取 / 提炼模式时使用。会扫 .context/ 决策日志 + git log 提交语义。
license	MIT
user-invocable	true
disable-model-invocation	false
allowed-tools	Read, Bash, Grep, Glob, Write
argument-hint	[--since=30d]

📚 复盘关卡 · 经验萃取

从最近的开发活动中萃取可复用知识，写入 .context/learnings/<日期>-extract.md，避免反复踩同坑。

使用方法

/ccg:extract-learnings              # 默认萃取最近 30 天
/ccg:extract-learnings --since=14d  # 自定义时间窗口

工作流程

Step 1：收集原料

# 决策日志
ls .context/sessions/ 2>/dev/null
# git 提交（含 commit message）
git log --since='30.days.ago' --pretty='%h %s' --no-merges
# 已归档的 phase 报告
ls .claude/team-plan/*-report.md 2>/dev/null

Step 2：分类萃取

按以下五个桶过滤：

模式（Pattern） — 反复出现的好做法（"phase 都用 fresh-context subagent 隔离"）
反模式（Anti-pattern） — 反复犯的错（"沙箱里跑 git commit 总被拒"）
决策记录（ADR-like） — 重要架构决定 + 为什么这么决定
工具陷阱（Tooling pitfall） — 工具实际行为 != 文档（"Claude Code subagent 不能嵌套 spawn"）
痛点 / 改进点（Pain point） — 还没解决的待办 / 流程瓶颈

Step 3：写报告

# Learnings Extract — <日期范围>

**会话数**: N · **commits**: M · **完成 phase**: K

## 模式（建议固化）
1. ...

## 反模式（建议警告）
1. ...

## 决策记录
- **D1: 用 SessionStart hook 注入 roadmap** — 原因：主线零项目记忆痛点

## 工具陷阱
- **subagent 不能 spawn 子 agent**（commit a7cdffd 实测）

## 痛点
- ...

Step 4：（可选）建议 PR

每条"模式"标记 → promote to rules?，让用户决定是否上升为 ~/.claude/rules/*.md。

输出契约

主输出：.context/learnings/<YYYY-MM-DD>-extract.md
终端：每桶 1-3 条精选摘要

Más de este repositorio

mismo repositorio

ccg-skills

wzyxdwll/ccgx-workflow

CCG Skills - Quality gates, documentation generator, and multi-agent orchestration. Auto-installed by CCG workflow system.

2026-06-1214

verify-change

wzyxdwll/ccgx-workflow

变更校验关卡。分析代码变更，检测文档同步状态，评估变更影响范围。当用户提到变更检查、文档同步、代码审查、提交前检查、diff分析时使用。在设计级变更、重构完成时自动触发。

2026-06-1214

verify-module

wzyxdwll/ccgx-workflow

模块完整性校验关卡。扫描目录结构、检测缺失文档、验证代码与文档同步。当用户提到模块校验、文档检查、结构完整性、README检查、DESIGN检查时使用。在新建模块完成时自动触发。

2026-06-1214

verify-quality

wzyxdwll/ccgx-workflow

代码质量校验关卡。检测复杂度、重复代码、命名规范、函数长度等质量指标。当用户提到代码质量、复杂度检查、代码异味、重构建议、lint检查、代码规范时使用。在复杂模块、重构完成时自动触发。

2026-06-1214

verify-security

wzyxdwll/ccgx-workflow

安全校验关卡。自动扫描代码安全漏洞，检测危险模式，确保安全决策有文档记录。当用户提到安全扫描、漏洞检测、安全审计、代码安全、OWASP、注入检测、敏感信息泄露时使用。在新建模块、安全相关变更、攻防任务、重构完成时自动触发。

2026-06-1214

forensics

wzyxdwll/ccgx-workflow

代码事件取证 / 提交考古。给定一个文件 / 函数 / bug 现场，反向溯源 git 历史 + 关联 PR / issue / 改动者，重建事故 timeline。当用户提到 git blame / 谁改的 / 为什么这样写 / 提交考古 / 代码取证 / forensics 时使用。

2026-05-1014

📚 复盘关卡 · 经验萃取

从最近的开发活动中萃取可复用知识，写入 .context/learnings/<日期>-extract.md，避免反复踩同坑。

使用方法

/ccg:extract-learnings # 默认萃取最近 30 天 /ccg:extract-learnings --since=14d # 自定义时间窗口

工作流程

Step 1：收集原料

# 决策日志 ls .context/sessions/ 2>/dev/null # git 提交（含 commit message） git log --since='30.days.ago' --pretty='%h %s' --no-merges # 已归档的 phase 报告 ls .claude/team-plan/*-report.md 2>/dev/null

Step 2：分类萃取

按以下五个桶过滤：

模式（Pattern） — 反复出现的好做法（"phase 都用 fresh-context subagent 隔离"）

反模式（Anti-pattern） — 反复犯的错（"沙箱里跑 git commit 总被拒"）

决策记录（ADR-like） — 重要架构决定 + 为什么这么决定

工具陷阱（Tooling pitfall） — 工具实际行为 != 文档（"Claude Code subagent 不能嵌套 spawn"）

痛点 / 改进点（Pain point） — 还没解决的待办 / 流程瓶颈

Step 3：写报告

# Learnings Extract — <日期范围> **会话数**: N · **commits**: M · **完成 phase**: K ## 模式（建议固化） 1. ... ## 反模式（建议警告） 1. ... ## 决策记录 - **D1: 用 SessionStart hook 注入 roadmap** — 原因：主线零项目记忆痛点 ## 工具陷阱 - **subagent 不能 spawn 子 agent**（commit a7cdffd 实测） ## 痛点 - ...

Step 4：（可选）建议 PR

每条"模式"标记 → promote to rules?，让用户决定是否上升为 ~/.claude/rules/*.md。

输出契约

主输出：.context/learnings/<YYYY-MM-DD>-extract.md

终端：每桶 1-3 条精选摘要