nr_micro_shell Integration
Overview
Use this skill to integrate nr_micro_shell as a compact command console. Keep the first port minimal: verified character I/O, one read-only command, bounded buffers, and explicit handling for destructive commands.
When To Use
Use this skill when:
- The user wants a tiny shell/CLI on an MCU and mentions nr_micro_shell.
- Commands are not recognized, input is garbled, completion/history fails, or shell processing blocks firmware.
- The target needs a lower-footprint alternative to larger embedded shells.
Do not use this skill when raw UART is not proven. Use embedded-serial-log-debug first.
First Questions
Ask for:
- Target MCU/RTOS/compiler and nr_micro_shell version/source.
- Transport: UART, USB CDC, RTT, TCP, or custom stream.
- Polling, interrupt, DMA, or task-based input model.
- Command table/registration approach.
- Maximum command length, argument count, and stack/RAM budget.
- Whether shell is enabled in production builds.
Integration Checklist
Verify raw I/O.
Confirm single-character RX/TX before attaching shell parsing.
Configure buffers.
Set command line, history, and output buffers within RAM limits.
Register one safe command.
Start with help, version, or status.
Validate argument parsing.
Commands must reject missing, too many, or invalid arguments.
Bound output.
Avoid long blocking output that starves watchdogs or RTOS tasks.
Guard risky commands.
Reset, erase, format, calibration, flash writes, or network writes need build guards or authentication.
Common Failures
- RX callback stores characters but shell process function is never called.
- Command table is not linked or is optimized out.
- Backspace/newline behavior mismatches terminal settings.
- Long command output blocks system timing.
- Debug shell remains enabled in production without restrictions.
Verification
Before claiming nr_micro_shell works:
- State transport, scheduling model, buffer sizes, and command registration method.
- Confirm raw RX/TX,
help, one custom read-only command, invalid command, and argument error behavior.
- Confirm risky commands are absent, disabled, or guarded.
Example
User:
想用 nr_micro_shell 做一个串口调试命令行。
Agent:
- Asks for UART path, scheduler model, buffer size, and production policy.
- Verifies raw serial, then registers
status.
- Tests command parsing and guards destructive commands.
1---2name: nr-micro-shell-integration3description: Use when integrating, porting, configuring, or debugging nr_micro_shell command consoles, UART shell input, command tables, or tiny embedded CLI behavior4---56# nr_micro_shell Integration78## Overview910Use this skill to integrate nr_micro_shell as a compact command console. Keep the first port minimal: verified character I/O, one read-only command, bounded buffers, and explicit handling for destructive commands.1112## When To Use1314Use this skill when:1516- The user wants a tiny shell/CLI on an MCU and mentions nr_micro_shell.17- Commands are not recognized, input is garbled, completion/history fails, or shell processing blocks firmware.18- The target needs a lower-footprint alternative to larger embedded shells.1920Do not use this skill when raw UART is not proven. Use `embedded-serial-log-debug` first.2122## First Questions2324Ask for:2526- Target MCU/RTOS/compiler and nr_micro_shell version/source.27- Transport: UART, USB CDC, RTT, TCP, or custom stream.28- Polling, interrupt, DMA, or task-based input model.29- Command table/registration approach.30- Maximum command length, argument count, and stack/RAM budget.31- Whether shell is enabled in production builds.3233## Integration Checklist34351. Verify raw I/O.36 Confirm single-character RX/TX before attaching shell parsing.37381. Configure buffers.39 Set command line, history, and output buffers within RAM limits.40411. Register one safe command.42 Start with `help`, `version`, or `status`.43441. Validate argument parsing.45 Commands must reject missing, too many, or invalid arguments.46471. Bound output.48 Avoid long blocking output that starves watchdogs or RTOS tasks.49501. Guard risky commands.51 Reset, erase, format, calibration, flash writes, or network writes need build guards or authentication.5253## Common Failures5455- RX callback stores characters but shell process function is never called.56- Command table is not linked or is optimized out.57- Backspace/newline behavior mismatches terminal settings.58- Long command output blocks system timing.59- Debug shell remains enabled in production without restrictions.6061## Verification6263Before claiming nr_micro_shell works:6465- State transport, scheduling model, buffer sizes, and command registration method.66- Confirm raw RX/TX, `help`, one custom read-only command, invalid command, and argument error behavior.67- Confirm risky commands are absent, disabled, or guarded.6869## Example7071User:7273```text74想用 nr_micro_shell 做一个串口调试命令行。75```7677Agent:78791. Asks for UART path, scheduler model, buffer size, and production policy.801. Verifies raw serial, then registers `status`.811. Tests command parsing and guards destructive commands.
easyzoom