
一、开发者的痛点,被一个隐藏功能彻底解决
每一个开发者,都有一个被重复工作磨疯的瞬间。写代码、测功能、改bug已经够累,可每次完成一个功能、准备提交PR时,还要反复跟Claude解释“怎么写PR描述”——要符合规范格式、要总结变更、要列测试步骤、要加检查清单,翻来覆去的话术,一天重复好几次,既浪费时间又磨心态。
直到有开发者发现了Claude Code的隐藏技能,只用一个指令,就能让Claude自动生成完美PR描述,彻底告别重复解释的内耗。这看似是一个小小的技巧,却戳中了无数开发者的痛点,但很多人不知道,这个技能不仅能省时间,用错了反而会增加额外负担。为什么同样是用Claude技能,有人效率翻倍,有人却越用越乱?这个能解放双手的功能,到底该怎么用才不踩坑?
关键技术补充:Claude Code技能是什么?
Claude Code是Anthropic公司推出的AI代码辅助工具,核心功能是帮助开发者处理代码相关任务,包括写PR描述、代码审查、生成提交信息等,完全免费开源,无需付费即可使用。目前其相关技能功能在开发者社区广泛传播,GitHub上相关教程及工具星标累计超10万,是前端、后端开发者都在追捧的效率神器。
它与普通Claude的区别在于,支持自定义“技能”——简单说就是提前设置好任务模板,需要时输入指令,AI就能按照预设规则完成任务,不用再反复解释需求,这也是它能解决PR描述重复问题的核心原因。
二、核心拆解:手把手教你搭建PR描述自动生成技能
Claude Code的技能功能,本质上就是一个简单的文件夹+markdown文件,不用复杂编程,新手也能10分钟上手。下面就把开发者实测有效的PR描述技能搭建步骤,一步步拆解清楚,跟着做就能直接用。
第一步:明确核心逻辑,分清两个关键文件
很多开发者一开始用不好技能,是因为混淆了两个核心文件——CLAUDE.md和技能文件,两者功能完全不同,用对了才能不浪费AI上下文。
CLAUDE.md:放在项目根目录,用于提供项目的基础上下文,比如“这是一个Next.js项目,使用Tailwind,不加分号,必须写测试”,每次启动Claude Code都会自动加载,不管你用不用这些内容,都会消耗 tokens。
技能文件:放在指定文件夹下,不会自动加载,只有需要时触发才会消耗tokens,适合存放PR描述、代码审查清单、部署流程等特定任务的操作规范,避免基础上下文过于臃肿。
第二步:搭建PR描述技能,3步完成配置
这里以最实用的“pr-description”技能为例,全程无需复杂操作,复制步骤就能完成。
1. 创建技能目录(终端操作)
在你的项目根目录,打开终端,输入以下命令,创建技能所需的文件夹(复制粘贴即可,无需修改):
mkdir -p .claude/skills/pr-description2. 创建SKILL.md文件,配置核心规则
进入刚刚创建的pr-description文件夹,新建一个名为SKILL.md的文件,将以下内容完整复制进去(可直接使用,无需修改,也可根据自己项目规范调整细节):
---name: pr-descriptiondescription: > Generate a pull request title and description from the current git changes. Use this skill whenever the user wants to write a PR, open a pull request, create a PR description, summarize changes for review, or asks "what should I put in my PR?" - even if they don't say "skill" or "PR description" explicitly. Also trigger when the user says "I'm done, time to PR this."---# PR Description GeneratorWhen invoked, generate a complete pull request description based on the actualgit changes in the current repository.## Steps1. **Gather context** - Run these commands to understand the changes: git log main..HEAD --oneline git diff main..HEAD --stat git diff main..HEADIf `main` doesn't exist, try `master` or `origin/HEAD`.If there's no base branch, use `git diff HEAD~1`.2. **Analyse the diff** - figure out: - What files changed and in what areas (UI, API, tests, config, docs...) - What kind of change each one is (feature, fix, refactor, cleanup...) - Whether anything might be a breaking change3. **Write the description** using this template:```markdown## Summary<!-- Plain English: what changed and why. One paragraph. -->## Changes- ...## How to test1. ...## Checklist- [ ] Tests added / updated- [ ] Docs updated if needed- [ ] No breaking changes, OR migration steps are documented above```4. **Write the title** in Conventional Commits format: : Types: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`, `perf` Example: `feat: add OAuth2 login via Google`5. **Show the title first**, then the description in a code block.## Notes- If the diff is huge (300+ lines), focus on the most important changes and note "see full diff for details" where appropriate.- Don't make up test steps - only describe what you can actually infer from the code.- If there are no commits ahead of main, say so and stop.- Don't commit without my approve 3. 启动使用,两种触发方式任选
配置完成后,重启Claude Code(重要!不重启无法识别新技能),然后两种方式都能触发技能,按需选择即可:
方式一:直接输入指令(最快捷),在Claude Code中输入 /pr-description,按下回车,AI会自动运行git命令、读取代码变更,生成完整的PR标题和描述。
方式二:自然语言触发(更便捷),直接跟Claude说“我做完了,该提交PR了”“帮我写个PR描述”,AI会根据SKILL.md中的描述,自动识别需求并触发技能,无需输入指令。
第三步:技能的存放位置,决定团队协作效率
技能有两个存放位置,对应不同的使用场景,选对了能大幅提升团队协作效率,不用每个人都重复配置:
1. 项目根目录(.claude/skills/):将技能提交到git仓库,团队所有成员拉取代码后,无需额外配置就能使用,适合团队共用的工作流(比如PR规范、代码审查标准)。
2. 个人目录(~/.claude/skills/):仅自己可见,适用于个人常用的工作流(比如个人项目的提交规范),跨所有项目可用。
注意:旧版本的Claude Code使用的是.claude/commands/目录,虽然仍能使用,但建议优先用新的.claude/skills/结构,支持子目录,后续扩展技能更方便。
三、辩证分析:Claude技能是效率神器,还是隐形负担?
不可否认,Claude技能确实解决了开发者重复解释需求的痛点,尤其是PR描述这种高频任务,能节省大量时间,让开发者专注于代码本身,这是它不可替代的价值。但很多人盲目跟风搭建技能,反而陷入了新的内耗,这两个问题值得所有人警惕。
一方面,技能描述写得太模糊,等于白搭。很多开发者图省事,把技能描述写成“帮助写PR”,结果AI无法识别触发场景,不管怎么说都无法自动触发,最后还是要手动输入指令,反而多了一步配置的麻烦。正确的做法是,描述要具体,明确写出触发场景,比如文中的描述,不仅说明功能,还列出了“我做完了,该提交PR了”这种常用话术,才能让AI精准识别。
另一方面,过度依赖技能,会降低自身能力。有开发者搭建完技能后,完全不思考PR描述的逻辑,直接复制AI生成的内容,久而久之,不仅忘记了Conventional Commits规范,甚至无法清晰总结自己的代码变更。技能的核心是“辅助”,而不是“替代”,合理使用能提升效率,过度依赖反而会让自己的工作能力退化。
更关键的是,不是所有任务都适合做技能。如果是低频任务,比如一个月才做一次的部署流程,搭建技能的时间,可能比每次手动解释需求的时间还要长,反而得不偿失。只有高频、重复、流程固定的任务,才适合用技能来优化。
四、现实意义:一个小技能,重构开发者的工作效率
对于开发者来说,日常工作中,80%的内耗都来自于重复的琐事——重复解释需求、重复写固定格式的文档、重复检查相同的代码问题。Claude技能的价值,就是把这些琐事交给AI,让开发者把时间花在更有价值的代码开发上。
除了PR描述,开发者还能基于这个逻辑,搭建更多实用技能,覆盖日常工作的方方面面:
1. /commit-message:从暂存的代码变更中,自动生成符合Conventional Commits规范的提交信息,一天能省出10分钟;
2. /review:按照预设的审查清单,自动检查代码中的常见问题(比如缺少错误处理、未写测试),避免遗漏细节;
3. /changelog:发布版本时,从git历史中自动提取变更,生成更新日志,不用手动整理。
这些技能的核心逻辑都是一样的:把重复的、固定的流程,提前写成规则,让AI来执行,减少人为的重复操作。尤其是对于团队来说,统一的技能配置,能规范工作流程,减少沟通成本,让每个人都能按照统一的标准工作,提升整体协作效率。
更重要的是,Claude技能的门槛极低,不用懂复杂的AI开发,只要会简单的文件操作,就能搭建属于自己的专属技能。对于新手开发者来说,这不仅能节省时间,还能帮助自己规范工作流程,养成良好的开发习惯;对于资深开发者来说,能进一步解放双手,专注于更有挑战性的开发任务。
五、互动话题:你正在被哪些重复工作内耗?
看完这篇内容,相信很多开发者都能找到共鸣——我们每天都在被各种重复工作消耗精力,而Claude技能,只是解决这些内耗的一个小方法。
其实除了PR描述,开发过程中还有很多可以优化的重复场景:比如重复写测试用例、重复配置项目环境、重复整理接口文档……这些场景,都能通过类似的技能来优化。
评论区聊聊吧:你平时开发中,最头疼的重复工作是什么?有没有用过类似的AI技巧来解放双手?如果有好用的Claude技能,也欢迎分享出来,帮更多开发者省时间、避坑~