SuperAPI AI 工具集

linux-bash-scripting

写作与研究

查看项目

更新于 10-16 08:04

技能介绍

用途:这是 linux-skills 仓库所有 sk-* 脚本的基础元技能。在编写新的 sk-* 脚本、审查或重构 scripts/ 下已有脚本、检查脚本是否符合引擎契约、旗标模型与安全规则时使用;不适用于一次性 shell 命令、不会进入仓库的运维修复,以及非 Bash 实现。

主要能力:定义六段式脚本模板(元数据头、库与安全、默认值、函数、旗标解析、健全性检查、主逻辑),common.sh 共享库契约(输出、守卫、交互、安全文件操作、旗标解析等函数),每个脚本必须支持的标准旗标,交互式 UX 规则,以及安全模式。通过 detect_distro、pkg_install、svc_name、firewall_allow、web_conf_dir、web_reload、require_family 等原语避免硬编码 apt、ufw、apache2,从而同时支持 Debian/Ubuntu 与 RHEL 系(Fedora、RHEL、CentOS Stream、Rocky、Alma、Oracle)。

使用方式:先阅读所属技能、引擎规范、清单、模板与 common.sh 契约;定义输入、副作用、决策、退出码、回滚与发行版支持;再搭建或审查六段结构与标准旗标;通过共享原语实现,使用引号包裹变量、安全临时文件、备份与原生校验器;测试 help、错误输入、--yes、dry run、中断、幂等性与双发行版。标准旗标包括 --help、--version、--yes、--dry-run、--log、--json、--verbose、--quiet。--yes 表示调用者已预先决定所有选项,缺少必需决策旗标时必须报错退出,不得静默使用默认值。

限制:审查默认只读;修改自有脚本需明确实现授权,执行特权或破坏性路径需单独测试主机批准。缺少 shellcheck、Bash 运行时、root 或双发行版环境时,只能完成静态检查,并将运行时、权限或发行版行为标注为未评估,不得仅凭源码检查声称可移植性或安全性。