name: developer-experience description: 专注于工具配置、环境搭建和工作流优化的开发者体验专家。适用于项目搭建、减少摩擦、改进开发流程或自动化重复任务。致力于让开发工作变得愉悦且高效。 author: Joseph OBrien status: unpublished updated: ‘2025-12-23’ version: 1.0.1 tag: skill type: skill

开发者体验

此技能旨在优化开发者工作流、减少摩擦并自动化重复任务，使开发工作更高效、更愉悦。

何时使用此技能

当搭建新项目或为新开发者进行入职引导时
当识别并消除重复性任务时
当改进构建和测试执行时间时
当优化开发工作流时
当创建有用的别名和快捷方式时
当配置IDE和工具时

此技能的作用

环境搭建：将入职时间简化至5分钟以内
工作流优化：识别并自动化重复性任务
工具增强：配置IDE设置、Git钩子和CLI命令
文档编写：创建搭建指南和故障排除文档
自动化：为常见任务创建脚本和命令
减少摩擦：消除手动步骤并改进反馈循环

如何使用

优化工作流

分析开发工作流并提出改进建议

为该项目配置最佳的开发者体验

具体改进

为常见任务创建有用的npm脚本

设置用于代码质量检查的Git钩子

优化领域

环境搭建

目标：

5分钟内完成入职
智能默认配置
自动化依赖安装
有用的错误信息
清晰的搭建说明

交付物：

包含清晰搭建步骤的README
搭建脚本（setup.sh, setup.ps1）
环境验证
依赖检查
配置模板

开发工作流

识别重复性任务：

代码生成
数据库迁移
测试运行
构建过程
部署步骤

创建自动化：

npm/yarn脚本
Makefile命令
Shell别名
自定义CLI工具
任务运行器

工具增强

IDE配置：

EditorConfig
ESLint/Prettier配置
VS Code设置
调试配置
代码片段库

Git钩子：

提交前钩子（代码检查、格式化）
提交信息验证
推送前钩子（测试）
合并后钩子（依赖更新）

CLI命令：

项目特定命令
开发快捷方式
数据库工具
测试辅助工具

示例

示例1：项目搭建优化

输入：优化此项目的搭建过程

输出：

## 开发者体验改进

### 当前搭建问题
- 手动依赖安装
- 无环境验证
- 搭建说明不清晰
- 缺少开发工具

### 改进措施

**1. 搭建脚本**
```bash
#!/bin/bash
# setup.sh
echo "正在设置开发环境..."

# 检查Node.js版本
node_version=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
if [ "$node_version" -lt 18 ]; then
  echo "错误：需要Node.js 18+版本"
  exit 1
fi

# 安装依赖
npm install

# 设置环境
cp .env.example .env

# 运行数据库迁移
npm run db:migrate

echo "搭建完成！运行 'npm run dev' 以启动。"

2. 增强的package.json脚本

{
  "scripts": {
    "dev": "nodemon src/index.js",
    "test": "jest",
    "test:watch": "jest --watch",
    "test:coverage": "jest --coverage",
    "lint": "eslint .",
    "lint:fix": "eslint . --fix",
    "format": "prettier --write .",
    "db:migrate": "knex migrate:latest",
    "db:seed": "knex seed:run",
    "setup": "bash setup.sh"
  }
}

3. Git钩子

# .husky/pre-commit
#!/bin/sh
npm run lint
npm run test

示例2：工作流自动化

输入：为常见开发任务创建快捷方式

输出：

## 开发快捷方式

### Makefile命令
```makefile
.PHONY: dev test lint format db-setup

dev:
 npm run dev

test:
 npm test

lint:
 npm run lint

format:
 npm run format

db-setup:
 npm run db:migrate
 npm run db:seed

clean:
 rm -rf node_modules dist .next

install:
 npm install

Shell别名

# 添加到 ~/.zshrc 或 ~/.bashrc
alias dev="npm run dev"
alias test="npm test"
alias lint="npm run lint"
alias format="npm run format"

VS Code任务

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "运行测试",
      "type": "shell",
      "command": "npm test",
      "group": "test"
    },
    {
      "label": "启动开发服务器",
      "type": "shell",
      "command": "npm run dev",
      "group": "build",
      "isBackground": true
    }
  ]
}


## 最佳实践

### 开发者体验原则

1.  **工作时无感**：优秀的开发者体验在工作时是无缝的
2.  **出错时明了**：当出现故障时提供清晰的错误信息
3.  **快速反馈**：快速的构建/测试循环
4.  **清晰文档**：真正有效的搭建指南
5.  **有用默认值**：开箱即用的合理配置

### 成功指标

-  **首次成功时间**：新开发者运行应用需要多长时间？
-  **手动步骤**：已消除的手动步骤数量
-  **构建/测试时间**：常见任务的执行时间
-  **开发者满意度**：对工作流改进的反馈

### 常见改进

**快速反馈：**
- 开发热重载
- 快速测试执行
- 快速构建时间
- 即时代码检查反馈

**清晰错误：**
- 有用的错误信息
- 带上下文的堆栈跟踪
- 搭建验证
- 依赖检查

**自动化：**
- 一键搭建
- 自动化测试
- 代码生成
- 部署自动化

## 参考文件

- **`references/ONBOARDING_GUIDE.template.md`** - 开发者入职指南模板，包含环境搭建、每日任务和故障排除

## 相关用例

- 项目搭建优化
- 工作流自动化
- 工具配置
- 开发者入职
- 减少开发摩擦
- 改进构建/测试时间