| name | aves-script-builder |
| description | 从 MD 函数定义和 Python 代码自动生成 AVES 寄存器配置脚本 |
| license | MIT |
| compatibility | opencode |
| metadata | {"author":"Agent","version":"2.0.0"} |
功能概述
该 Skill 旨在帮助验证工程师将高层次的函数描述转换为可执行的 AVES 脚本。
它采用 "MD -> Python Template -> Mock Execution -> AVES" 的流转模式，利用 IDE 的自动补全能力减少手动查表。
核心优势：
- 实际执行：使用 MockDriver 实际运行 Python 代码，支持
if/for/while 等复杂逻辑。
- 完整记录：每次
.w() 调用都会生成独立的 B0 行，清晰展示时序。
- 代码注释：生成的 AVES 脚本包含原始 AutoClass 调用作为注释，便于调试。
- IDE 友好：基于 AutoClass 体系，提供寄存器名自动补全。
工作流程
步骤 1：准备输入
用户需要提供一个包含函数名和描述的 Markdown 文件。
例如 func_define.md:
# func_reset_clock
复位所有 clock domain
# func_start_saradc
启动 SARADC
Agent 读到这个文件之后进行解析，提取函数定义并生成 Python 模板。
步骤 2：生成 Python 模板
Agent 调用工具生成模板文件：
python3 ic_psd2/src/aves_generator.py \
--md <YOUR_MD_PATH> \
--template ic_psd2/output/aves_template.py
步骤 3：准备 IDE 补全库（本地）
在用户开始编写逻辑前，Agent 必须在 ic_psd2/output 构建临时 auto_class.py，以便 IDE 提供准确的自动补全，且不影响 ic_psd3/library 的状态。
Agent 调用 ic_psd2/src/generate_local_autoclass.py：
python3 ic_psd2/src/generate_local_autoclass.py <PATH_TO_YOUR_CHIP_XML> ic_psd2/output/auto_class.py
完成后检查 ic_psd2/output/auto_class.py 是否存在。用户在编写逻辑时，IDE 会识别同目录下的库。
Agent搜索要使用的寄存器：
只能使用脚本在*.json/*.XML/*.xlsx里搜索
禁止直接读取所有*.json/*.XML/*.xlsx的内容，会造成用户token消耗量过大
如果Agent不能给出使用的寄存器：
告知用户："本地补全库已准备就绪，请在 IDE 中打开 aves_template.py 并利用 AutoClass 补全功能编写代码。完成后请告诉我。”
如果Agent能给出使用的寄存器：
告知用户："本地补全库已准备就绪，以下是您需要使用的寄存器：\n{REGISTER_LIST}\n
步骤 4：用户编写逻辑
用户在 IDE 中打开 aves_template.py，使用 AutoClass 编写逻辑：
def func_reset_clock():
"""复位所有 clock domain"""
AutoClass.Misc_Inst.i2c_xtal_domain_rst.w(1)
AutoClass.Misc_Inst.i2c_240m_domain_rst.w(1)
AutoClass.Misc_Inst.i2c_xtal_domain_rst.w(0)
AutoClass.Misc_Inst.i2c_240m_domain_rst.w(0)
支持的功能：
- 位操作：
.w(0) 或 .w(1)
- 字节操作：
.w(0xFF)
- 读取操作：
.r()（用于 read-modify-write）
- 复杂逻辑：
if/else、for 循环、变量计算
步骤 5：构建 AVES 脚本
Agent 使用 MockExecutor 实际执行 Python 代码并生成 AVES：
python3 ic_psd2/src/mock_executor.py \
--state ic_psd2/output/xml_state.json \
--py ic_psd2/output/aves_template.py \
--aves ic_psd2/output/generated_aves.txt \
--per-func
生成的 AVES 格式：
:16-01 func_reset_clock:
; AutoClass commands:
; AutoClass.Misc_Inst.i2c_xtal_domain_rst.w(1)
; AutoClass.Misc_Inst.i2c_240m_domain_rst.w(1)
; AutoClass.Misc_Inst.i2c_xtal_domain_rst.w(0)
; AutoClass.Misc_Inst.i2c_240m_domain_rst.w(0)
B0 2000 02;
B0 2000 06;
B0 2000 02;
B0 2000 00;
End
特点：
- 每次
.w() 调用生成一行 B0（不合并）
- 函数前显示所有 AutoClass 命令作为注释
- B0 行以
; 结尾
交互指南
-
询问 MD 路径：
"请提供包含函数定义的 Markdown 文件路径（例如 ic_psd2/output/func.md）"
-
生成模板并准备本地库：
生成模板后，主动执行或询问用户执行 generate_local_autoclass.py，确保输出到 ic_psd2/output/auto_class.py。
告知用户："模板已生成到 ic_psd2/output/aves_template.py，且本地 IDE 补全库已在 ic_psd2/output 准备就绪（不影响 psd3 库）。请在 IDE 中打开并利用 AutoClass 补全功能填写代码。完成后请告诉我。"
-
构建脚本：
接收到用户确认后，执行 mock_executor 并展示生成的 AVES 内容（前几行或全量）。
注意事项
- Mock 执行：使用
mock_executor.py 而非旧的 aves_generator.py，支持完整 Python 语法。
- 不合并写入：每次
.w() 都生成独立的 B0 行，如需延时请在代码中显式控制。
- 虚拟 I2C：MockDriver 维护虚拟 I2C 内存，读取操作会反映之前写入的值。
- 依赖文件：需要
xml_state.json（由 chip_builder 生成）作为默认值来源。
文件说明
ic_psd2/src/aves_generator.py - 仅用于从 MD 生成 Python 模板ic_psd2/src/mock_driver.py - 虚拟 I2C 驱动器，维护内存状态ic_psd2/src/mock_executor.py - 执行 Python 脚本并生成 AVESic_psd2/src/generate_local_autoclass.py - 生成本地 IDE 补全库
