terminal

Q: How do I install terminal?

Run npx skills add https://github.com/zhinkgit/embeddedskills --skill terminal in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/terminal/ (personal) or .claude/skills/terminal/ (project).

by zhinkgit

双向交互终端会话工具，用于串口终端、SSH 交互 Shell、本地 Shell、设备控制台、AT/CLI 菜单、需要保持上下文的交互式调试；当用户提到交互终端、串口终端、SSH 终端、打开 shell、发送命令后继续读输出、保持会话、登录后操作、菜单式命令行时触发，也兼容 /terminal 显式调用。

Installs: 510
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/zhinkgit/embeddedskills --skill terminal

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads terminal automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Terminal — 双向交互终端会话

统一封装串口、SSH 和本地 Shell 的双向交互会话。它补齐 serial 的“监控/发送是分离命令”和 ssh 的“远程命令多为一次性执行”之间的空白：当目标需要保持登录状态、菜单状态、REPL 状态或设备 CLI 上下文时，使用本 skill。

定位

serial：扫描、监控、单次发送、日志、Hex 查看。
ssh：OpenSSH 配置、远程命令、传输、隧道。
terminal：保持一个可持续读写的交互式会话，并通过 send/read 驱动下一步判断。

配置

环境级配置 (`config.json`)

terminal skill 的环境级配置目前为空对象 {}。交互终端的关键参数通常和具体会话绑定，优先通过 start 命令显式传入，避免误连设备或误用凭据。

会话状态 (`.embeddedskills/state.json`)

后台会话运行时状态保存到工作区的 .embeddedskills/state.json，使用 terminal_sessions 字段记录会话名、后端、PID、TCP 控制端口和日志路径。

参数优先级

CLI 参数 (--port, --baudrate, --host, --name 等) - 最高优先级
会话状态 (.embeddedskills/state.json 中已启动的 terminal_sessions)
默认值 - 最低优先级

子命令

子命令	用途	风险
`start`	启动一个后台交互会话	中
`list`	列出现有会话	低
`status`	查询单个会话状态	低
`send`	向会话写入文本或 Hex 数据	中
`read`	读取并清空会话输出缓冲	低
`attach`	前台行模式接入会话	中
`stop`	停止会话并清理状态	中

后端

后端	适用场景	依赖
`serial`	MCU UART 控制台、AT 命令、Bootloader 菜单、板卡 CLI	`pyserial`
`ssh`	Linux 开发板交互 Shell、登录后持续操作	OpenSSH 客户端
`local`	本机临时 Shell、REPL、CLI 程序交互	Python 标准库

脚本调用

所有脚本位于 skill 目录的 scripts/ 下，通过 python 直接调用。命令示例均以当前 skill 目录为基准。

# 启动串口终端
python scripts/terminal_session.py start serial --port COM11 --baudrate 115200 --name board

# 启动 SSH 终端，host 使用 ~/.ssh/config 中的 Host 别名
python scripts/terminal_session.py start ssh --host 1380-P904 --name devboard

# 启动本地 Shell
python scripts/terminal_session.py start local --name local-shell

# 发送一行命令并追加 CRLF
python scripts/terminal_session.py send board "help" --crlf

# 读取输出，最多等待 1 秒
python scripts/terminal_session.py read board --timeout 1

# 前台行模式接入
python scripts/terminal_session.py attach board

# 查询与停止
python scripts/terminal_session.py list
python scripts/terminal_session.py status board
python scripts/terminal_session.py stop board

会话状态详情

会话元数据保存到工作区：

.embeddedskills/state.json

使用 terminal_sessions 字段记录：

{
  "terminal_sessions": {
    "board": {
      "backend": "serial",
      "tcp_port": 23145,
      "pid": 1234,
      "started_at": "2026-05-26T10:00:00+08:00"
    }
  }
}

后台进程日志保存到：

.embeddedskills/logs/terminal/

输出格式

脚本默认输出 JSON：

{
  "status": "ok",
  "action": "read",
  "summary": "读取 42 字节",
  "details": {
    "session": "board",
    "text": "help\r\n..."
  }
}

错误输出：

{
  "status": "error",
  "action": "send",
  "error": {
    "code": "session_unreachable",
    "message": "会话不可达，可能已退出"
  }
}

操作流程

判断是否真的需要保持交互状态；若只是一次性远程命令，优先使用 ssh；若只是串口抓日志，优先使用 serial。
选择后端：串口控制台用 serial，远程 shell 用 ssh，本机交互程序用 local。
start 后先 read --timeout 1 获取启动横幅、登录提示或 shell prompt。
每次 send 后都用 read --timeout <秒> 观察反馈，再决定下一步。
完成后执行 stop，避免后台进程长期占用串口、SSH 连接或本地 Shell。

核心规则

不自动猜测串口端口、波特率、SSH Host 或登录凭据。
未明确用途时不主动发送任何会改变设备状态的命令。
多个会话必须使用不同 --name，避免输出混淆。
read 会清空当前输出缓冲；重要输出需要及时记录到最终回复。
attach 是行模式，不等同于完整 TTY/raw 模式；需要全屏程序、vim、top、交互式密码输入时，优先让用户使用真实终端工具。
串口会话会独占真实串口；如果需要和外部串口工具共享端口，先使用 serial skill 的 mux 能力。
SSH 后端使用 ~/.ssh/config 的 Host 别名；配置主机、跳板机、传输文件仍交给 ssh skill。
失败时保留真实错误：端口占用、缺少 pyserial、ssh 不存在、Host 别名无法解析、进程已退出等都不要吞掉。

