技能 Tech

实用工具

常见操作的原生 shell 配方。先加载此条目,然后仅加载特定工具类别所需的片段。

概述

Utilities 提供用于常见操作的原生 shell 单行命令,这些操作原本需要外部 MCP 服务器依赖。所有配方均使用 macOS 和 Linux 默认提供的工具:bash、python3、openssl、jq。智能体选择适当的配方,而不是调用外部服务。

配方类别

  • 日期与时间 — ISO 日期、epoch 转换、时区转换、日期运算(macOS 和 Linux 变体)
  • 哈希 — 通过 openssl 计算 SHA-256、SHA-512、MD5,文件校验和
  • 随机与 UUID — UUID v4、随机 hex/base64 字符串、加密随机整数
  • Base64 — 编码/解码,附跨平台说明(macOS 使用 -D,Linux 使用 -d)
  • URL 编码 — 通过 Python urllib 编码/解码
  • 文本大小写转换 — camelCase、PascalCase、snake_case、kebab-case、CONSTANT_CASE,以及 CamelCase 到 snake 的转换
  • 校验 — 邮箱、URL、IPv4、UUID 正则校验
  • JSON — 通过 jq 美化打印、压缩、校验、提取字段
  • 密码生成 — 字母数字、含特殊字符、口令短语风格
  • 颜色转换 — hex 转 RGB、RGB 转 hex、hex 转 HSL、HSL 转 hex

片段路由

该技能拆分为 16 个聚焦片段。智能体仅加载所需的片段:datetime、system-info、crypto、encoding、text-transform、validation、json、yaml(仅解析 frontmatter)、formatting、datarim-sync、ga4-admin、ssh-deploy(用于 heredoc 安全远程执行的 base64 模式)、recovery(从压缩的会话上下文中恢复丢失的运行时文件)、keyword-linter(关键词拒绝列表 linter 配方)、git-diff-parsing(从 hunk 上下文中分离出真正的添加和删除)以及 shell-conventions(可移植 shell 辅助工具的 IFS、单词拆分和区域设置规则)。

框架实用工具

包含 Datarim 专用配方:在项目运行时 ${DATARIM_RUNTIME}/ 与 Datarim 仓库之间同步框架文件、GA4 Admin API 设置、通过 base64 编码进行 SSH 部署,以及丢失运行时文件的灾难恢复。

使用时机

当智能体需要实用工具操作时按需加载。该技能可避免不必要的外部依赖,并确保在 macOS 和 Linux 环境中行为一致。