复古

工程开发 社区

技能解读

设计思路

gstack-openclaw-retro 是 gstack 的「团队周期复盘」skill——读 git log + memory + plan history,按指定时间窗算指标、跑趋势对比、生成可发 Telegram 的叙事。最大特色是所有评价都要锚在 commit 数据——不能凭感觉夸或贬,每一句「nice work」都要点名是哪条 commit、每一句「需改进」都要给数据支撑。

输出结构

Tweetable summary(首行):

Week of Mar 1: 47 commits (3 contributors), 3.2k LOC, 38% tests, 12 PRs, peak: 10pm | Streak: 47d

然后分节:

  • Summary:关键指标
  • Trends vs Last Retro:和上次的差值(首次跑则跳过)
  • Time & Session Patterns:何时编码、session 长度、深度 vs 微会
  • Shipping Velocity:commit 类型、PR size、fix-chain 检测
  • Code Quality Signals:测试占比、热点、churn
  • Focus & Highlights:focus score、ship of the week
  • Your Week:当前用户的个人深度回顾
  • Team Breakdown:逐个队友的分析(赞 + 成长项),solo 跳过
  • Top 3 Team Wins:最高影响力的发布
  • 3 Things to Improve:具体可执行、锚 commit
  • 3 Habits for Next Week:小、实操、< 5 分钟可采用

趋势对比

有历史 retro 时算 delta:

                Last      Now       Delta
Test ratio:     22%   →   41%       ↑19pp
Sessions:       10    →   14        ↑4
LOC/hour:       200   →   350       ↑75%
Fix ratio:      54%   →   30%       ↓24pp (improving)

无历史则注「First retro recorded, run again next week to see trends.」

历史保存

存到 memory/retro-YYYY-MM-DD.json:metrics、authors、version range、streak、tweetable summary。

Compare Mode

用户说「compare」时——跑当前窗口 + 跑前一同长度窗口,并列展示 + 改进 / 回归箭头 + 关键变化的 brief。

重要规则

  • All times in local timezone——绝不设置 TZ。
  • Format for Telegram:bullet + bold,不要 markdown 表格。
  • Praise anchored in commits:「great work」必须点名好在哪儿。
  • Growth areas anchored in data:批评必有 evidence。
  • Save history:每次都存,给趋势铺路。

Status

  • DONE:retro 生成、历史已存
  • DONE_WITH_CONCERNS:生成了但缺数据(无前次 retro 可对比)
  • BLOCKED:不在 git 仓 / 时间窗内零 commit

适合谁

  • 独立开发者 / 小团队需要每周 / 每月例行复盘
  • 给团队做 sprint 总结希望靠数据说话的 Tech Lead
  • 想把工程节奏量化、留长期趋势的人

不适合

  • 还在原型阶段、commit 太稀疏——数据不够
  • 不在 git 仓库——本 skill 依赖 git log

配套

gstack-openclaw-ceo-review(前置:审 plan)、gstack-openclaw-investigate(中段:调 bug)、landing-report(事件级总结)、document-release(发布前文档体检)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@garrytan · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:收集原始数据

首先,获取来源并识别当前用户:`git config user.name`返回的名字是“你”……阅读这篇复古文章的人。所有其他作者都是队友。运行所有这些 git 命令(它们是独立的):

02
第 2 步:计算指标

计算并在摘要中呈现这些指标: 提交到 main:N 贡献者:N 合并的 PR:N 总插入数:N

03
第三步:提交时间分配

显示当地时间每小时的直方图: 识别:高峰时段 死区 双峰模式(早上/晚上)与连续模式

04
步骤 4:工作会话检测

使用连续提交之间的 45 分钟间隙阈值来检测会话。对会话进行分类: 深度会话(50 分钟以上) 中度会话(20-50 分钟) 微会话(<20 分钟,单次提交)

05
第 5 步:提交类型细分

按常规提交前缀分类(feat/fix/refactor/test/chore/docs)。显示为百分比条:如果修复率超过 50%,则进行标记...表示“快速交付,快速修复”模式,可能表明审核差距。

06
第6步:热点分析

显示更改最多的前 10 个文件。标志:文件更改了 5 次以上(流失热点)热点列表中的测试文件与生产文件版本/更改日志频率

07
第 7 步:PR 大小分布

估计 PR 尺寸并将其分类: 小号 (<100 LOC) 中号 (100-500 LOC) 大号 (500-1500 LOC) XL (1500+ LOC)

08
第 8 步:焦点得分 + 本周最佳船舶

焦点得分:涉及单个更改最多的顶级目录的提交的百分比。更高=更专注的工作。较低 = 分散的上下文切换。本周最佳船舶:窗口中最高 LOC PR 的船舶。突出显示 PR 编号、LOC 更改及其重要性。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。