cross-platform-command-generator

name	cross-platform-command-generator
description	Generates cross-platform commands and scripts for Linux, macOS, and Windows with security validation and compatibility guidance

Cross-Platform Command Generator

这个技能为 DevOps、系统运维、软件开发自动化和安全运维提供跨平台命令行和脚本生成能力,支持自然语言描述转换为可执行命令,并提供安全性检查和危险命令预警。

Capabilities

• 自然语言命令生成: 根据用户描述生成适用于多操作系统的命令行

  • Linux/Unix (Bash/Zsh)
  • macOS (Bash/Zsh)
  • Windows (PowerShell/CMD)

• 脚本文件生成: 创建完整的跨平台脚本文件

  • .sh - Shell 脚本 (Linux/macOS)
  • .ps1 - PowerShell 脚本 (Windows)
  • .bat/.cmd - 批处理脚本 (Windows)

• 安全性检查: 危险命令检测和风险评估

  • 权限提升命令识别 (sudo, runas)
  • 破坏性操作警告 (rm -rf, format, del /f)
  • 网络安全风险评估

• 兼容性分析: 提供跨平台兼容性建议

  • 平台特定命令差异
  • 替代命令推荐
  • 依赖项检查

• 参数验证: 命令参数合法性检查和错误处理

Input Requirements

用户提供以下信息:

命令生成模式

• 任务描述: 自然语言描述要执行的操作 (例如: "列出当前目录下所有文件的详细信息")
• 目标平台: 选择一个或多个目标操作系统 (Linux/macOS/Windows)
• 安全级别: 可选,指定是否允许需要提升权限的命令 (默认: false)
• 输出格式: 命令行 (单条命令) 或脚本文件 (完整脚本)

脚本生成模式

• 脚本用途: 描述脚本的功能和目标
• 目标平台: 选择生成哪些平台的脚本
• 功能模块: 列出脚本需要包含的功能 (例如: 参数解析、日志记录、错误处理)
• 安全要求: 是否需要输入验证、权限检查、危险操作确认

输入格式支持:

• JSON 结构化输入
• 自然语言文本描述
• 混合模式 (部分结构化 + 自然语言)

Output Formats

命令行输出

{
  "task_description": "原始任务描述",
  "platforms": {
    "linux": {
      "command": "生成的 Linux 命令",
      "description": "命令说明",
      "requires_sudo": false,
      "safety_level": "safe"
    },
    "macos": {
      "command": "生成的 macOS 命令",
      "description": "命令说明",
      "requires_sudo": false,
      "safety_level": "safe"
    },
    "windows": {
      "powershell": "PowerShell 命令",
      "cmd": "CMD 命令",
      "description": "命令说明",
      "requires_admin": false,
      "safety_level": "safe"
    }
  },
  "compatibility_notes": [
    "跨平台兼容性说明"
  ],
  "security_warnings": [
    "安全风险提示 (如有)"
  ]
}

脚本文件输出

生成的脚本文件包含:

• 脚本头部 (shebang, 版权信息, 用途说明)
• 参数解析逻辑
• 输入验证
• 核心功能实现
• 错误处理和日志记录
• 使用示例和帮助信息

文件清单:

• script_linux.sh - Linux/Unix Shell 脚本
• script_macos.sh - macOS Shell 脚本
• script_windows.ps1 - Windows PowerShell 脚本
• script_windows.bat - Windows 批处理脚本
• README.md - 脚本使用说明

How to Use

命令生成示例

基础用例:

@cross-platform-command-generator

生成跨平台命令: 查找当前目录下所有大于 100MB 的文件
目标平台: Linux, macOS, Windows

安全运维用例:

@cross-platform-command-generator

生成命令: 检查系统中所有监听端口和对应的进程
目标平台: 所有平台
安全级别: 需要管理员权限

脚本生成示例

自动化部署脚本:

@cross-platform-command-generator

生成部署脚本:
- 功能: 自动化应用部署
- 平台: Linux, Windows
- 包含: 参数解析、环境检查、备份机制、回滚功能、日志记录
- 安全: 需要权限检查和危险操作确认

