SuperAPI AI 工具集

regex-mastery

编程与开发

查看项目

更新于 10-26 16:17

技能介绍

用途

Regex Mastery 是一个用于处理正则表达式相关工作的技能,主要覆盖编写正则表达式、调试模式匹配、优化正则性能以及实现文本验证等任务。当用户要求编写或解释正则、验证输入格式(邮箱、URL、电话、日期、信用卡等)、从结构化或半结构化文本(日志、CSV、HTML)提取数据、使用前瞻/后顾/命名分组/捕获组/反向引用等术语、调试不符合预期的模式、询问正则标志(i、g、m、s、u、x)、或需要用捕获组与反向引用替换文本时触发。资料明确列出不适用场景:完整 HTML/XML 解析(应使用 DOMParser、BeautifulSoup 等解析器)以及复杂自然语言处理(更适合机器学习模型)。

主要能力

技能围绕若干核心原则展开:可读性优先于取巧,建议将复杂模式拆分为带注释的步骤或在支持时使用 verbose(x)标志;优先使用命名捕获组(如 (?<year>\d{4})),因其自文档化且不受分组顺序变化影响;强调反复测试边界情况,包括空字符串、Unicode 字符、超长输入、接近合法但格式错误的输入以及可能触发回溯的对抗性输入;避免灾难性回溯,提示嵌套量词(如 (a+)+)与重叠分支(如 (a|ab)+)在非匹配输入上会导致指数级回溯,可使用原子组、占有量词或在可用时重构分支使其互斥;并建议在正则超过约 80 个字符或嵌套超过 2 层时,考虑改用小型状态机或解析器。

核心概念部分覆盖贪婪与懒惰量词(*、+、?、{n,m} 默认贪婪,加 ? 变为懒惰)、回溯引擎(NFA 引擎在失败时回退,成本可能指数级;POSIX DFA 引擎不回溯但缺少前瞻与反向引用)、字符类与简写类(\d、\w、\s 及其否定形式,. 默认不匹配换行)、锚点(^、$、\b、\A、\Z)、分组与分支(捕获组、非捕获组 (?:...)、命名组、分支从左到右短路,应把最常见或最具体的分支放在前面),以及反向引用(\1 或 \k<name>)。

使用方式

资料以代码示例展示常见任务:基础邮箱校验使用 /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$/,并提醒安全敏感代码中不应仅靠正则作为权威邮箱验证,应发送确认链接;URL 校验示例给出正则,但建议在 JS/Node.js 中优先使用原生 URL 构造函数;E.164 电话格式使用 /^+[1-9]\d{6,14}$/,北美号码给出带灵活格式的表达式;使用命名捕获组解析日志行,通过 match.groups 解构 timestamp、level、message;使用正/负前瞻与正/负后顾实现密码含数字、排除特定后缀、提取 $ 后价格、排除前缀等;使用 $1 或 $<name> 在替换字符串中插入捕获文本,示例包括日期格式转换与为 @提及 添加链接;解析访问日志时使用带 g 标志的 matchAll 循环迭代;Unicode 处理需在 JavaScript 中使用 u 标志,v 标志(ES2024)增加集合记法与字符串属性,示例包括匹配 Unicode 字母、Emoji 与西里尔字母。

技能在对话中首次激活时,会运行 ls 命令检查已安装的 companion 技能,与文件 frontmatter 中的 recommended_skills 字段比对,对缺失项提示一次并提供安装命令:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>;若 recommended_skills 为空或全部已安装则跳过。另提供 references/common-patterns.md,包含 20 多个生产可用模式(邮箱、URL、电话、日期、IP、UUID、密码、slug、semver、信用卡等),建议仅在需要特定模式时加载以节省上下文。

适用场景

适用于输入格式验证、日志解析、结构化/半结构化文本数据提取、搜索替换与分词等任务;也可用于调试不匹配的模式、评估正则性能问题以及处理含 Unicode 的用户输入。

限制

资料明确不适用于完整 HTML/XML 解析与复杂自然语言处理。部分特性存在环境限制,例如后顾((?<=...) 与 (?<!...))在 V8(Node.js/Chrome)、.NET 与 Python 3.1+ 中受支持,但在 Safari 16.4 之前或较旧 PCRE 中不受支持,使用前需检查目标环境。常见错误包括未锚定的验证模式会静默通过非法输入、在维护代码中使用编号分组、误用 . 表示任意字符、在模式中间使用贪婪 .*、在循环内重建正则、用正则解析 HTML/XML 等,资料均给出了替代做法。此外,技能要求激活后首条回复以 🧢 表情开头。资料未提供该技能的收费、价格、平台或效果数据。