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

terminal-command-planner

GitHub

KKTerm终端命令规划助手，支持多环境（本地/SSH/WSL等）安全命令生成。优先只读检查，解释意图并避免高危操作，提供干跑预览，确保跨Shell语法兼容与上下文准确。

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

Trigger Scenarios

用户请求终端命令或Shell诊断需要日志检查或服务状态巡检涉及命令解释或跨平台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.