Menu
芯片PSD3测试执行器，由Agent主导PSD3测试的执行，提供库函数索引
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/zhaoyifei100-crypto/ic_psd_flow --skill simple-test-runnerThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | simple-test-runner |
| description | 芯片PSD3测试执行器，由Agent主导PSD3测试的执行，提供库函数索引 |
| license | MIT |
| compatibility | opencode |
| metadata | {"author":"yfzhao","version":"1.0.0"} |
轻量级测试执行器。本 Skill 仅提供基础功能，代码生成由 AGENT 直接完成。
python runner.py <testspec.md> --dry-run
这会：
ic_psd3/library/ 到测试目录（环境快照）library_index.jsonic_psd3/src/lab_instruments/instruments/ 下的所有驱动，生成 instruments.json环境隔离：每个测试都有自己的 library 快照，顶层文件的修改不会影响已通过的测试。
AGENT 读取 + ，直接生成 。
testspec.mdlibrary_index.jsontest_script.pypython runner.py <testspec.md>
执行已生成的 test_script.py，显示里程碑和最终结果。
# 1. 生成索引（AGENT 准备阶段）
python runner.py ic_psd3/tests/specs/phy/usb3_prbs.md --dry-run
# 2. AGENT 生成代码（AGENT 自动完成）
# AGENT 读取 testspec.md 和 library_index.json
# AGENT 生成 test_script.py
# 3. 执行测试
python runner.py ic_psd3/tests/specs/phy/usb3_prbs.md
ic_psd3/tests/generated/<test_name>/
├── library/ # 库环境快照（dry-run 时复制）
│ ├── usb_common_class.py
│ ├── psd3_common_class.py
│ ├── aves_class.py
│ └── reg_define.py
├── library_index.json # 库函数索引（AGENT 参考）
├── instruments.json # 仪器驱动索引（AGENT 参考）
├── test_script.py # AGENT 生成的可执行代码
├── exec.log # 详细执行日志
└── summary.json # 结构化结果
仪器驱动发现：
--dry-run 时自动扫描 ic_psd3/src/lab_instruments/instruments/ 目录instruments.json 供 AGENT 参考tt5166_tcp_ctr.py → TemperatureController 类的详细信息环境隔离设计：
--dry-run 阶段会复制整个 ic_psd3/library/ 到测试目录library/ 目录后重新运行 --dry-runpython runner.py <testspec.md> [选项]
选项:
--output-dir <dir> 输出目录 (默认: ic_psd3/tests/generated/<test_name>)
--library-dir <dir> 库目录 (默认: ic_psd3/library)
--dry-run 仅生成索引，不执行
单个文件: runner.py（约 280 行）
核心功能:
scan_library() - 扫描库并构建索引scan_instruments() - 扫描仪器驱动并构建索引extract_instrument_class() - 提取驱动类信息和初始化参数execute_test() - 执行测试脚本，捕获输出main() - CLI 入口点AGENT 职责:
Designer: /run-test testspec.md
Agent:
1. 调用 runner.py --dry-run
→ 生成 library_index.json
→ 生成 instruments.json
2. AGENT 直接生成代码
→ 读取 testspec.md
→ 读取 library_index.json（了解可用函数）
→ 读取 instruments.json（了解硬件驱动）
→ 生成 test_script.py（带里程碑打印）
3. **告知**designer代码已经生成，需要修改（如有）
**提示**designer检查TODO
**等待**designer确认代码无误
4. 调用 runner.py（无 --dry-run）
→ 执行 test_script.py
→ 显示里程碑和结果
# PHY USB3 PRBS 测试
## 设备
- dut: GSU1K1 (i2c_port: 0, chip_addr: 0x58, type: ftdi)
- chamber: TemperatureController (ip: 192.168.6.211, port: 3000)
## 参数
- temperatures: [25, 85, 125]
- soak_time: 600
- prbs_duration: 5
## 测试流程
1. 复位芯片并上电
2. 初始化 PLL（无 SSC）
3. FOR temperature IN temperatures:
- 设置温箱温度为 {temperature}°C
- 等待 {soak_time} 秒
- 初始化 USB3 PRBS 模式
- 检查 PRBS {prbs_duration} 秒
测试脚本位于 ic_psd3/tests/generated/<test_name>/ 目录，Python 会自动将该目录加入 sys.path，因此直接导入即可：
#!/usr/bin/env python3
# 标准库
import sys
import time
import json
from pathlib import Path
from datetime import datetime
# 本地 library 模块（runner 在 dry-run 时已复制到测试目录）
from library.usb_common_class import USBCommonClass
from library.aves_class import AVESChipConfig
from library.psd3_common_class import PSD3CommonClass
# pip 安装的包
from hw_bridge import DeviceManager
重要说明：
sys.path，当前目录已自动在 path 中library/ 是 dry-run 阶段复制的本地快照，确保环境隔离hw_bridge 分两种情况，Linux下通过 pip install -e ic_psd3/src/hw_bridge 安装到 venv
Windows下检查pip里有没有hw_bridge，如没有提示用户手动用pip安装hw_bridgehw_bridge问题: 库中的类名与预期不符。
| 错误用法 | 正确类名 | 文件 |
|---|---|---|
AvesClass | AVESChipConfig | aves_class.py |
USBCommonClass() 无参初始化 | USBCommonClass(device) | usb_common_class.py |
排查方法:
grep "^class " ic_psd3/library/*.py
问题: 使用了不存在的方法。
| 错误 | 正确 | 说明 |
|---|---|---|
device_manager.create_device() | device_manager.register() | 应使用 register 方法 |
DeviceManager() | DeviceManager(auto_open=True) | 需指定参数以正确初始化 |
正确用法:
dm = DeviceManager(auto_open=True)
dut = dm.register(name="dut", driver_type="mock", i2c_port=0, chip_addr=0x58)
dm.close_all() # 清理
问题: USBCommonClass 不是无参初始化的。
❌ 错误:
usb_class = usb_common.USBCommonClass()
usb_class.set_device_manager(device_manager, "dut")
✓ 正确:
usb_obj = usb_common.USBCommonClass(dut) # 直接传设备对象
问题: USBCommonClass 没有 write_reg() 方法，应通过设备对象访问。
❌ 错误:
usb_obj.write_reg(CDR_UP_ADDR, 0x9E, 0x0F)
✓ 正确:
dut.write_reg(CDR_UP_ADDR, 0x9E, 0x0F) # 通过设备对象
问题: 在非Windows系统运行，FTDI驱动不可用。
症状:
AttributeError: module 'ctypes' has no attribute 'windll'
解决方案:
# 开发/演示阶段使用 mock 驱动
TEST_CONFIG = {
"dut_type": "mock", # ✓ 支持：mock, ftdi (Windows), pi
...
}
可用驱动:
mock - 仿真设备，返回默认值（推荐用于开发）ftdi - 真实FTDI硬件（仅Windows + FTDI驱动）pi - Raspberry Pi I2C（仅Pi系统）问题: 在 try 块中初始化的变量在 finally 块中使用。
❌ 错误:
try:
device_manager = DeviceManager()
# ...
finally:
device_manager.close_all() # 如果初始化失败，变量不存在
✓ 正确:
device_manager = None
try:
device_manager = DeviceManager()
# ...
finally:
if device_manager:
device_manager.close_all()
问题: 生成的 library_index.json 中函数签名需要仔细解读。
关键字段:
args - 完整的函数参数（包括类型提示）docstring - 文档字符串（说明参数含义）methods - 该类的所有方法使用示例:
# 库索引中看到:
"check_usb3_prbs_with_break": {
"args": "self, pipe_addr: int, mins: int, unit: int",
"docstring": "Check USB3.0 PRBS with break on error.\n\nReturns:\n List: [error_count, check_result]"
}
# 应该这样调用:
prbs_result = usb_obj.check_usb3_prbs_with_break(
pipe_addr=0x31,
mins=5,
unit=1
)
error_count = prbs_result[0] # 返回值是列表，第一个元素是错误计数