# Test

> 专注测试职能。用于编写/优化测试用例、执行单元测试与集成测试、产出测试报告。严禁修改任何业务代码，仅限操作测试代码。触发词包括"写测试"、"跑测试"、"单元测试"、"集成测试"、"test"、"/test"。

- **Type:** Skill
- **Install:** `agentstack add skill-simpleeve-development-skills-test`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SimpleEve](https://agentstack.voostack.com/s/simpleeve)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SimpleEve](https://github.com/SimpleEve)
- **Source:** https://github.com/SimpleEve/development-skills/tree/main/test

## Install

```sh
agentstack add skill-simpleeve-development-skills-test
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Test - 测试技能

根据 plan 文档编写并执行单元测试与集成测试，产出结构化测试报告。该技能的核心目标是**验证**而非**修复**。

## 职能边界

1. **绝对禁令**：**禁止修改任何非测试相关的业务源码**。即便发现 bug，也只能在测试报告中记录并建议修复，不得自行调用 `/implement` 或手动修改源码。
2. **操作范围**：仅允许修改、新增测试文件、测试目录内容，或项目明确归类为测试资产的文件。
3. **输出目标**：高质量的测试代码覆盖及详尽的 `test.md` 测试报告。

## 核心原则

1. **以 Plan 为准**：测试用例严格基于 `plan.md` 中的验收标准与测试规范。
2. **验证驱动**：所有职能围绕“证明代码是否符合预期”展开。
3. **独立报告**：测试结果必须固定产出到对应的 `test.md` 文档中。
4. **可调用外部 Skill/工具**：需要环境观测、运行验证、引擎执行或自动化操作时可调用相应工具。

## 工作流程

### 阶段一：单元测试

1. **阅读 Plan 的测试标准**
   - 阅读对应功能 `plan.md` 中的"单元测试标准"。
   - 提取每个 TODO 的验收标准。

2. **编写/优化单元测试**
   - 仅在测试目录或项目既有测试命名约定下编写代码。
   - 覆盖正常路径、边界条件、异常场景。

3. **执行单元测试**
   - 运行项目测试命令或测试入口（如 `vitest`、`npm test`、`pnpm test`、`dotnet test`、Unity Test Runner）收集结果。

4. **失败分析与记录**
   - 如果测试失败：
     a. 分析是测试代码本身的逻辑错误，还是业务代码的 bug。
     b. 如果是测试代码写错了，直接在测试文件中修正。
     c. 如果是业务代码 bug，**停止修改行为**，将失败原因、错误日志及重现步骤记录到测试报告中。

### 阶段二：集成 / 场景验证

1. **阅读 Plan 的集成测试标准**
   - 阅读对应功能 `plan.md` 中的"集成 / 场景验证标准"。

2. **编写并执行集成 / 场景验证**
   - 根据场景编写独立的测试脚本、测试用例或自动化验证流程。
   - 捕获命令输出、退出码、运行结果、日志或截图作为执行证据。

### 阶段三：产出测试报告

按照下方固定模板撰写，写入对应功能的 `test.md`。

## 固定模板

```markdown
#  测试报告

> 关联 Spec：
> 关联 Plan：
> 测试日期：YYYY-MM-DD
> 测试环境：运行时 / OS / 版本 / 其他相关信息

## 测试总结

| 指标           | 数值 |
| -------------- | ---- |
| 单元测试总数   | N    |
| 单元测试通过   | N    |
| 单元测试失败   | N    |
| 集成测试总数   | N    |
| 集成测试通过   | N    |
| 集成测试失败   | N    |
| 总体通过率     | N%   |

## 单元测试详情

### ✅ 通过的测试

| 测试文件        | 测试用例 | 对应 TODO |
| --------------- | -------- | --------- |
| `path/to/test`  | 测试描述 | TODO-S1   |

### ❌ 失败的测试

#### [FAIL-1] 

- **测试文件**：`path/to/test`
- **对应 TODO**：TODO-XX
- **失败原因**：详细描述（明确区分是测试错误还是业务 bug）
- **修复建议**：针对业务 bug 提出修改建议
- **错误日志**：
```
相关的错误输出
```

## 集成 / 场景验证详情

### 场景 1：
- **操作步骤**：...
- **期望结果**：...
- **实际结果**：✅ 符合预期 / ❌ 与预期不符
- **证据**：命令输出 / 日志 / 截图路径 / 运行结果

## 未覆盖的测试场景

列出 Plan 中要求但本次未覆盖的测试场景及原因。

## 遗留问题

列出需要人工关注的问题（如环境限制、业务代码存在的风险点等）。
```

## 关键约束

- **禁止跨权**：严禁调用 `/implement` 技能或者直接去尝试修复业务逻辑。
- **测试独立性**：每个测试用例应独立运行，不依赖其他测试的执行顺序。
- **不修改 spec/plan**：测试过程中发现 spec 或 plan 的问题，记录到报告中，不自行修改。
- **证据完整**：每个关键测试场景必须有可验证的执行证据。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SimpleEve](https://github.com/SimpleEve)
- **Source:** [SimpleEve/development-skills](https://github.com/SimpleEve/development-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-simpleeve-development-skills-test
- Seller: https://agentstack.voostack.com/s/simpleeve
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.