关于 prepare-branch-context
用于了解当前 Git 分支的只读技能,帮助后续处理相关工作。它检查分支差异和提交记录、查找关联 PR,并总结改动及评审情况。
主要功能
- 01识别分支和合并基点
- 02查看与 main 的差异
- 03检查分支提交历史
- 04查找关联拉取请求
- 05总结改动和评审背景
适用场景
- 01修改前了解现有分支
- 02为拉取请求的后续工作做准备
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jnsahaj/ skills --skill prepare-branch-context安装后在 Claude Code 中输入/prepare-branch-context确认已加载。
详细介绍
准备分支上下文
全面了解当前分支,以便在掌握完整上下文的情况下处理后续请求。
步骤
-
识别当前分支和基准分支:
git branch --show-current git merge-base HEAD main -
获取与 main 的差异:
git diff main...HEAD --stat git diff main...HEAD仔细阅读完整差异。了解哪些文件被修改、添加或删除,以及这些更改的作用。
-
查看此分支的提交历史:
git log main..HEAD --oneline阅读提交消息,了解更改的演进过程。
-
检查是否有相关 PR:
gh pr list --head "$(git branch --show-current)" --json number,title,body,url,state,comments --jq '.[0]'如果存在 PR,请阅读其标题、描述和评论,获取更多上下文(验收标准、讨论、审查反馈)。
-
向用户总结你的理解:
- 此分支的作用(高层目标)
- 受影响的关键文件和代码库区域
- 更改中体现出的重要决策或模式
- PR 中尚未解决的审查评论或讨论
- 当前状态(干净、有未提交的更改等)
-
说明已准备就绪:告知用户,你已准备好回答与此分支相关的后续问题或处理相关任务。
规则
- 不要对文件进行任何更改。此技能为只读。
- 阅读差异的实际内容,而不只是统计摘要。你需要理解代码更改。
- 如果没有 PR,也没关系——跳过该步骤并说明即可。
- 如果差异非常大,先了解整体结构,再详细阅读关键文件。
- 总结应简洁,但需足够全面,以便你能自信地对该分支进行更改。
- 如果当前分支是
main,或与 main 没有差异,请告知用户无需分析。
评论
支持 Markdown