dx-first 是一个开发者体验(DX/DevEx)技能,适用于任何软件仓库或项目类型,核心目标是把开发体验当作仓库的产品表面来优化,追求三个结果:降低认知负担,让有意义的下一个操作容易被发现;缩短反馈循环,在最小有效范围内提供快速可信的信号;保护心流,减少等待、上下文切换、不必要选择和意外的恢复工作。
使用方式上,它提供三种模式。DX Audit:检查并测试仓库,报告按优先级排序的摩擦点,除测试所需的安全忽略产物外保持只读。DX Improve:先做聚焦审计,实施最小且连贯的修复集,更新受影响文档并重新运行关键流程。DX Review/Guard:评估功能、计划、PR、重构或工具变更是否引入工作流回退,除非明确要求实现否则不编辑代码。请求含糊时默认用 Audit;只有用户明确要求修复或实现时才用 Improve。
工作流为:inspect → classify → trace → test → find friction → prioritize → improve → verify → simplify。即检查仓库结构、清单、运行时、任务入口、测试、CI 和文档;分类仓库类型与生态;追踪从克隆、安装、运行、修改到验证的首个贡献循环;在安全可行时实际执行命令;记录具体症状而非模糊评价;按开发者影响×频率×置信度÷成本排序;优先移除和简化;重新运行受影响的流程验证;最后移除陈旧说明与临时辅助。
硬性规则包括:结论必须有仓库产物、命令、输出或观察到的流程作证据,区分 TESTED、VERIFIED、INFERRED;常用任务只保留一个推荐路径并附合理默认值;不越界执行部署、发布、推送、破坏性迁移、删除数据或暴露凭据;不把它变成通用的安全、架构、性能或 DevOps 成熟度审计;除非用户要求,否则不使用数值 DX 评分。每条发现需包含流程、观察到的摩擦、证据、影响与频率、建议改进、实施成本、置信度与来源方法。若 readme-first 可用,可与其组合进行主 README 重写。资料未提供具体安装命令、定价或平台限制。