AgentSkillsCN

platform-cli

遵循现代 UX 规范,打造命令行工具的设计与实现模式。适用于以下场景:(1) 设计全新 CLI 工具;(2) 审查 CLI 的用户体验与行为;(3) 定义命令、标志或帮助文本;(4) 实现错误处理或信号处理;(5) 规划 CLI 的分发方式。

SKILL.md
--- frontmatter
name: platform-cli
description: "Design and implementation patterns for building command-line tools with modern UX conventions. Use when: (1) designing a new CLI tool, (2) reviewing CLI UX and behavior, (3) defining commands, flags, or help text, (4) implementing error handling or signal handling, (5) planning CLI distribution."

CLI Development Patterns

Modern CLI design patterns for commands, flags, output, errors, signals, config, and distribution.

References

See references/cli-patterns.md for comprehensive guidance organized by:

  • Design & Naming - Command structure, naming conventions, future-proofing
  • Flags & Arguments - Standard flags, short forms, boolean negation
  • Output & Formatting - stdout/stderr, TTY detection, colors, machine-readable formats
  • Error Handling - Exit codes, error messages, signal-to-noise ratio
  • Signals & Lifecycle - Ctrl-C handling, cleanup timeouts
  • Environment & Config - Standard variables, precedence, naming
  • Distribution & Packaging - Single binary distribution, uninstall instructions
  • Security & Privacy - Secret handling, telemetry consent