搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

nestjs/agent-skills

开发工具

面向 NestJS 开发者的官方 Agent Skills,为编码智能体补充当前 API、项目惯例和易错点。

这是一个 Agent 技能包 · 6 个技能看技能清单和安装方法 →
115
3
JavaScript
MIT
创建于 1 天前

项目介绍

这个仓库为编码智能体提供六个官方 Agent Skills,用于创建和扩展 NestJS 应用。每个技能是一个文件夹,其中的 SKILL.md 写规则和易错点,references/ 放较长的示例配方。内容侧重当前 API、Nest 一方维护的包,以及那些测试能过、实际却有问题的做法,例如登录接口泄露邮箱是否存在、@IsOptional() 把 null 放行到 500、限流器根本认不出用户、事件流在密钥被吊销后仍然存活。

六个技能各管一块:

  • nestjs:项目初始化和布局、模块系统
  • nestjs-feature:新增或修改端点、校验、状态码、错误、Server-Sent Events
  • nestjs-auth:认证和授权策略
  • nestjs-data:Drizzle 与 TypeORM 持久化、迁移、安全更新、分页和事务
  • nestjs-testing:单元、服务和端到端测试
  • nestjs-production:配置、日志、可观测性、健康检查、限流、OpenAPI 和关停

智能体会根据技能描述匹配任务并自动加载,不需要手动调用。文件遵循 Agent Skills 规范,同一份技能可用于 Claude Code、Codex、Cursor 等兼容智能体。

快速使用

多数智能体可以在项目根目录运行 npm 安装器:

npx @nestjs/skills add

默认把全部技能复制到 .agents/skills/,Codex 和 Cursor 会读取这个目录。用 --agent 可以换目标目录:claude 写入 .claude/skills/,cursor 写入 .cursor/skills/,all 同时写入 .agents/skills/ 和 .claude/skills/;也可以组合多个目标。加 --global 可为本机所有项目安装。只装部分技能时在命令后列出名称,例如 npx @nestjs/skills add nestjs nestjs-auth。list 和 remove 子命令用于查看和清理已安装的副本。

安装后的文件夹带有 .nestjs-skills 标记,安装器只替换或删除自己安装的文件夹;--force 会覆盖同名但不是它安装的文件夹。如果把依赖固定到项目里,可以安装为开发依赖后运行 npx nestjs-skills add。

Claude Code 用户也可以从仓库市场安装:

claude plugin marketplace add nestjs/agent-skills
claude plugin install nestjs@nestjs

通过插件安装的技能带命名空间,例如 nestjs:nestjs-auth。不使用插件时,执行 npx @nestjs/skills add --agent claude 效果相同。

手动安装的做法是克隆仓库,把技能文件夹复制到智能体读取的目录,如 .agents/skills/ 或 ~/.agents/skills/。要保持文件夹完整,因为 SKILL.md 通过相对路径链接 references/,技能之间也按名称互相引用。使用符号链接可以让副本随 git pull 保持更新。

安装后直接让智能体处理一个 NestJS 任务,例如新增端点或编写端到端测试,它应当按描述选中对应技能。

使用约束

技能面向 NestJS 12(@nestjs/core 12.x)和 Node.js 20 及以上版本。配方实际运行在 Nest 12.5.1 和一组特定版本的一方包上,包括 @nestjs/authentication 0.1.6、@nestjs/authorization 0.1.4、@nestjs/drizzle 0.0.2 搭配 Drizzle 1.0 rc、@nestjs/typeorm 12.0.3 搭配 TypeORM 1.1,以及多个 @nestjs/* 工具包。使用较旧 Nest 版本的项目可能需要调整其中的建议;技能本身也会要求智能体先核对已安装版本和 NestJS 文档,不要只依赖模型记忆。

文件夹名称对插件和安装器都有意义。通过 npm 更新时重新运行安装器只会替换它安装的副本;手动复制的文件夹需要重新 git pull 并复制,符号链接的文件夹会随拉取更新。Claude Code 的市场更新和插件更新是两条独立命令。仓库使用 MIT 许可证。

HotRepo 点评

这是一个出现时间很短、起步却很快的仓库:在 2026-11-20 开始、2026-11-21 结束的单个新项目榜窗口内,它记录了 100 个 Star 和 3 个 Fork,窗口结束时 Star 数仍为 100。这只能说明早期关注度,不能当成长期记录;在全部语言 GitHub 日榜上也还没有记录到名次。材料能确认的是分发方式:仓库同时是 Claude Code 插件和它自己的市场,并以 @nestjs/skills npm 包提供安装器,因此可以接入多个智能体生态,不需要额外集成。技能的实际价值仍取决于读者项目的 Nest 版本与测试过的 12.x 技术栈有多接近。

本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. nestjs/nest面向 Node.js 后端的 TypeScript 框架,提供模块、依赖注入和成套官方包。TypeScript77,128
  2. addyosmani/agent-skills把资深工程师的规范、测试、评审与发布流程写成 Markdown 技能,让 AI 编程助手按步骤执行。JavaScript116,771
  3. vercel-labs/agent-skills把 Vercel 的 React、Next.js 与部署约定打包成技能,让 AI 编程助手按需加载。JavaScript32,947
  4. wshobson/agents把同一套编程 Agent、技能和命令适配到 Claude Code、Codex、Cursor 等多个工具,省去重复维护提示词。Python41,629
  5. android/skillsGoogle 官方出品的 Android 技能文件,专门补上大模型最容易做错的那类 Android 开发任务。Kotlin9,568