用途:DX Review Skill 是一个开发者体验(DX)审查与咨询技能,专注于 CLI 工具、Shell 脚本、开发者工具和自动化脚本,用于分析工具代码并给出可操作、具体的反馈。
主要能力:按三个阶段工作。第一阶段上下文发现,确定审查目标(用户明确请求、最近 git 变更如 git diff --name-only HEAD~1、或内联调用的当前文件),识别工具类型(编译型 CLI 如 Go Cobra/cli、Rust clap、Deno/Node oclif;Shell 脚本 Bash/Zsh/Fish/POSIX sh;构建/任务工具 Makefile、Taskfile、Justfile、npm scripts;混合型),并完整阅读目标文件。第二阶段分析,按代码内容加载 rules/ 下对应规则文件,如核心原则、帮助与文档、输出与格式、错误处理、参数与标志、配置、交互性、可组合性、Shell 脚本、测试、分发等,逐条对照,指出具体行、被违反的原则、对开发者的影响,并给出含代码的修复方案。第三阶段按 templates/review-report.md 模板输出报告。严重级别分为 Critical(阻断使用、数据丢失、安全风险)、High(显著降低 DX、破坏脚本化)、Medium(可用但非最佳实践)、Low(打磨与增强)。
关键原则:响应时间阈值(<100ms 直接反馈,100ms-1s 显示加载指示,1-10s 显示带上下文的进度,超过 10s 显示百分比/ETA 并允许 Ctrl-C)。标准标志(-h/--help、-v/--version、--no-color/NO_COLOR、-q/--quiet、--json、-n/--dry-run)。退出码(0 成功,1 一般错误,2 用法错误,126 不可执行,127 未找到命令,130 中断)。输出流(stdout 主输出/机器可读数据,stderr 日志、错误、进度)。破坏性操作安全层级(轻微:可选确认;中等:默认要求确认;严重:需显式输入资源名确认)。
行为规则:具体而非泛泛;按影响排序;区分工具类型,不把交互式 CLI 规则套用到批处理脚本;肯定已有的良好模式;每个建议都给可实施代码;避免过度报告。
限制:资料未提供安装方式、收费或平台信息。