SuperAPI AI 工具集

mir-update-snippet

通用与其它

查看项目

更新于 10-16 08:33

技能介绍

用途:对既有的 mir snippet 按质量检查清单进行最新化与改进,触发场景包括用户提出「想改善 snippet」「想最新化」「想提升质量」「想维护 snippet」。

主要流程:先用 npx mir info <name> 确认目标 snippet;再用 npx mir sync <name> 同步变量定义;随后逐项核对检查清单并修正问题;修改后再次执行 mir sync 同步变量,并重新做安装测试确认无问题。

检查清单要点:variable 需设置合适的 schema(type、default、enum)、description、suggests;snippet.yaml 需正确设置 description、tags、version;snippet 定义 YAML 需写维护用注释(参考文件路径、设计意图与经过);生成的代码需可直接运行;需在临时目录安装验证,命令为 npx mir install <name> --out-dir=/tmp/mir-test-<name>,具体验证方式(构建、测试等)需询问用户;依赖需显式声明;需保证单独使用也不报错;不得存在未使用的变量定义;应善用模板辅助函数(camelCase、pascalCase、kebabCase 等)从一个变量展开多种命名规则;文件名也应使用模板变量以动态控制生成位置;hooks 的 before-install 用于显示前提条件确认与说明,after-install 用于提示后续步骤(如请执行 npm install);模板文件内不得包含路径穿越(..);snippet.yaml 的 name 字段需与文件名一致。

限制与注意事项:修改前需向用户报告当前状态并取得批准后再变更;hooks 仅在 snippet 用途需要时设置,并非所有 snippet 都必须。资料未提供该技能的收费、价格、支持平台与效果等信息。