全栈开发怎么用 Claude Code？claude-skills 配置与使用方法

周一下午接到个需求，就一句话：「把用户头像上传功能接到资料页上。」可咱们的仓库是 pnpm monorepo 架构，前端用 Next.js，接口跑在 NestJS 上，数据层还走的 Prisma。要是上来就让 Claude Code 直接开干，它说不定会乱换上传库、漏掉服务端校验，甚至碰了不该动的表结构。虽说 claude-skills 能补上专业判断这块，但项目边界咱还是得先掰扯清楚。

配置不是把 66 个技能逐个打开

官方的 Quick Start 把日常用法讲得很直白：你发请求的时候把框架/语言、要做的任务、限制条件说清楚；要是排错的话，再把错误信息附上就行。上下文给够了，相关技能会自动根据请求激活的。所以配置的重点根本不是守着一排开关挨个开，而是得让 Claude 搞明白「我在哪个项目里、要改哪一块、做到啥样算完成」。

先填一张四格项目卡

配置项	本次示例
技术栈	apps/web 端用 Next.js，apps/api 端用 NestJS，数据库用 Prisma 连 PostgreSQL
任务范围	新增头像上传接口、前端预览和提交功能，不动用户注册流程
改动禁区	不换现有依赖、不改鉴权方案；要是需要做数据迁移，先停下来等确认
验收结果	要校验文件类型和大小，正确处理 401 和文件超限错误，相关测试、lint 还有类型检查都得通过

这四格内容会直接影响技能的工作方式。比如 Fullstack Guardian 会从前、后端和安全三个维度来处理同一个功能，还会要求先明确验收条件、实现计划，做完安全检查再动手。它很适合用来统筹端到端的改动，但可不会替你决定公司定的文件大小上限是多少哈。

任务按一个纵向切片来写

千万别一上来就甩一句「把整个个人中心都做了」。得先把范围收窄到头像这一条数据流：从选文件、前端预览、API 校验，到存完之后刷新状态。各个框架的技能会负责各自部分的实现，Fullstack Guardian 盯紧接口和安全，Test Master 则会检查空文件、格式错误、文件超限还有未登录这些场景。要是给的范围太大，真出问题找起原因来反而更慢。

稳定规则写进 CLAUDE.md，本次需求留在对话里

像目录职责、包管理器、常用测试命令、接口错误格式还有团队约定这些固定的内容，适合放到项目根目录的 CLAUDE.md 里，这样 Claude Code 每次开新会话都能读到。而像头像尺寸、这次允许改哪些文件、能不能做数据迁移这类内容，只属于当前任务，就别永久写进去了。官方文档也特意提醒过，CLAUDE.md 只是给上下文用的，不是强制执行的安全策略；真要禁止危险操作，还是得靠权限或者钩子来约束。

开工指令可以这样给

项目：pnpm monorepo 架构；apps/web 是 Next.js，apps/api 是 NestJS，packages/db 用 Prisma。
任务：跑通用户头像上传的整条端到端数据流。
边界：保留现有的鉴权方案和依赖；要是需要做数据库迁移或者加新包，先说明理由等我确认。
验收：限制文件类型和大小；覆盖未登录、文件超限、上传失败这些场景；跑通相关测试、lint 和类型检查。
执行：先读相关文件，列个最小改动清单再动手改。改完之后告诉我改了哪些文件、命令运行结果还有剩下的风险点。
麻烦用 Fullstack Guardian 统筹前后端和安全，再让 Test Master 检查下测试有没有缺口。

没叫对专家，先改任务描述

要是 Claude 给的回答太泛，先把框架名、目录、目标还有错误现象补全；要是还是没匹配到对应的技能，再明确写「用 NestJS Expert」或者「用 Fullstack Guardian」。官方 Quick Start 里也把主动点名技能列为排查方法之一。要是都写得这么具体了还是没触发技能，再用 /skills 看看有哪些可用技能，检查下插件状态。千万别一上来同时点十几个专家哈。

判断配置有没有效其实很简单：下次换成「修改收货地址」这类需求的时候，技术栈、目录职责、验证命令这些都能直接沿用，只需要换任务内容和验收条件就行。能复用的是项目的固定事实，必须每次重写的是当前任务的边界。把这俩分开，claude-skills 就不用每次都从越来越长的提示词里重新猜你的需求了。