@miniidealab/openlogos 0.9.4 → 0.9.6

package/skills/test-writer/SKILL.md

@@ -114,13 +114,24 @@
 
 | 字段 | 说明 |
 |------|------|
-| ID | `ST-{场景编号}-{序号}`，如 `ST-S01-01` |
+| ID | `ST-{场景编号}-{序号}`，如 `ST-S01-01`；无法自动化的用例加 `[manual]` 后缀，如 `ST-S01-05 [manual]` |
 | 描述 | 测试什么场景流程 |
 | 覆盖 Steps | 覆盖时序图的哪些 Step（如 `Step 1→6`）或哪个 EX（如 `EX-2.1`） |
 | 前置条件 | 测试前需要的状态和数据 |
 | 操作序列 | 按 Step 顺序的操作列表 |
 | 预期结果 | 最终状态（返回值 + 数据库状态 + 副作用） |
 
+#### 3c: `[manual]` 标记规则
+
+以下类型的 ST 用例**必须**在 ID 后追加 `[manual]` 标记，`openlogos verify` 会将其从覆盖率计算中排除，不计入 `defined_count`，不出现在 `uncovered_cases`：
+
+- 需要真实 TTY / PTY 渲染（如 CLI 交互式提示、颜色输出、光标控制、进度条）
+- 需要跨窗口或多进程协作（如打开新终端窗口、进程间通信）
+- 需要人工视觉验证（截图对比、UI 渲染效果、字体/颜色感知）
+- 依赖外部硬件或不可模拟的环境（摄像头、蓝牙、特定操作系统 GUI）
+
+**判断标准**：如果该用例在 CI 无头环境中无法稳定运行并自动断言结果，就应加 `[manual]`。
+
 ### Step 4: 覆盖度校验
 
 反向校验测试用例是否覆盖了所有关键约束：
@@ -198,6 +209,15 @@
 |----|------|--------|---------|---------|---------|
 | ST-S01-02 | ... | EX-2.1 | ... | ... | ... |
 
+### 2.3 人工验证用例（[manual]）
+
+> 以下用例需要真实 TTY/PTY 渲染或人工视觉验证，无法在 CI 中自动断言，标记为 [manual]。
+> `openlogos verify` 不会将其计入覆盖率，也不会报告为未覆盖。
+
+| ID | 描述 | 覆盖 Steps | 验证方式 |
+|----|------|-----------|---------|
+| ST-S01-05 [manual] | 交互式提示颜色和光标渲染正确 | Step 2 | 人工在真实终端观察 |
+
 ## 三、覆盖度校验
 
 - [x] Phase 1 正常验收条件：全部覆盖

package/spec/cli-json-output.md

@@ -222,9 +222,10 @@ openlogos verify --format json  # JSON 格式
 ```jsonc
 {
   "summary": {
-    "defined_count": 10,          // 定义的测试用例总数
+    "defined_count": 10,          // 定义的测试用例总数（不含 [manual] 用例）
     "ut_count": 6,                // 单元测试用例数
     "st_count": 4,                // 场景测试用例数
+    "manual_count": 2,            // 标记为 [manual] 的用例数（已从 defined_count 中排除）
     "executed_count": 10,         // 已执行的测试用例数
     "passed_count": 8,            // 通过数
     "failed_count": 1,            // 失败数

package/spec/test-results.md

@@ -67,6 +67,22 @@ logos/resources/verify/test-results.jsonl
 - `error` 在 `status=fail` 时必须提供，其他状态可省略
 - 同一个 `id` 如果出现多次（如重试），`openlogos verify` 取**最后一次**的结果
 
+### `[manual]` 标记用例
+
+在 `test-cases.md` 中，无法自动化执行的用例（如需要真实 TTY/PTY 渲染、跨窗口操作、人工视觉验证的 ST 用例）应在 ID 后追加 `[manual]` 标记：
+
+```markdown
+| ST-S01-05 [manual] | 需要真实 PTY 渲染的交互测试 | ... |
+```
+
+`[manual]` 用例的行为规则：
+
+- **不写入 JSONL**：`[manual]` 用例不由自动化测试执行，不产出 JSONL 记录
+- **不计入 `defined_count`**：`openlogos verify` 扫描 test-cases.md 时跳过这类用例，不计入覆盖率分母
+- **不出现在 `uncovered_cases`**：不会因为缺少运行结果而报告为未覆盖
+- **单独计入 `manual_count`**：在 summary 中以独立字段展示，方便感知人工用例数量
+- **AC trace 中标记为 `MANUAL_PENDING`**：若某个验收条件（AC）关联的用例全部为 `[manual]`，该 AC 标记为 `🔵 MANUAL`（人工待验），不触发 Gate 3.5 失败
+
 ## 运行约定
 
 ### 清空策略