SuperAPI AI 工具集

bash

编程与开发

查看项目

更新于 10-15 17:25

技能介绍

该技能用于在创建、编辑、审查或重构 Bash/shell 脚本时自动应用统一的编写标准,提升可维护性、可靠性与易用性。适用触发场景包括新建或修改 .sh/.bash 文件、编写自动化/部署/备份/系统任务脚本,以及用户提及 bash、shell script、main function、参数解析或脚本结构时。

主要能力:区分两类脚本。简单脚本用于约 30 行以内、无参数、单一明确用途的场景,要求顶部写清用途注释、显式处理错误、正确退出码、错误输出到 stderr,变量正确引用,可不用 main 包裹。常规脚本用于超过约 30 行、需要参数、多函数或复杂分支、交互使用或需详细文档的场景,要求 main 函数加守卫子句、usage 函数、参数解析、依赖检查、显式错误处理与友好输出。

核心规范:始终避免 set -e,改用显式判断、|| 链式处理或捕获返回值;错误一律用 >&2 输出到 stderr 并给出上下文;函数顺序为 usage、main、业务逻辑、工具函数;使用 local 声明局部变量;函数保持单一职责,过长则拆分。依赖需在 DEPENDENCIES 数组中声明,并用 exit_on_missing_tools 逐个通过 command -v 校验,缺失时退出。守卫子句置于脚本末尾,仅在直接执行时调用 main,便于被其他脚本 source。

常用做法:参数用 while 与 case 解析,先设默认值再校验必填项;交互确认使用 read -p 与 REPLY 匹配;临时文件用 mktemp 并在 trap 中清理;管道错误通过 PIPESTATUS 检查;彩色输出需尊重 NO_COLOR 与 TERM=dumb。生成后建议用 bash -n 检查语法并测试错误路径。

限制:资料未提供该技能的具体安装方式、平台支持范围、收费信息及运行依赖细节,这些暂未提供。