149 lines
4.3 KiB
Markdown
149 lines
4.3 KiB
Markdown
|
# MERN全栈开发插件
|
|||
|
|
|
|||
|
|
`MERN` `MongoDB` `Express` `React` `Node.js` `Claude Code` `插件` `测试生成` `代码审查`
|
|||
|
|
|
|||
|
|
# MERN Ninja
|
|||
|
|
|
|||
|
|
> 面向 [Claude Code](https://claude.ai/claude-code) 的 MERN 全栈精通工具
|
|||
|
|
|
|||
|
|
一个为 Claude Code 提供 MongoDB、Express、React 和 Node.js 开发专项技能的插件。
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 第一步：添加市场（仅需一次）
|
|||
|
|
/plugin marketplace add 9tykeshav/mern-ninja-marketplace
|
|||
|
|
|
|||
|
|
# 第二步：安装插件
|
|||
|
|
/plugin install mern-ninja@mern-ninja-marketplace
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 技能
|
|||
|
|
|
|||
|
|
### `mern-ninja:backend-test-writer`
|
|||
|
|
|
|||
|
|
以智能默认值、零配置方式生成全面的后端测试。
|
|||
|
|
|
|||
|
|
**直接说：**
|
|||
|
|
```
|
|||
|
|
为我的用户路由生成测试
|
|||
|
|
为认证服务编写测试
|
|||
|
|
为 User 模型创建测试
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**功能说明：**
|
|||
|
|
|
|||
|
|
| 文件类型 | 测试类型 | 方式 |
|
|||
|
|
|----------|----------|------|
|
|||
|
|
| 路由/控制器 | 集成测试 | Supertest + mongodb-memory-server |
|
|||
|
|
| 服务 | 单元测试 | Mock 依赖 |
|
|||
|
|
| 模型 | 单元测试 | 校验、方法、toJSON |
|
|||
|
|
| 中间件 | 单元测试 | Mock req/res/next |
|
|||
|
|
| 工具函数 | 单元测试 | 纯函数测试 |
|
|||
|
|
|
|||
|
|
**特性：**
|
|||
|
|
- 自动检测测试框架（Jest/Vitest/Mocha）
|
|||
|
|
- 在生成新测试前分析现有测试的覆盖缺口
|
|||
|
|
- 为每个测试用例标注优先级（P0/P1/P2）
|
|||
|
|
- 针对特定领域的边界情况（日期 → 夏令时/时区，金额 → 精度）
|
|||
|
|
- 内置 Setup/Teardown 样板代码
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### `mern-ninja:code-reviewer`
|
|||
|
|
|
|||
|
|
从安全、性能和最佳实践角度审查 MERN 全栈代码。
|
|||
|
|
|
|||
|
|
**直接说：**
|
|||
|
|
```
|
|||
|
|
审查我的认证代码
|
|||
|
|
检查这个 Express API 的安全问题
|
|||
|
|
审计这个 MongoDB Schema
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**审查优先级：**
|
|||
|
|
|
|||
|
|
| 优先级 | 关注点 |
|
|||
|
|
|--------|--------|
|
|||
|
|
| 1. 安全 | 注入攻击、XSS、认证缺陷、密钥泄露、CORS |
|
|||
|
|
| 2. 性能 | N+1 查询、重复渲染、阻塞操作 |
|
|||
|
|
| 3. 最佳实践 | 错误处理、异步模式、资源清理 |
|
|||
|
|
| 4. 架构 | API 设计、状态同步、类型安全 |
|
|||
|
|
|
|||
|
|
**示例输出：**
|
|||
|
|
|
|||
|
|
```markdown
|
|||
|
|
# MERN 代码审查
|
|||
|
|
|
|||
|
|
## 摘要
|
|||
|
|
- 已审查文件：5
|
|||
|
|
- 问题：2 个严重，3 个重要，5 条建议
|
|||
|
|
|
|||
|
|
## 严重（必须修复）
|
|||
|
|
### [C1] 安全：登录接口存在 NoSQL 注入
|
|||
|
|
**文件：** `api/auth/login.js:24`
|
|||
|
|
**原因：** 用户输入直接传入查询
|
|||
|
|
**修复：** 使用显式字段匹配
|
|||
|
|
|
|||
|
|
## 做得好的地方
|
|||
|
|
- JWT 刷新流程正确
|
|||
|
|
- 错误响应格式一致
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### `mern-ninja:mongodb-query-patterns`
|
|||
|
|
|
|||
|
|
以数据流优先的方式编写可扩展的 MongoDB/Mongoose 查询。
|
|||
|
|
|
|||
|
|
**以下情况会自动触发：**
|
|||
|
|
```
|
|||
|
|
编写新的 Mongoose 查询
|
|||
|
|
在服务之间传递数据
|
|||
|
|
构建读写 MongoDB 的接口
|
|||
|
|
在可传递文档的地方传递了 ID
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**核心理念：** 最好的查询是根本不发出的查询。在调用栈中传递文档——不要重复获取调用方已经拥有的数据。
|
|||
|
|
|
|||
|
|
**涵盖的模式：**
|
|||
|
|
|
|||
|
|
| 模式 | 防止的问题 |
|
|||
|
|
|------|-----------|
|
|||
|
|
| 在服务间传递数据 | 同一文档在服务边界被重复查询 3-4 次 |
|
|||
|
|
| 使用 `$in` + Map 批量处理 | 每条记录触发一次查询的 N+1 循环 |
|
|||
|
|
| `.select()` + `.lean()` | 读路径上携带 Mongoose 开销的全文档查询 |
|
|||
|
|
| 避免对列表使用 `.populate()` | 隐藏在整洁 API 背后的隐式 N+1 查询 |
|
|||
|
|
| 直接使用 `updateOne` | 简单字段更新的"查询-修改-保存"往返 |
|
|||
|
|
| 使用 `bulkWrite` | 顺序执行的更新循环 |
|
|||
|
|
| 提升公共查询 | if/else 分支中的重复查询 |
|
|||
|
|
| 为过滤字段建立索引 | 全集合扫描（COLLSCAN） |
|
|||
|
|
|
|||
|
|
**包含：** 提交前检查清单、常见错误对照表，以及"每条查询都必须自证其存在"的决策框架。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 参考指南
|
|||
|
|
|
|||
|
|
插件内置约 1500 行精心整理的最佳实践：
|
|||
|
|
|
|||
|
|
| 指南 | 内容 |
|
|||
|
|
|------|------|
|
|||
|
|
| `security.md` | OWASP Top 10、MERN 特有漏洞 |
|
|||
|
|
| `react.md` | Hooks、重复渲染、安全、测试 |
|
|||
|
|
| `nodejs.md` | 异步模式、事件循环、内存管理 |
|
|||
|
|
| `express.md` | 中间件、认证、错误处理 |
|
|||
|
|
| `mongodb.md` | Schema 设计、索引、查询 |
|
|||
|
|
| `fullstack.md` | API 设计、认证流程、状态同步 |
|
|||
|
|
| `test-patterns.md` | 按文件类型分类的完整测试示例 |
|
|||
|
|
| `test-setup.md` | Jest 配置、测试夹具、Mock |
|
|||
|
|
|
|||
|
|
## 路线图
|
|||
|
|
|
|||
|
|
- [ ] `mern-ninja:scaffolder` – 生成 MERN 脚手架
|
|||
|
|
- [ ] `mern-ninja:migrator` – 数据库迁移辅助工具
|
|||
|
|
- [ ] `mern-ninja:frontend-test-writer` – React 组件测试
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
MIT
|