用途:该工作流用于创建健壮、可投入生产的 Bash 脚本,覆盖自动化脚本、系统管理工具、部署脚本、备份方案和 CI/CD 脚本等场景。
主要能力:按七个阶段组织工作:脚本设计(明确目的、输入输出、错误处理、日志策略)、脚本结构(shebang、严格模式、usage 函数、参数解析、日志与清理钩子)、核心实现(输入校验、辅助函数、边界情况、进度提示)、错误处理(trap 处理器、重试、错误信息、退出码、回滚)、日志(日志函数、级别、时间戳、轮转、调试模式)、测试(Bats 测试、ShellCheck 检查)、文档(脚本头、函数文档、用法示例、依赖与排障)。
使用方式:依据任务选择匹配的阶段,先阅读再使用,而非逐条执行全部技能。可用提示词调用相应技能,例如:使用 @bash-pro 设计生产级 Bash 脚本;使用 @bash-defensive-patterns 实现严格模式与错误处理;使用 @bash-linux 实现系统命令;使用 @bash-defensive-patterns 添加错误处理;使用 @bash-pro 实现结构化日志;使用 @bats-testing-patterns 编写测试;使用 @shellcheck-configuration 检查脚本;使用 @documentation-templates 编写文档。
模板:提供含 #!/usr/bin/env bash 与 set -euo pipefail 的脚本模板,含 SCRIPT_NAME、SCRIPT_DIR、log、error、usage、main 等结构,并调用 main "$@"。模板只是起点,未实现参数解析与回滚。
质量门:ShellCheck 通过、Bats 测试通过、错误处理有效、日志可用、文档完整。
限制:仅当任务明显匹配上述范围时使用;输出不能替代环境特定验证、测试或专家评审;云调用、主机配置、发布、破坏性操作与花费需获得授权;应校验路径、给展开加引号、在一次性目录中测试,重试需有界且安全;不得记录凭据,严格模式也不代表能捕获所有失败;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。相关组合:os-scripting、linux-troubleshooting、cloud-devops。