文本转换工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-rn88lg3j/toolkit。
技能介绍
解决什么问题
日常开发中充斥着大量琐碎但高频的文本任务:把数据库字段风格转成前端需要的命名约定、临时做一次 Base64 或 URL 编解码、把同事贴过来的一段挤成一行的 JSON 或 SQL 格式化、统计一下文案的字数和可读性。这些需求单看都不复杂,但分散在各个项目里手写脚本,维护成本会不断累积,而且每次规则稍有变化就要重新实现一遍。
技能如何工作
这个技能以 MCP 服务器的形式提供了 40 多个文本处理工具,覆盖以下几类场景:
- 命名转换:
case_to_camel、case_to_pascal、case_to_snake、case_to_kebab等 12 种风格,可选分隔符、locale 和模糊字符合并 - 编解码:
encode_base64、decode_url、encode_html等双向转换工具 - 格式化:
format_json、format_xml、format_sql、format_html,缩进深度可配置 - 统计与分析:
count_characters、count_words、count_lines、analyze_readability - 字符串操作:
string_trim、string_substring、string_replace、string_split、string_join - 正则工具:
regex_test、regex_replace、regex_extract、regex_split - 哈希生成:
generate_md5、generate_sha1、generate_sha256、generate_sha512、generate_hmac - 其他工具:
generate_uuid、validate_uuid、generate_lorem_ipsum
大模型在这里扮演路由层的角色:理解用户意图、从工具列表里选出对应的函数、提取参数,然后用关键字参数调用 scripts.tools 里的函数。代码本身不参与意图判断,只负责调用 API 并返回结果。
使用时有严格的密钥管理流程:首次运行如果 scripts.config.settings.api_key 为空,必须通过 AskUserQuestion 向用户询问 XBY_APIKEY,拿到密钥后调用 scripts.config.set_api_key(api_key) 保存,然后才能继续处理后续请求。如果参数不完整,同样需要先向用户补齐缺失的参数再执行。
适用边界与注意点
- API 密钥是强制前提,没有密钥时禁止自行搜索或编造数据,这是硬性规则
- 适合中小规模文本的处理;如果面对的是几十兆的日志或数据文件,走 API 可能带来明显延迟,直接用本地脚本更合适
- 哈希工具适用于完整性校验、缓存键生成这类场景,不应被当作安全加密手段使用
- 正则工具的规则语法取决于后端 API 的实现,复杂的 PCRE 特性可能不被支持
使用场景
- 后端写接口文档时,需要把数据库 snake_case 字段批量转成前端约定的 camelCase 命名
- 排查前端 bug 时,要把后端返回的一串 URL 编码参数解码还原成可读字符串
- 合并多文件 SQL 时,需要把缩进混乱的语句统一格式化为可读的 2 空格缩进风格
- 提交代码前,需要计算配置文件的 SHA-256 校验和以确认文件在传输中未被篡改
适合人员
- 后端工程师,需要在不同语言的项目之间统一变量命名风格
- 前端工程师,需要在联调时快速解码后端传来的参数字符串
- 数据分析师,需要把原始 SQL 语句格式化后贴进报表或文档中
- 测试工程师,需要校验文件完整性或从日志中提取结构化字段