用途:从既有项目代码中新建 mir snippet,把项目内代码抽出为可复用模板。触发场景包括「想把这段代码做成 snippet」「想模板化」「想让代码可复用」。
主要能力与流程:先向用户确认要抽出的代码范围、目标文件或目录、snippet 名称与用途说明;在项目全局范围内查找指定源码,并收集类型定义、测试、配置文件等相关文件;识别项目专属信息,将其变量化或删除,例如把项目名、包名替换为 {{ project-name }} 等变量,把专属路径、URL 变量化,把硬编码配置值变量化并保留原值作 default;确认 .mir/ 的管理方式(团队共享则纳入 git,个人使用则不纳入,并会引导 private-mir skill);执行 npx mir create <name> 创建雏形,将模板文件放到 .mir/snippets/<name>/,用 Handlebars 模板语法替换变量,文件名也可用变量,如 {{ kebabCase name }}.ts;在 .mir/snippets/<name>.yaml 中写变量定义,为每个变量设置 description、schema(type、default、enum)与 suggests,派生值可用模板表达式作 default;可用 helper 包括 lowercase、uppercase、capitalize、uncapitalize、camelCase、pascalCase、snakeCase、kebabCase、dotCase、pathCase、replace、concat、slice、trim、contains、startsWith、endsWith、length;在 YAML 末尾追加维护注释,记录各模板来源文件路径与设计判断;执行 npx mir sync <name> 同步变量定义;用 npx mir install <name> --out-dir=/tmp/mir-test-<name> 到临时目录验证展开结果。
限制与注意:项目专属 import 路径与模块名必须变量化;建议用 helper 自动处理命名转换;需保证生成代码可直接构建运行;snippet 名仅允许英文字母数字与连字符,符合 ^[a-zA-Z0-9][a-zA-Z0-9-]*$。收费、平台支持等信息暂未提供。