From 210c677c1bb0e2d3dce6c816574a4026ce58ea6b Mon Sep 17 00:00:00 2001
From: Qiu Yuzhou <qiuyuzhou@gmail.com>
Date: Sat, 3 Oct 2026 23:26:09 +0800
Subject: [PATCH] =?UTF-8?q?docs(ng2):=20=E6=B5=8B=E8=AF=95=E6=A1=86?=
 =?UTF-8?q?=E6=9E=B6=E6=94=BF=E7=AD=96=E5=85=A5=20AGENTS.md=EF=BC=8C?=
 =?UTF-8?q?=E6=96=B0=E6=B5=8B=E8=AF=95=E9=BB=98=E8=AE=A4=20Swift=20Testing?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ShadowsocksX-NG2/AGENTS.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/ShadowsocksX-NG2/AGENTS.md b/ShadowsocksX-NG2/AGENTS.md
index a21e462b..41e64fbb 100644
--- a/ShadowsocksX-NG2/AGENTS.md
+++ b/ShadowsocksX-NG2/AGENTS.md
@@ -10,3 +10,8 @@
 - 生产代码读取 app bundle 内打包资源（规则快照、LaunchDaemon 清单等）时，走注入缝——控制器的 `appBundle` 参数（生产默认 `Bundle.main`），测试夹具注入 `AppArtifact.bundle`。
 
 背景与三处资源缝的由来见 [ADR-0021](../docs/adr/0021-hostless-unit-tests.md)。
+
+## Test framework
+
+- 新增测试默认用 Swift Testing（`import Testing`）；UI 测试与性能测试依赖 XCTest 专属 API（`XCUIApplication`、`measure` 计时），继续用 XCTest；存量 XCTest 用例不回迁。
+- 单测多 runner 并行执行：新夹具只占用进程私有资源——运行时分配端口、临时目录、UUID 后缀命名空间，不写共享路径与固定名。