rust-cli

📁 peixotorms/odinlayer-skills 📅 4 days ago

总安装量

周安装量

#50467

全站排名

安装命令

npx skills add https://github.com/peixotorms/odinlayer-skills --skill rust-cli

Agent 安装分布

amp 1

opencode 1

kimi-cli 1

codex 1

github-copilot 1

claude-code 1

Skill 文档

CLI Development

Domain Constraints

Domain Rule	Design Constraint	Rust Implication
User ergonomics	Clear help, errors	clap derive macros
Config precedence	CLI > env > file	Layered config loading
Exit codes	Non-zero on error	Proper Result handling
Stdout/stderr	Data vs errors	eprintln! for errors
Interruptible	Handle Ctrl+C	Signal handling

Critical Rules

Errors to stderr, data to stdout â enables piping and scriptability.
CLI args > env vars > config file > defaults â standard override chain.
Return non-zero on any error â script integration depends on exit codes.

Key Crates

Purpose	Crate
Argument parsing	clap
Interactive prompts	dialoguer
Progress bars	indicatif
Colored output	colored
Terminal UI	ratatui
Terminal control	crossterm
Console utilities	console

CLI Structure Pattern

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(name = "myapp", about = "My CLI tool")]
struct Cli {
    /// Enable verbose output
    #[arg(short, long)]
    verbose: bool,

    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Initialize a new project
    Init { name: String },
    /// Run the application
    Run {
        #[arg(short, long)]
        port: Option<u16>,
    },
}

fn main() -> anyhow::Result<()> {
    let cli = Cli::parse();
    match cli.command {
        Commands::Init { name } => init_project(&name)?,
        Commands::Run { port } => run_server(port.unwrap_or(8080))?,
    }
    Ok(())
}

Common Mistakes

Mistake	Domain Violation	Fix
Errors to stdout	Breaks piping	eprintln!
No help text	Poor UX	#[arg(help = “…”)]
Panic on error	Bad exit code	Result + proper handling
No progress for long ops	User uncertainty	indicatif

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台