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 流水线脚本
构建和测试自动化
环境配置和依赖安装
代码质量检查自动化

安全运维

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

混合云和多云环境

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

cross-platform-command-generator

Install Skill

SKILL.md