Claude Code Skills 有个人级和项目级的区别。这个分工如果一开始没想清楚,后面很容易变成一堆重复技能。
官方文档:
Claude Code Docs
Extend Claude with skills - Claude Code Docs
Create, manage, and share skills to extend Claude's capabilities in Claude Code. Includes custom commands and bundled skills.
我的分工原则
个人级 Skills
适合放所有项目都通用的工作习惯:
~/.claude/skills/
比如:
- 代码审查
- 写 commit message
- 整理 release notes
- 读 PDF / 读论文
- 通用安全检查
这些技能跟某个仓库无关,换项目也能用。
项目级 Skills
适合放当前仓库独有的规则:
.claude/skills/
比如:
- 本项目的发布流程
- 数据库迁移规范
- UI 组件使用约定
- 特定测试命令
- 内部 API 约定
这些东西离开项目就没有意义。
一个例子
个人级 code-review 只写通用审查原则。
项目级 frontend-review 再补:
- Use existing Button, Dialog, Table components.
- Do not introduce a new chart library.
- Run `pnpm test` and `pnpm lint`.
- Verify mobile and desktop layout.
这样既能复用,又不会让一个 Skill 变得巨大。
反模式
我不建议把所有规则都塞进一个 my-super-skill。
问题是:
- 触发范围太大。
- 每次加载内容太多。
- 模型不知道哪条最重要。
- 后期维护困难。
我的结论
个人级 Skills 管“工作方法”,项目级 Skills 管“项目事实”。
这个边界一旦分清,Skills 会非常好维护。
2 个帖子 - 1 位参与者