SuperAPI AI 工具集

windows-compatibility

部署与运维

查看项目

更新于 10-15 21:12

技能介绍

用途:该技能面向在 Windows、macOS、Linux 上运行的跨平台项目,解决因平台差异引发的缺陷,例如文件名中的冒号、Windows 路径下的 git -C、Node.js 中的正斜杠路径等。

主要能力与规则: 文件名与时间戳:文件名中禁止使用冒号,ISO 8601 格式 2026-03-15T05:30:00Z 在 Windows 上非法;应使用 safeTimestamp() 工具将冒号替换为连字符,得到 2026-03-15T05-30-00Z;格式化逻辑应集中到工具中,不要内联 .toISOString().replace(/:/g, '-')。 Git 命令:不要使用 git -C {path},它在 Windows 路径(反斜杠、空格、盘符)下不可靠;应先 cd 切换目录再执行 git 命令;提交前用 git diff --cached --quiet 检查(退出码 0 表示无变更)。 提交信息:不要在 -m 参数中嵌入换行,反引号 n(\n)在 PowerShell 中会静默失败;应写入临时文件并用 git commit -F $msgFile 提交。 路径:不要假设当前工作目录是仓库根目录,应使用 spawn 提示中的 TEAM ROOT 或运行 git rev-parse --show-toplevel;使用 path.join() 或 path.resolve(),不要手动用 / 或 \ 拼接。

使用方式:在编写涉及文件名、时间戳、Git 调用和路径拼接的代码时,遵循上述模式;示例中给出了 PowerShell 下的正确 Git 工作流与错误写法对照。

适用场景:跨平台命令行工具、自动化脚本、CI 流程、多平台协作项目。

限制:资料未提供该技能的安装方式、依赖、版本要求或平台支持范围;反模式包括只在单一平台测试、假设 Unix 路径通用、为“看起来更整洁”而使用 git -C、跳过 git diff --cached --quiet 检查导致空提交。