📘 团队使用手册(SOP)
1️⃣ 安装方式
将 git-trace-code.yaml 放入 OpenClaw 的 skills/ 目录,重启或重载配置。
2️⃣ 标准用法(Copy-Paste Ready)
场景 A:排查某行代码的 Bug 引入点
/git-trace-code file=internal/auth/login.go target=88 branch=main
场景 B:查看某个函数的完整演进(推荐)
/git-trace-code file=internal/auth/login.go target=handleOAuth branch=release/v2.1
场景 C:仅查看时间线(用于周报/复盘)
/git-trace-code file=api/user.py target=validateInput branch=main depth=summary
🎯 为什么这是“团队级”标准?
| 特性 | 说明 | 收益 |
|---|---|---|
| 禁止 HEAD | 强制指定分支 | 避免看错环境(如把本地未提交代码当成历史) |
| Markdown 输出 | 表格 + 代码块 | 可直接粘贴到 Jira/飞书/企业微信 |
| 双模式解析 | 行号 & 函数名 | 老手新手都能用,不怕重构 |
| SOP 提示 | 底部排查建议 | 降低新人学习成本 |
| 容错机制 | 文件/路径校验 | 减少无效报错 |