SuperAPI AI 工具集

claude-skill-bash

编程与开发

查看项目

更新于 10-15 17:25

技能介绍

用途:这是一个面向 Claude 的 Bash 编写规范技能,在创建新 shell 脚本、编辑 .sh/.bash 文件、编写自动化/部署/备份脚本或重构 Bash 代码时自动启用,目标是让脚本可维护、可靠且对用户友好。

主要能力:按复杂度区分两类脚本。简单脚本(约30行以内、无参数、单一自明用途)允许直接执行,无需 main(),但要求顶部写用途注释、错误走 >&2、使用有意义的退出码并正确引用变量。普通脚本(超过约30行、接收参数、多函数/复杂分支或需交互)要求完整的 main() 函数与守卫子句、usage() 帮助函数、结构化参数解析、依赖检查、显式错误处理以及友好的彩色输出。

必要用法要点:使用 #!/usr/bin/env bash;以 DEPENDENCIES 数组声明外部工具并用 exit_on_missing_tools 校验;函数顺序为 usage()、main()、业务逻辑函数、工具函数;守卫子句写作 if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then main "$@"; exit 0; fi,置于脚本末尾以便被 source 时不执行;避免使用 set -e,改用显式判断(如 if ! command; then ... fi、cd dir || { ...; exit 1; })及检查 PIPESTATUS;临时文件用 mktemp 配合 trap 清理;彩色输出需尊重 NO_COLOR 与 TERM=dumb。

验证清单包含 shebang、依赖数组、usage 优先、main 解析参数、守卫子句、退出码、stderr 重定向等。选择模式时可用决策树判断,拿不准时用普通脚本结构。测试建议包括 bash -n 语法检查、临时 set -u、缺失依赖与错误路径测试。

限制:资料未提供该技能的安装命令、运行平台、收费方式或具体调用步骤,这些信息暂未提供;规范中的行数与篇幅建议属指导性阈值,非硬性限制。