SuperAPI AI 工具集

terminal-command-safety

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:该技能面向 AI 智能体执行终端命令的场景,提供安全命令模式与示例,减少因反引号、输出捕获和交互式挂起导致的执行失败。

主要能力:

  1. 反引号风险处理。反引号在 bash/zsh 中触发命令替换,在 PowerShell 中是转义字符,会破坏命令参数。安全做法是先把内容写入临时文件,再通过文件参数传入命令。bash 示例:cat > /tmp/body.md << 'EOF' 写入内容后,用 gh pr create --title "My PR" --body-file /tmp/body.md,最后 rm /tmp/body.md。PowerShell 用 here-string 写入 $env:TEMP\body.md,再以 --body-file 传入并 Remove-Item 清理。
  2. 输出捕获。可将输出重定向到文件后读取尾部,如 npm run build 2>&1 | Out-File -Encoding utf8 "$env:TEMP\build-output.txt" 配合 Get-Content ... -Tail 50;也可用 Out-String 管道,如 git log --oneline -20 | Out-String;哨兵模式用 npm test 2>&1; echo "EXIT_CODE:$LASTEXITCODE" 获取退出码。避免进入 alt-buffer,例如用 git log 而非 git log | less,设置 $env:GIT_PAGER="cat",用 Get-Help 而非 man,用 gh issue view --json 而非会打开分页器的 gh issue view。
  3. 防止挂起。异步模式适用于 npm start、dotnet run、docker compose up 和长时间测试套件;同步模式配合 timeout=30000 适用于 npm install、git 操作和单个测试文件。预先回答交互提示,如 npm install --yes、rm -rf(而非 rm -ri)、az login --use-device-code、git commit --no-edit。网络超时可用 npm install --prefer-offline --no-audit 和 curl --max-time 30 --connect-timeout 10 $url。

适用场景:AI 智能体或自动化脚本在 bash、zsh、PowerShell 中执行命令、创建 PR、运行构建与测试、查看日志时。

限制:资料未提供该技能的安装方式、平台支持范围、收费信息及具体版本要求,暂未提供。