用途:该技能用于按项目规范编写 Zsh 脚本,并为其编写 ShellSpec BDD 测试,适合创建新脚本或补充测试。
主要能力与规范:脚本以 #!/bin/zsh 开头,包含 GPL-3.0-or-later 版权头与脚本说明。编码规范要求:使用颜色码 RED(错误)、YELLOW(警告)、GRAY(信息)、RESET;失败时返回非零退出码;错误写入 stderr(>&2);快速失败,先校验输入与依赖。函数按工具函数、内容处理函数、主执行函数、参数处理(getopts 或位置参数)分区组织。脚本处理 $(pwd) 中的文件而非脚本所在目录,使用相对文件模式以支持通过 PATH 跨目录执行。API 集成需限流,仅通过环境变量认证(不得硬编码),默认仅安全 GET 操作。临时文件用 mktemp 创建并通过 trap "rm -f $TMPFILE" EXIT INT TERM 清理。安全方面尽量原子操作、处理前校验参数、给出清晰错误与建议、优先快速失败。
测试:使用 ShellSpec,目标覆盖率 85% 以上。常用命令:shellspec(全部测试)、shellspec spec/script_name_spec.sh(单个测试)、shellspec --kcov(覆盖率)、shellspec --format documentation(详细输出)。关键规则:必须使用 When run script "$SHELLSPEC_PROJECT_ROOT/script_name.zsh" 才能测量覆盖率,使用 When run zsh ... 则不会测量。
限制:资料未提供安装方式、平台支持范围、收费信息及具体使用步骤,暂未提供。