FAQ

What does the terminal skill do?

How do I install terminal?

Run npx skills add https://github.com/zhinkgit/embeddedskills --skill terminal in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/terminal/ (personal) or .claude/skills/terminal/ (project).

Which AI agents can use terminal?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is terminal safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains terminal?

It is published by zhinkgit in zhinkgit/embeddedskills. It has 510 recorded installs.

More from zhinkgit/embeddedskills

View all →

keil

zhinkgit/embeddedskills

Keil MDK 工程构建工具，用于扫描 .uvprojx/.uvproj/.uvmpw 工程、枚举 Target、执行 build/rebuild/clean 并解析构建日志，返回可供 jlink/openocd 复用的产物路径。 flash 子命令仅作为兼容入口保留。当用户提到 Keil、MDK、uVision、UV4、 Target 枚举、编译、重建、清理、烧录、下载固件、flash 时自动触发，也兼容 /keil 显式调用。即使用户只是说"编译一下"或"烧录到板子上"，只要上下文涉及嵌入式 Keil 工程就应触发此 skill。

870 installs

serial

zhinkgit/embeddedskills

嵌入式串口调试工具，用于扫描串口、实时监控、发送数据、记录日志和 Hex 查看。当用户提到串口、COM 口、UART、AT 命令调试、波特率、Hex 串流、串口抓日志、串口监控、查看 MCU 输出、二进制协议联调时自动触发，也兼容 /serial 显式调用。即使用户只是说"看看串口输出"、"发个 AT 命令"或"抓一下日志"，只要上下文涉及串口通信就应触发此 skill。

814 installs

can

zhinkgit/embeddedskills

嵌入式 CAN / CAN-FD 调试工具，用于扫描接口、监控报文、发送测试帧、记录日志、数据库文件解码和总线统计。当用户提到 CAN、CAN-FD、DBC 解码、总线抓包、USB-CAN 联调、报文发送、总线统计、 PCAN、Vector、slcan、CAN 接口扫描、CAN ID 过滤、ASC 日志、BLF 文件时自动触发，也兼容 /can 显式调用。即使用户只是说"看看 CAN 报文"、"发一帧试试"或"解码一下 DBC"，只要上下文明确提到 CAN 总线通信的操作或问题就应触发此 skill。

720 installs

jlink

zhinkgit/embeddedskills

J-Link 下载与在线调试工具，用于探测设备、烧录固件、读写内存、查看寄存器、复位目标、读取 RTT/SWO 日志，以及在线调试（暂停/恢复/单步/断点运行/调用栈/变量查看）。当用户提到 J-Link、JLink、RTT、烧录固件、写内存、读内存、寄存器查看、目标复位、探针连通性检查、在线调试、单步、断点、调用栈时自动触发，也兼容 /jlink 显式调用。即使用户只是说"烧录一下"、"看看 RTT 输出"或"调试一下"，只要上下文涉及 J-Link 探针就应触发此 skill。

683 installs

openocd

zhinkgit/embeddedskills

OpenOCD 下载与调试工具，用于探针探测、固件烧录、Flash 擦除、GDB Server 启动、目标复位控制、 Telnet 在线调试（halt/resume/step/寄存器/内存/断点）、GDB 源码级调试，以及 Semihosting/ITM 输出捕获和底层查询。当用户提到 OpenOCD、ST-Link、CMSIS-DAP、DAPLink、FTDI、烧录固件、擦除 Flash、GDB Server、 reset、interface/target/board 配置、openocd.cfg、在线调试、单步、断点、寄存器查看、内存读写、semihosting 时自动触发，也兼容 /openocd 显式调用。即使用户只是说"烧录一下"、"启动 GDB Server"、"擦除芯片"、"看看寄存器"、"单步调试" 或"抓一下 semihosting"，只要上下文涉及 OpenOCD 支持的开源调试器就应触发此 skill。

Backend & APIs673 installs

gcc

zhinkgit/embeddedskills

GCC 嵌入式工程构建工具（CMake + arm-none-eabi-gcc），用于扫描 CMake 型嵌入式工程、列出预设、配置、编译、重建、清理和分析 ELF 大小。当用户提到 GCC、arm-none-eabi、 CMake 嵌入式编译、Ninja 构建、ELF 大小分析、arm-gcc、交叉编译、cmake --build、 cmake --preset 时自动触发，也兼容 /gcc 显式调用。即使用户只是说"编译一下"或 "看看固件多大"，只要上下文涉及 CMake 嵌入式 GCC 工程就应触发此 skill。

667 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs

terminal

Install

Install

Describe the task

Review the result

SKILL.md

Terminal — 双向交互终端会话

定位

配置

环境级配置 (config.json)

会话状态 (.embeddedskills/state.json)

参数优先级

子命令

后端

脚本调用

会话状态详情

输出格式

操作流程

核心规则

FAQ

More from zhinkgit/embeddedskills

Popular other skills

环境级配置 (`config.json`)

会话状态 (`.embeddedskills/state.json`)