SuperAPI AI 工具集

module-dev

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:module-dev 用于对指定 DSP 模块($ARGUMENTS)执行自动化质量检查与修复循环,直到模块通过或达到 5 次迭代。

主要能力与流程:Step 1 通过 Task 工具调用 subagent_type "module-dev:verifier" 验证模块并返回指标与判定;Step 2 若 PASS 即结束,若 NEEDS_WORK/CRITICAL_ISSUES 则继续;Step 3 调用 "module-dev:judge" 评估验证结果并生成修复指令;Step 4 可自行简单修复(编辑 test_config.json 或 .dsp 文件),或调用 "module-dev:dev" 处理复杂修复;Step 5 回到 Step 1 循环。

auto 模式:命令为 /module-dev ModuleName --auto。流程为 Verifier 检测问题、Judge 将问题分类为可自动修复或需人工处理、AutoFixer 套用模板修复、修复后重新验证;若 3 次自动修复后仍失败则请求人工介入。AutoFixer 支持的模板包括 add_limiter(在输出前加 ma.tanh 软限幅)、reduce_gain(默认输出增益乘 0.7)、add_dc_blocker(加 fi.dcblocker)、smooth_gate(对门参数加 si.smooth(0.995))、adjust_threshold(提高 THD/削波阈值)。手动应用命令示例:just agent-fix-preview ModuleName add_limiter 预览,just agent-fix-apply ModuleName add_limiter 应用。

常用命令:just build 构建插件;just validate-modules $ARGUMENTS 运行模块测试;just validate-audio $ARGUMENTS 检查音质(THD、削波);just test-ai-clap $ARGUMENTS 做 CLAP 嵌入分析;just validate $ARGUMENTS 运行完整验证套件;just analyze-ranges $ARGUMENTS 做参数范围分析;just install 安装到 VCV Rack。CI 门禁可用 just validate-ci(全部模块)或 just validate-ci-module ModuleName(单模块),无需 API key,阈值定义在 test/ci_config.json。

通过阈值:构建必须成功无错误;削波 <5%(或在 test_config.json 中按模块定义);质量分 >=70;THD <15%(失真效果可更高);HNR >0 dB。

关键文件:DSP 源码 src/modules/$ARGUMENTS/{lowercase}.dsp;测试配置 src/modules/$ARGUMENTS/test_config.json;C++ 包装 src/modules/$ARGUMENTS/$ARGUMENTS.cpp。

限制:资料未说明安装方式、收费、平台与效果保证;需具备 VCV Rack、just 与子代理环境。