用途:create-cli 用于设计 CLI 的“表面区域”(语法与行为),目标是既对人友好,又便于脚本调用。它先要求阅读 agent-scripts/skills/create-cli/references/cli-guidelines.md 并作为默认准则,上游完整指南见 https://clig.dev/。
主要能力:帮助锁定命令名与一句话用途、主要用户(人、脚本或两者)、输入来源(参数与 stdin、文件与 URL、密钥不通过标志传递)、输出契约(人类文本、--json、--plain、退出码)、交互性(是否允许提示、是否需要 --no-input、破坏性操作确认)、配置模型(标志/环境变量/配置文件及优先级、XDG 与仓库本地)、平台与运行时约束。
使用方式:先提出最少必要的澄清问题,用户不确定时按最佳猜测默认值继续。产出紧凑规格:命令树与 USAGE 概要、参数/标志表、子命令语义、输出规则(stdout 与 stderr、TTY 检测、--json/--plain、--quiet/--verbose)、错误与退出码映射、安全规则(--dry-run、确认、--force、--no-input)、配置与环境变量优先级(标志 > 环境变量 > 项目配置 > 用户配置 > 系统)、shell 补全方案、5–10 个示例调用。
默认约定:-h/--help 始终显示帮助并忽略其他参数;--version 输出到 stdout;主数据到 stdout,诊断与错误到 stderr;提供 --json,考虑 --plain;仅在 stdin 为 TTY 时提示,--no-input 禁用提示;破坏性操作需交互确认,非交互需 --force 或 --confirm=...;尊重 NO_COLOR、TERM=dumb,提供 --no-color;处理 Ctrl-C 快速退出、有界清理。
适用场景:设计新 CLI 或评审现有 CLI 的参数与交互。限制:仅在需要时推荐语言相关解析库,否则保持语言无关;若请求是“设计参数”,不要转向实现。资料未提供具体安装命令、收费或平台支持细节。