Skip to content
Skills Library
Programming · Testing

test-case

/test-case

当用户需要编写一个单元测试时,触发该 skill,编写单元测试。

Repository
fastgpt ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

92/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability17 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

当用户需要编写一个单元测试时,触发该 skill,编写单元测试。

Original author description

当用户需要编写一个单元测试时,触发该 skill,编写单元测试。

How it works

  1. When to Use This Skill
  2. 测试文件位置
  3. 测试文件规则
  4. 编写流程
  5. 单测包含哪些场景
  6. 常用命令
Original SKILL.md headings · 97 lines, 192 words
SKILL.md preview
---
name: test-case
description: 当用户需要编写一个单元测试时,触发该 skill,编写单元测试。
---

## When to Use This Skill

用户需要编写一个单元测试时,触发该 skill,编写单元测试。

## 测试文件位置

### packages 测试

packages 里的测试,写在 FastGPT/packages/xxx/test 目录下,子路径对应 packages 的目录结构。例如:

`packages/global/common/error/s3.ts`文件,对应的测例文件路径为 `packages/test/global/common/error/s3.test.ts`。

并且,可以通过 @fastgpt 来导入 packages 里的文件。
例如:

```typescript
import { s3 } from '@fastgpt/global/common/error/s3';
```

### projects 测试

projects 里的测试,写在 FastGPT/projects/app/test 目录下,子路径对应 projects 的目录结构。

`projects/app/src/pages/api/core/dataset/collection/create.ts`文件,对应的测例文件路径为 `projects/app/test/api/core/dataset/collection/create.test.ts`。

## 测试文件规则

### 通用规则

1. 每个文件,对应一个测试文件。每个函数对应不同的 describe 块。
2. 需覆盖 100% 行数和分支。
3. 测试文件尽可能不要引入第三方依赖库,使用较为原生的方式进行检查。如果需要引入第三方依赖库,则从对应文件里 export 依赖库给 test 使用。例如:

```ts
// FastGPT/packages/service/common/geo/index.ts
import type { NextApiRequest } from 'next';
// 同时导出一个依赖给 FastGPT/packages/service/test/common/geo/index.test.ts 使用
export type { NextApiRequest } from 'next';
```

4. 尽量减少函数 mock,如果是系统上原生可运行的函数,则无需 mock,只需要 mock 那些无法本地直接运行的依赖(比如需要远程服务,API 密钥之类的)
5. 对于 type.ts, constants.ts, schema.ts, *.schema.ts 文件,以及静态数据,直接跳过忽略。
6. 根据 [vitest.config.mts](../../../../vitest.config.mts) 文件配置,跳过不需要测试的文件。
7. [Mock.ts](../../../../test/mocks/index.ts) 文件里,包含了全局 mock 的内容,在编写测试时,请勿重复 mock。理论上,测试里可以 mock 运行各类 infra。

### 基础函数文件测试

尽量不要 mock,而是完整的运行其逻辑进行测试。

### 带 API 请求的函数

mock 对应的 API 请求进行测试。

## 编写流程

**一、任务准备**

1. 获取所需要编写的测试文件。
2. 创建任务清单,来逐个完成每个文件的测例编写。

**二、测例编写**

不同测例文件,可以并行进行编写。

1. 检查对应的 .test.ts 测试文件,如果没有则创建。
2. 思考和分析代码后编写测试样例。
3. 检查 TS 错误,确保无 ts 报错。
4. 完成所有测试文件编写

**三、结果验证**

1. 调用`pnpm test <file-path> <test-name>`来运行测试并检查覆盖率,确保每个文件的覆盖率达到 90% 以上。
2. 如果测试不通过,则根据错误信息检查代码逻辑或者测试用例。
3. 如需二次修改,则回到”二、测例编写“。

## 单测包含哪些场景

1. 基础场景
2. 复杂场景
3. 边界值
4. 安全边界情况(死循环、系统崩溃、超大数据等)
5. 异常场景

## 常用命令

```shell
# 运行所有测试
pnpm test

# 运行指定测试文件(file-path 填完整文件路径)
pnpm test <file-path>

# 运行指定测试文件的指定测试
pnpm test <file-path> <test-name>
```

Versions

RepositoryScoreLicence
This page · labring/fastgpt92Apache-2.0
marian-kamenistak/sap-ai-skills90MIT

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 98450bcf6bad (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100test-case-analysis
    Use when a TMS test case needs manual execution, selector discovery, or defect investigation before automation — "analyse SCRUM-T101", "run this case and emit an AFS", any pre-automation case exploration. Produces an Automation-Friendly Spec (AFS); does not write test code.
  • 92golden-case
    Author a golden test case for a Fairmark method with expected values from an independent source. Use when adding coverage for a method or an acceptance criterion.
  • 92golden-case
    Author a golden test case for a Fairmark method with expected values from an independent source. Use when adding coverage for a method or an acceptance criterion.
  • 100hk-test-case-audit
    Write up this repo's test gaps as one HTML page scored per suite: what has no test, which tests pass with the code broken, which bill a provider, what to write first. Reads a directory or PR; runs the verify gate when asked to score. Triggers on: 'test gaps', 'what has no test',…
  • 100atr-author
    Write, author, add or record an ATR behaviour test. Convert a manual test case or a QA script into a .test.txt spec. Use when creating a new browser test, turning a bug report into a regression test, or fixing a spec that compiles badly, produces a false pass, or keeps needing…
  • 96writing-skills
    Create or edit a skill (SKILL.md) when the user asks for one.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.