系统健康检查脚本:

@cross-platform-command-generator

生成健康检查脚本:
- 检查 CPU/内存/磁盘使用率
- 检查关键服务运行状态
- 生成报告并发送邮件通知
- 平台: Linux, macOS, Windows

Scripts

command_generator.py

核心命令生成引擎,包含:

• PlatformCommandGenerator 类: 根据任务描述生成特定平台命令
• cross_platform_translate(): 自然语言到命令的转换逻辑
• 平台命令映射表 (Linux/macOS/Windows 常用命令对照)

security_validator.py

安全检查模块,包含:

• SecurityValidator 类: 命令安全性验证
• check_dangerous_commands(): 危险命令检测
• assess_risk_level(): 风险等级评估 (safe/warning/dangerous)
• privilege_required(): 权限需求检查

script_builder.py

脚本文件生成器,包含:

• ScriptBuilder 类: 多平台脚本构建
• generate_bash_script(): 生成 Shell 脚本
• generate_powershell_script(): 生成 PowerShell 脚本
• generate_batch_script(): 生成批处理脚本
• 脚本模板管理

compatibility_checker.py

兼容性分析器,包含:

• CompatibilityChecker 类: 跨平台兼容性检查
• find_equivalent_commands(): 查找等效命令
• suggest_alternatives(): 推荐替代方案
• 平台特性差异数据库

Best Practices

1. 安全优先原则

• 始终检查生成的命令是否包含危险操作
• 对需要提升权限的命令进行明确标注
• 在执行破坏性操作前添加确认机制
• 避免在脚本中硬编码敏感信息 (密码、密钥)

2. 兼容性验证

• 生成命令前验证目标平台是否支持所需功能
• 提供跨平台差异的详细说明
• 推荐使用跨平台工具 (如 Python, Node.js) 替代平台特定命令
• 测试生成的命令在目标平台上的实际执行效果

3. 参数和错误处理

• 对用户输入进行严格验证
• 在脚本中包含完善的错误处理逻辑
• 提供清晰的错误消息和调试信息
• 实现优雅的失败回退机制

4. 文档和可维护性

• 为生成的脚本添加详细注释
• 包含使用示例和帮助信息
• 遵循平台特定的脚本编写规范
• 使用版本控制管理脚本文件

5. 性能和效率

• 优先使用系统原生命令
• 避免不必要的外部依赖
• 对资源密集型操作提供进度反馈
• 考虑命令执行的性能影响

Limitations

技术限制

• 平台差异: 某些高级功能可能无法在所有平台上完全等效实现
• 命令版本: 不同操作系统版本的命令语法可能存在差异
• 依赖项: 生成的命令可能依赖特定工具或软件的安装
• 权限控制: 某些操作需要管理员/root 权限,无法在受限环境中执行

安全限制

• 静态分析: 安全检查基于已知危险模式,无法识别所有潜在风险
• 上下文依赖: 某些命令的安全性取决于具体执行环境和参数
• 第三方工具: 对第三方工具的安全性不做保证

使用场景限制

• 不适用于: 高度定制化的系统配置、复杂的企业级部署流程
• 需要人工审核: 生产环境部署前应由专业人员审核生成的命令和脚本
• 测试环境优先: 建议先在测试环境验证生成的命令

语言和本地化

• 主要支持英文命令和参数
• 部分平台特定工具可能需要额外的本地化配置
• 错误消息和日志输出语言取决于系统设置

Industry Context

本技能特别适用于以下场景:

DevOps / 系统运维

• 基础设施即代码 (IaC) 脚本生成
• 跨云平台自动化部署
• 系统监控和健康检查脚本
• 灾难恢复和备份自动化

软件开发 / 自动化

• CI/CD 流水线脚本
• 构建和测试自动化
• 环境配置和依赖安装
• 代码质量检查自动化

安全运维

• 安全审计脚本生成
• 漏洞扫描自动化
• 日志分析和威胁检测
• 合规性检查脚本

混合云和多云环境

• 跨平台资源管理
• 统一的运维工具链
• 平台迁移和数据同步
• 多环境配置管理