claude-reflect

用途

claude-reflect 用于对 workspace-hub 工作区中的所有子模块进行周期性跨仓库反思。它分析近 30 天的 git 历史，提取反复出现的开发模式，并据此自动增强或创建技能。该技能适合在规划新功能前识别可复用模式，或在重大发布后捕获经验教训。

主要能力

跨仓库分析：枚举并分析全部 26 个以上 workspace-hub 子模块的 git 活动。
RAGS 循环：依次执行 REFLECT（收集 git 历史）、ABSTRACT（识别模式）、GENERALIZE（确定适用范围）、STORE（持久化并采取行动）。
模式类型：代码模式、工作流模式、提交模式、修正模式、工具模式。
模式检测启发式：频率（出现在 3 个以上提交中）、一致性（多位作者使用同一模式）、传播范围（跨多个仓库出现）。
评分与行动：按频率、跨仓库影响、复杂度、时间节省加权计算得分；得分 >= 0.8 自动创建新技能，0.6–0.79 增强现有技能，< 0.6 记录备查。
状态管理：通过 ~/.claude/state/reflect-state.yaml 记录运行历史、分析窗口、仓库数量、提取模式数及采取的行动。
自动化执行：cron 每日 5:00 运行完整 RAGS 循环，周日生成周报。

使用方式

手动运行：

# 运行完整 RAGS 循环
/reflect

# 快速 7 天反思
/reflect --days 7

# 预览模式而不创建技能
DRY_RUN=true /reflect

# 强制生成周报
WEEKLY_REPORT=true /reflect

其他命令：

/reflect --days 90：扩展季度反思
/reflect --repo <name>：单仓库反思
/reflect --dry-run：预览模式而不创建技能

前置条件：

对所有 workspace-hub 子模块的 git 访问权限
~/.claude/state/ 目录用于状态持久化
~/.claude/memory/ 目录用于全局模式

适用场景

每周快速回顾：/reflect --days 7
每月深度反思：默认 30 天分析
每季度战略回顾：/reflect --days 90
在规划新功能前识别可复用模式
在重大发布后捕获经验教训

限制

需要 git 访问所有子模块；若子模块访问异常，需运行 git submodule status 检查并 git submodule update --init --recursive 更新。
若窗口内无提交，反思会以警告完成，建议使用 --days 90 扩大窗口。
模式评分可能因证据提交数、跨仓库检测或模式分类问题而不准确，需人工复核。
建议始终先用 --dry-run 预览模式，再创建技能。
创建技能后需验证其可编译/可运行，并添加来自实际提交的示例、链接到源证据。

与其他技能的区别

技能	触发方式	范围	数据源
skill-learner	提交后	单仓库	最后一次提交
claude-reflection	自动/会话	用户交互	对话
claude-reflect	手动/计划	全部 26 个仓库	30 天 git 历史

脚本架构

该技能使用模块化脚本管道：

daily-reflect.sh（编排器） ├── analyze-history.sh # REFLECT：提取 git 提交 ├── extract-patterns.sh # ABSTRACT：识别模式 ├── analyze-trends.sh # GENERALIZE：跨日趋势 ├── create-skills.sh # STORE：自动创建技能 └── generate-report.sh # 周报摘要

输出位置：

~/.claude/state/reflect-state.yaml：当前状态
~/.claude/state/reflect-history/：原始分析文件
~/.claude/state/patterns/：提取的模式
~/.claude/state/trends/：趋势分析
~/.claude/state/reports/：周报摘要
~/.claude/memory/patterns/learnings.yaml：低分模式备查
.claude/skills/workspace-hub/auto-generated/：自动创建的技能

版本历史

2.0.0（2026-01-21）：完整 RAGS 循环实现，新增模式提取引擎、跨日趋势分析、可操作报告生成器、自动技能创建模块，更新 daily-reflect.sh 编排所有阶段，周日自动生成周报。
1.0.0（2026-01-21）：初始版本，包含基本 RAGS 规范。