2026年9月1日

utilities Skill — 无外部依赖的 Shell 配方

utilities skill 如何提供一套原生 shell 单行命令库——从哈希到 SSH 远程执行——并按片段组织,使只有相关代码被加载。

一个为了生成 UUID 或格式化日期而去调用 MCP 服务器的 agent,就像用大锤砸钉子。utilities skill 通过提供一套完全由 macOS 和 Linux 默认可用工具构建的 shell 配方库来解决这个问题:bash、python3、openssl 和 jq。无需外部 MCP 服务器。

该 skill 涵盖十几个以上的实用领域:日期/时间操作、系统信息、加密操作、编码、文本转换、输入验证、JSON 操作、数字和颜色格式化、Datarim 文件同步、Google Analytics 4 Admin API、SSH 远程执行、会话恢复、关键词 linting 以及 git diff 解析。每个领域都位于自己的片段文件中。

片段路由

入口文件刻意保持简短。需要哈希字符串的 agent 加载 crypto.md。需要将日期转换为 epoch 的 agent 加载 datetime.md。解析 git diff 以获取新增和删除行的 agent 加载 git-diff-parsing.md,其中包含用于将真实新增和删除与 hunk 上下文噪声区分开的规范过滤链。当只需要一条单行命令时加载完整的 500 行库会浪费上下文 token——拆分使空闲成本接近于零。

片段包含的内容

crypto.md 片段涵盖 SHA-256、SHA-512 和 MD5 哈希、UUID 生成、随机字符串生成以及密码生成——全部通过 openssl 或 python3 实现。encoding.md 片段提供 Base64 编码和解码以及 URL 编码。text-transform.md 片段处理 camelCase、snake_case、kebab-case、PascalCase 转换,以及从任意字符串生成 slug。

ssh-deploy.md 片段解决了一个具体的实际问题:通过 SSH 在远程服务器上运行脚本而不发生 heredoc 损坏。规范模式在本地将脚本编码为 Base64,传输后在远程端解码——这种技术能够经受住 heredoc 方法经常遇到的引号和转义问题。

恢复与同步

两个片段处理典型开发工作之外的运维场景。recovery.md 提供从压缩后的会话上下文中恢复丢失的运行时文件的配方——这是会话历史被截断时的灾难恢复程序。datarim-sync.md 涵盖在项目运行时(${DATARIM_RUNTIME}/)和 Datarim 仓库之间同步框架文件,无需手动复制即可保持两者一致。

utilities skill 处于大多数 Datarim 工作流的后台。systematic-debugging skill 借助其 shell 配方进行诊断插桩。using-git-worktrees skill 使用同一家族的 git 级 shell 命令。有关更广泛的背景,请参阅 什么是 Datarim。