taiyi-test

Files (1)

• SKILL.md

SKILL.md (first lines)

# taiyi-test — 测试验证

> 进入本阶段前请优先读 `.taiyi/changes/<slug>/PHASE-CONTEXT.md`（~500 tokens），不要全量加载上游工件。

## 框架集成

本阶段使用以下框架：

| 框架 | 用途 | 何时加载 |
|------|------|---------|
| **Harness** | 阶段门禁与推进（`status` → `continue`；legacy：`npx taiyi complete`） | 全程 |
| **GStack** | `browse` — 用于 E2E 浏览器测试和截图验证 | Round 5（E2E 轮） |
| **Superpowers** | `verification-before-completion` — 完成前全量验证 | 完成前 |

**OpenSpec / Spec-Kit / OMO** 在本阶段不涉及。

## 前置门禁（Pre-flight）

### 0.1 上游确认
- dev 阶段已过关（`.taiyi/changes/<slug>/.dev-complete` 存在且 `exitCode: 0`）
- 实现代码已通过 TDD 红→绿循环

### 0.2 Profile 判定

| Profile | TEST.md 要求 |
|---------|------------|
| `full` | 完整覆盖：5 rounds + 6 维回归测试 + 新 file GREP 填空 + Traceability |
| `api/ui` | 同 full |
| `lite` | 简化版：跳过 round 4-5，6 维回归可选 |
| `spike/micro` | 跳过本阶段 |
| `nano` | 跳过 |

### 0.3 前置检查清单
- [ ] .dev-complete 存在且有 GREEN 证据
- [ ] 明确项目的测试命令（npm test / pytest / cargo test 等）

---

## 步骤

### 工件契约

| 层 | 路径 | 职责 |
|----|------|------|
| **语义真源** | `test.json` | Zod（`src/schemas/test.ts`） |
| **生成视图** | `TEST.md` | hbs（`src/templates/test.hbs`） |
| **流程** | 本 Skill | 5 轮 AC 覆盖、6 维回归、Traceability |

**工作流**：实跑测试 → 更新 json 证据 → `scripts/taiyi-forge.sh render <slug> test` → `status` → `continue`。

详见 [`docs/taiyi/artifact-contract.md`](../../docs/taiyi/artifact-contract.md)。

### json 字段（Zod 摘要）

| 字段 | 要求 |
|------|------|
| `title` | 测试计划标题 |
| `test_plan` | ≥1 用例；`id` / `description` / `status`（passed/failed/pending） |
| `unit_framework` / `unit_coverage_target` | 可选 |
| `edge_cases` / `performance_tests` / `security_checks` | 可选 |
| `regression_plan` / `regression_items` | 可选；6 维回归仪表盘内容 |
| `mocking_boundaries` | 可选；哪些层可 mock |
| `summary` / `coverage` | 可选；执行摘要 |
| `evidence` | 有 `passed` 时推荐填真跑命令 |

### 写作指引（填入 json，render 生成 TEST.md）

### 1. TEST.md 全局结构

```
# TEST: <slug 标题>

## Overview
| AC | Round | Type | Status |
|----|-------|------|--------|
```

### 2. 按 AC 的 5 轮测试

每轮一个 table，AC 编号来自 REQUIREMENT.md：

```
### Round 1: 功能正确性（AC 正向）
| AC | PR | Test | Priority | Key Assertions |
|----|----|------|----------|----------------|

### Round 2: 边界条件（AC 负面 + 边值）
| AC | PR | Test | Priority | 边界值 |
|----|----|------|----------|--------|

### Round 3: 错误处理（AC 异常路径）
| AC | PR | Test | Priority | Error Handling |
|----|----|------|----------|---------------|

### Round 4: 集成（跨组件）
| AC | PR | Test | Priority | Endpoint / Interaction |
|----|----|------|----------|-----------------------|

### Round 5: 端到端（关键路径 / 用户流程）
| AC | PR | Test | Priority | Flow |
|----|----|------|----------|------|
```

### 3. 6 维回归测试仪表盘

每个维度用 3 态表示：✅ 通过 / ❌ 未通过 / ⬜ 不适用

```
### Regression Dashboard (pre-landing)

| Dimension | Status | Notes |
|-----------|--------|-------|
| D1 完整功能 | ✅ | 21/21 AC passed |
| D2 边界值 | ✅ | null/empty/long/edge |
| D3 性能 | ⬜ | 无性能要求 |
| D4 并发 | ✅ | 新建不冲突 |
| D5 安全 | ⬜ | 无认证逻辑 |
| D6 回滚 | ✅ | 向下兼容 |
```

From Dong90/oh-my-taiyiforge, MIT.

More from Dong90/oh-my-taiyiforge