regex-wizard

Resolve <skill_dir> to the directory containing this SKILL.md. Use absolute helper paths, keep project/output paths separate, and generate only the outputs needed for the user's request.

根据自然语言描述生成正则表达式，附带铁路图可视化和交互式测试页面。

工作流程

Step 1: 理解意图

分析用户的自然语言描述，确定：

• 需要匹配的文本模式类型
• 是否需要捕获组（提取子串）
• 目标编程语言/环境（Python、JavaScript、Go 等）
• 边界条件和特殊要求（如：仅完整匹配、忽略大小写等）

先查阅下方 常用模式速查表，如果已有现成模式可直接复用或微调。

Step 2: 生成正则表达式

根据分析结果编写正则表达式，遵循以下原则：

1. 正确性优先：先确保匹配所有正例，再排除反例
2. 可读性：合理使用命名捕获组 (?P<name>...) 和注释模式 (?x)
3. 性能：避免灾难性回溯，仅在目标引擎支持时使用占有量词或原子组
4. 兼容性：标注所用语法的引擎兼容性（PCRE / ECMAScript / RE2 等）

输出格式：

正则表达式: <pattern>
引擎兼容:  <PCRE / ECMAScript / RE2 / ...>
标志:      <g/i/m/s/x 及其含义>

Step 3: 可视化 —— 铁路图（按需）

使用 scripts/railroad.py 生成 SVG 铁路图：

python "<skill_dir>/scripts/railroad.py" "<regex_pattern>" -o output.svg

颜色编码：

将生成的 SVG 展示给用户，并逐段解释每个节点的含义。

Step 4: 交互式测试页面（按需）

使用 assets/tester_template.html 模板生成测试页面：

1. 将正则表达式预填入输入框
2. 生成 5 个正例和 5 个反例作为测试用例
3. 输出完整 HTML 文件供用户在浏览器中打开

# 模板已内置实时匹配高亮、捕获组详情、标志切换等功能
# 只需将正则和测试用例填入模板即可

Step 5: 代码片段

为用户目标语言提供代码片段；以下 Python 和 JavaScript 示例按需选用：

Python:

import re

pattern = re.compile(r"<regex>", re.IGNORECASE)
matches = pattern.findall(text)
for m in matches:
    print(m)

JavaScript:

const pattern = /<regex>/gi;
const matches = text.matchAll(pattern);
for (const match of matches) {
  console.log(match[0], match.groups);
}

如用户指定其他语言（Go、Java、Rust 等），额外生成对应片段。

常用模式速查表

注意事项

• 正则表达式引擎之间存在差异，务必标注兼容性
• 避免使用灾难性回溯模式（如 (a+)+）
• 对于复杂匹配需求，建议分步处理而非写一个超长正则
• 中文相关正则注意 Unicode 范围的完整性
• 生成的测试页面仅使用 JavaScript 引擎（ECMAScript），与其他引擎可能存在差异