@lark-apaas/coding-miaoda-sandbox-skills 0.1.44 → 0.1.46
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/miaoda/testing-guide/SKILL.md +21 -13
- package/package.json +1 -1
|
@@ -8,13 +8,21 @@ gate-tools:
|
|
|
8
8
|
when:
|
|
9
9
|
subagent_type: E2E
|
|
10
10
|
---
|
|
11
|
+
{% if allSkillNames['backend-api-test'] %}
|
|
12
|
+
{% set apiTestChannel = 'backend-api-test（Bash + curl）' %}
|
|
13
|
+
接口测试先加载 `{{allSkillNames['backend-api-test'].location}}`，按该 skill 执行 curl。
|
|
14
|
+
{% else %}
|
|
15
|
+
{% set apiTestChannel = 'api_request' %}
|
|
16
|
+
{% endif %}
|
|
17
|
+
不执行上传类功能验收。
|
|
18
|
+
|
|
11
19
|
{% if visualCheckEnabled %}
|
|
12
20
|
# 浏览器验收（E2E）用法
|
|
13
21
|
|
|
14
22
|
向用户只说「用浏览器操作验证」，不要解释内部工具或 agent 名称。
|
|
15
23
|
|
|
16
24
|
- 派 `Task(subagent_type="E2E")` 时一律按标准语义执行，调用时不要额外指定运行方式。
|
|
17
|
-
- E2E 结束后不追加 `
|
|
25
|
+
- E2E 结束后不追加 `{{apiTestChannel}}` 调用。
|
|
18
26
|
|
|
19
27
|
## 调用方式
|
|
20
28
|
|
|
@@ -58,7 +66,7 @@ Task({
|
|
|
58
66
|
|
|
59
67
|
# 检查与验证：工具选择指南
|
|
60
68
|
|
|
61
|
-
根据用户意图选择正确的派遣方式：派遣 E2E 子 agent（通过 `Task(subagent_type="E2E")` 打开浏览器操作一遍）或调用 `
|
|
69
|
+
根据用户意图选择正确的派遣方式：派遣 E2E 子 agent（通过 `Task(subagent_type="E2E")` 打开浏览器操作一遍）或调用 `{{apiTestChannel}}`（直接请求后端接口）。
|
|
62
70
|
|
|
63
71
|
## 用户沟通规范
|
|
64
72
|
|
|
@@ -73,16 +81,16 @@ Task({
|
|
|
73
81
|
|
|
74
82
|
```
|
|
75
83
|
用户想确认应用是否正常
|
|
76
|
-
├─ Task 工具定义的 subagent_type 选项里没有 E2E（E2E 被关闭/不可用，非"本轮没派过"）→
|
|
77
|
-
├─ 明确要求验证「后端接口」「API 返回值」「请求响应」 →
|
|
84
|
+
├─ Task 工具定义的 subagent_type 选项里没有 E2E（E2E 被关闭/不可用，非"本轮没派过"）→ {{apiTestChannel}}（接口级验收）+ 读代码/读日志兜底，不要尝试派 E2E
|
|
85
|
+
├─ 明确要求验证「后端接口」「API 返回值」「请求响应」 → {{apiTestChannel}}
|
|
78
86
|
└─ 其他所有情况 → Task(subagent_type="E2E")（打开浏览器，以用户视角操作应用）
|
|
79
87
|
```
|
|
80
88
|
|
|
81
|
-
- **E2E 不可用时改走
|
|
82
|
-
- **模糊需求一律派遣 E2E**（仅当 E2E 可用）：未明确提到「接口」「API」「后端」时必须派遣 E2E，不要主动选择 `
|
|
89
|
+
- **E2E 不可用时改走 {{apiTestChannel}}（最高优先，先于下面所有规则判断）**：当 Task 工具定义的 subagent_type 选项里没有 E2E（用户关闭了浏览器验收 / 环境不支持；判断依据是工具定义中是否含 E2E 选项，不是"本轮有没有派过 E2E"）时，下面"模糊需求一律派遣 E2E"不再适用——改用 `{{apiTestChannel}}` 做接口级验收，配合读代码 / 读运行时日志确认核心链路，**不要尝试派 E2E、也不要空等**；此时验收范围收敛到接口与数据层可判定结果，视觉类目标顺延到非核心降级范围
|
|
90
|
+
- **模糊需求一律派遣 E2E**（仅当 E2E 可用）：未明确提到「接口」「API」「后端」时必须派遣 E2E，不要主动选择 `{{apiTestChannel}}`
|
|
83
91
|
- **E2E 一律完整执行**：派 `Task(subagent_type="E2E")` 时按标准语义执行，调用时不要额外指定运行方式；视觉检查随页面访问一起完成
|
|
84
|
-
- **`
|
|
85
|
-
- **E2E 结束后禁止追加 `
|
|
92
|
+
- **`{{apiTestChannel}}` 仅限显式请求**：仅当明确提到接口 / API / 后端 / 请求 / 响应、且意图是验证接口逻辑而非页面功能时才使用
|
|
93
|
+
- **E2E 结束后禁止追加 `{{apiTestChannel}}`**：浏览器操作的结果即为最终结果，**严禁**再自动补充验证
|
|
86
94
|
|
|
87
95
|
### 低投入产出验收的停止边界
|
|
88
96
|
|
|
@@ -96,7 +104,7 @@ Task({
|
|
|
96
104
|
| --- | --- | --- |
|
|
97
105
|
| "检查一下页面" / "看看有没有问题" / "哪里出问题了" / "试试能不能用" / "XX 不好使" / "刚改了 CSS，看看样式对不对" | E2E | 未明确提到接口，用浏览器验收 |
|
|
98
106
|
| "点提交试试能不能成功" / "帮我把下单流程走一遍" / "走一遍流程" / "验证一下这个功能" | E2E | 用户明确要求功能 / 交互验证 |
|
|
99
|
-
| "测试一下这个接口的返回值对不对" / "调一下后端 API 看看响应" | `
|
|
107
|
+
| "测试一下这个接口的返回值对不对" / "调一下后端 API 看看响应" | `{{apiTestChannel}}` | 明确指定接口验证 |
|
|
100
108
|
|
|
101
109
|
## 派遣 E2E 时的 prompt / 用例规范
|
|
102
110
|
|
|
@@ -206,7 +214,7 @@ UI 快照「看起来正常」是最大假阴来源——接口 500、图片 404
|
|
|
206
214
|
| 图片 / 静态资源 404 | 无障碍快照有 `image` 节点就判过 | 404 的 `<img>` 仍是 image 节点——**必须查 network 该资源非 404，或截图确认像素真渲染** |
|
|
207
215
|
| 失败 toast / 空结果 / 错误兜底 | 没撞见失败 toast 就判过 | 空结果 / 错误兜底 UI / 白屏是**常驻态**，出现即判 failed；失败 toast 瞬时易漏，**撞见可判挂、漏看≠通过**——失败的权威判据是上一行的 network 响应码（非 2xx 即 failed） |
|
|
208
216
|
|
|
209
|
-
**核心动作必须真正触发到终态**：验证某功能 = 实际点击触发按钮（提交 / 生成 /
|
|
217
|
+
**核心动作必须真正触发到终态**：验证某功能 = 实际点击触发按钮（提交 / 生成 / 翻译）并等待结果；只验「表单能填 / 按钮存在 / 弹窗打开」就判过 = 根本没测到该功能，必然漏报。
|
|
210
218
|
|
|
211
219
|
### 禁止编写工具能力外的 Case（否则只会产生「假失败」）
|
|
212
220
|
|
|
@@ -289,10 +297,10 @@ E2E 派遣是**昂贵操作**（每次消耗大量 token + 时间）。E2E agent
|
|
|
289
297
|
|
|
290
298
|
| 错误 | 正确做法 |
|
|
291
299
|
| ------------------------------------- | ------------------------------------- |
|
|
292
|
-
| 用户说"测一下"就调 `
|
|
293
|
-
| E2E 完成后又调 `
|
|
300
|
+
| 用户说"测一下"就调 `{{apiTestChannel}}` | 默认派遣 E2E（打开浏览器操作） |
|
|
301
|
+
| E2E 完成后又调 `{{apiTestChannel}}` 补充验证 | 浏览器操作结果即为最终结果，不追加 |
|
|
294
302
|
| 用户说"看看有没有 bug"就同时调两个 | 只派遣 E2E |
|
|
295
|
-
| 用户说"检查接口"时派遣 E2E | 明确提到接口时用 `
|
|
303
|
+
| 用户说"检查接口"时派遣 E2E | 明确提到接口时用 `{{apiTestChannel}}` |
|
|
296
304
|
| 达到停止条件（≥3 轮 / 同一错误未改代码连续失败）仍继续派 E2E | 停止派遣，转为根因分析（读代码 / 查日志） |
|
|
297
305
|
| 复测时全量重测 / 白屏直接再派一轮 | 只传 failed + 未完成的 Case；白屏先重启 devServer 再复测 |
|
|
298
306
|
{% endif -%}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lark-apaas/coding-miaoda-sandbox-skills",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.46",
|
|
4
4
|
"description": "Miaoda 合并沙箱 skills 包（包含原 miaoda-skills 的 miaoda / miaoda-modern / miaoda-design / shared 四条业务线）；发布公网 npm，随沙箱运行时经 update-skills 同步到 .agent/skills/",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|