Execute shell commands for system operations, directory creation, and script execution. When you need to run system commands, execute scripts, install packages, or manage processes. Note - if commands fail consecutively, try different approaches.
79%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Critical
Do not install without reviewing
Fix and improve this skill with Tessl
tessl review fix ./skills/system/run-shell/SKILL.md执行 Shell 命令。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| command | string | 是 | 要执行的 Shell 命令 |
| cwd | string | 否 | 工作目录(可选) |
| timeout | integer | 否 | 超时时间(秒),默认 60,范围 10-600 |
列出目录:
{"command": "ls -la"}安装依赖:
{"command": "pip install requests", "timeout": 300}在指定目录执行:
{"command": "npm install", "cwd": "/path/to/project"}系统会自动将 PowerShell 命令通过 -EncodedCommand(Base64 UTF-16LE)编码执行,
避免 cmd.exe → PowerShell 的多层引号/特殊字符转义破坏。直接传入 PowerShell 命令即可。
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 简单系统查询(进程/服务/文件列表) | PowerShell cmdlet | Get-Process, Get-ChildItem 等一行搞定 |
| 复杂文本处理(正则、URL 提取、HTML/JSON 解析) | Python 脚本 | 避免 PowerShell 正则 one-liner 的复杂性 |
| 批量文件操作(重命名、过滤、转换) | Python 脚本 | 更可靠,不受 PowerShell 管道转义影响 |
| 网络下载/HTTP 请求 | Python 脚本 | requests/urllib 比 Invoke-WebRequest 更灵活 |
对于复杂文本处理任务,务必使用 write_file + run_shell 组合:
步骤 1: write_file 写入 data/temp/task_xxx.py
步骤 2: run_shell "python data/temp/task_xxx.py"禁止:在 run_shell 中写包含复杂正则的 PowerShell one-liner,例如:
# 禁止这种写法
powershell -Command "Get-Content file.html | Select-String -Pattern '(?<=src=\")[^\"]+' | ForEach-Object { $_.Matches.Value } | Sort-Object -Unique | Out-File urls.txt"应改为写 Python 脚本:
import re
from pathlib import Path
html = Path("file.html").read_text(encoding="utf-8")
urls = sorted(set(re.findall(r'src="([^"]+)"', html)))
Path("urls.txt").write_text("\n".join(urls), encoding="utf-8")get_session_logs 查看详细日志write-file: 写入文件read-file: 读取文件openakita/openakita
5f5b38d
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.