Skip to content

thun-res/vlink / .agents/skills/test

按 Linux、macOS 或 Windows 的仓库测试链路配置并构建普通 vlink-test、C API 与 Python 绑定,运行完整 CTest、绑定测试或指定 suite/case 并汇总失败。用户要求"跑 test"、"执行单元测试"、 "测试 c_api/python_api"、"只测某个 suite/case"、"验证测试是否通过" 或排查非 ASan 的 ci-test 失败时使用。

references/FAILURE-DIAGNOSIS.md

View on GitHub
# 测试失败诊断

## 失败分层

按首个失败阶段定位,不要跳过前置失败:

1. **配置失败**:记录 CMake 错误、生成器、平台和关键开关;不使用旧产物。
2. **构建失败**:记录首个编译或链接错误及目标;后续测试结果无效。
3. **Proxy 失败**:检查平台 runner 指向的可执行文件和日志,确认进程是
   缺失、启动失败还是提前退出。
4. **CTest 失败**:记录失败 suite、失败断言、超时或崩溃信号,区分稳定
   失败与外部服务缺失。
5. **绑定测试失败**:区分 `vlink-c-test`、Python 基础/完整/覆盖测试,
   记录脚本、断言、实际类型或值及动态库/Python 模块搜索路径。

## 复现原则

- 先用原命令复现首个失败,不要靠并行重跑掩盖问题。
- 需要缩小范围时使用 [TARGETED-TEST.md](TARGETED-TEST.md),并保留原
  全量失败结论。
- 不扩大排除正则、不放宽 Windows 容忍数、不删除断言,也不把重跑偶然
  通过写成已经修复。
- 失败依赖环境或外部服务时,明确列出缺失条件和未执行范围。

## 结果摘要

至少报告:

- 平台、构建目录和测试方式;
- 全量或定向范围、匹配数量、通过/失败/跳过数量;
- 首个有效错误和失败日志位置;
- 是否启动 Proxy、是否排除外部后端;
- C API 测试与三组 Python 绑定测试的逐项结果;
- 未执行的构建、平台或测试范围。
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall