Agent Skills › ryantsai/KKTerm › terminal-command-planner

terminal-command-planner

GitHub

用于规划安全终端命令，支持本地、SSH、WSL及PowerShell等环境。优先只读检查，避免破坏性操作，提供干跑预览，并处理跨平台语法差异与KKTerm边界限制。

assistant-skills/terminal-command-planner/SKILL.md ryantsai/KKTerm

Trigger Scenarios

请求终端命令 Shell诊断日志检查服务检查命令解释

Install

npx skills add ryantsai/KKTerm --skill terminal-command-planner -g -y

More Options

Non-standard path

npx skills add https://github.com/ryantsai/KKTerm/tree/main/assistant-skills/terminal-command-planner -g -y

Use without installing

npx skills use ryantsai/KKTerm@terminal-command-planner

指定 Agent (Claude Code)

npx skills add ryantsai/KKTerm --skill terminal-command-planner -a claude-code -g -y

安装 repo 全部 skill

npx skills add ryantsai/KKTerm --all -g -y

预览 repo 内 skill

npx skills add ryantsai/KKTerm --list

SKILL.md

Frontmatter

{
    "name": "terminal-command-planner",
    "description": "Plan safe terminal commands for local shells, SSH terminals, PowerShell, Command Prompt, WSL, diagnostics, log inspection, service checks, and approval-based command assistance in KKTerm."
}

Terminal Command Planner

Use this skill when the user asks for terminal commands, shell diagnostics, log checks, service inspection, or command explanations.

Workflow

Determine whether the command targets a local terminal Session, an SSH Session, WSL, PowerShell, Command Prompt, or a generic shell.
Prefer read-only inspection before mutation.
Explain the intent and expected output before suggesting risky or unfamiliar commands.
Keep commands scoped to the named host, path, service, process, or file.
Avoid broad deletes, destructive disk operations, fork bombs, credential dumping, or irreversible system-wide changes.
For mutating commands, offer a safer dry run, preview, backup, or targeted form when practical.
Do not claim a command ran unless a tool result or session context proves it.
If the current shell is unknown, make the shell assumption explicit.
When translating between PowerShell, Command Prompt, WSL, and POSIX shells, call out syntax differences that matter.

KKTerm Boundaries

Local Windows shells run through ConPTY; browser previews do not validate local terminal focus or input behavior.
SSH uses NativeSsh and can differ from local shell behavior.
Secrets must not be pasted into normal chat text.
User-facing status belongs in the workspace status bar when changing app state.