Skip to main content Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/zhaoyifei100-crypto/ic_psd_flow --skill simple-test-runnerLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Métiers associés SOC
Basé sur la classification professionnelle SOC
Explorateur de fichiers
2 fichiers name simple-test-runner description 芯片PSD3测试执行器，由Agent主导PSD3测试的执行，提供库函数索引 license MIT compatibility opencode metadata {"author":"yfzhao","version":"1.0.0"}
Simple Test Runner Skill
描述
轻量级测试执行器。本 Skill 仅提供基础功能，代码生成由 AGENT 直接完成 。
设计理念
极简 : 只保留最必要的功能（扫描库、执行测试）Agent 原生 : 代码生成、规格解析全部由 AGENT 直接完成动态发现 : 自动扫描库构建索引，供 AGENT 参考
使用方法
第一步：生成库索引
python runner.py <testspec.md> --dry-run
这会：
复制整个 ic_psd3/library/ 到测试目录 （环境快照）扫描本地 library 构建函数索引，生成 library_index.json
扫描 ic_psd3/src/lab_instruments/instruments/ 下的所有驱动 ，生成 instruments.jsonAGENT 现在可以基于索引生成代码
环境隔离 ：每个测试都有自己的 library 快照，顶层文件的修改不会影响已通过的测试。
第二步：AGENT 生成代码
AGENT 读取
testspec.md
library_index.json
test_script.py
第三步：执行测试 python runner.py <testspec.md>
执行已生成的 test_script.py，显示里程碑和最终结果。
完整示例
python runner.py ic_psd3/tests/specs/phy/usb3_prbs.md --dry-run
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，确保已通过测试不受顶层修改影响
如需重新同步库，删除 library/ 目录后重新运行 --dry-run
参数说明 python runner.py <testspec.md> [选项]
选项:
--output-dir <dir > 输出目录 (默认: ic_psd3/tests/generated/<test_name>)
--library-dir <dir > 库目录 (默认: ic_psd3/library)
--dry-run 仅生成索引，不执行
实现
scan_library() - 扫描库并构建索引scan_instruments() - 扫描仪器驱动并构建索引extract_instrument_class() - 提取驱动类信息和初始化参数execute_test() - 执行测试脚本，捕获输出main() - CLI 入口点
解析 testspec.md
使用 library_index.json 了解可用芯片库函数
使用 instruments.json 了解可用硬件驱动
直接生成 test_script.py（带 MILESTONE 打印）
调用 runner.py 执行测试
工作流程 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
→ 显示里程碑和结果
TestSpec 格式示例 # 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，因此直接导入即可：
import sys
import time
import json
from pathlib import Path
from datetime import datetime
from library.usb_common_class import USBCommonClass
from library.aves_class import AVESChipConfig
from library.psd3_common_class import PSD3CommonClass
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_bridge
注意事项
检查 python环境是否正确，是否已经安装hw_bridgelibrary_index.json 位于每个测试的输出目录中
扫描本地 library[usb_common_class.py, psd3_common_class.py, aves_class.py, reg_define.py]
代码生成完全由 AGENT 完成，本 Skill 只负责执行
所有生成文件使用覆盖模式
常见踩坑 ⚠️
1. 类名混淆 错误用法 正确类名 文件 AvesClassAVESChipConfigaves_class.py USBCommonClass() 无参初始化USBCommonClass(device)usb_common_class.py
grep "^class " ic_psd3/library/*.py
2. DeviceManager API 错误 错误 正确 说明 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()
3. 类初始化方式错误 问题 : USBCommonClass 不是无参初始化的。
usb_class = usb_common.USBCommonClass()
usb_class.set_device_manager(device_manager, "dut" )
usb_obj = usb_common.USBCommonClass(dut)
4. 直接寄存器访问 vs 类方法 问题 : USBCommonClass 没有 write_reg() 方法，应通过设备对象访问。
usb_obj.write_reg(CDR_UP_ADDR, 0x9E , 0x0F )
dut.write_reg(CDR_UP_ADDR, 0x9E , 0x0F )
5. 模拟设备 vs 真实硬件驱动 问题 : 在非Windows系统运行，FTDI驱动不可用。
AttributeError: module 'ctypes' has no attribute 'windll'
TEST_CONFIG = {
"dut_type" : "mock" ,
...
}
mock - 仿真设备，返回默认值（推荐用于开发）ftdi - 真实FTDI硬件（仅Windows + FTDI驱动）pi - Raspberry Pi I2C（仅Pi系统）
6. 缺失的作用域变量 问题 : 在 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()
7. 库函数索引理解不完全 问题 : 生成的 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 ]
