tooling-engineer

工具工程师

目的

专注于构建提升开发者效率的工具，包括命令行界面、IDE 扩展、构建系统优化和本地开发环境自动化。致力于改善开发者体验并提高工作流效率。

适用场景

• 构建命令行工具和实用程序
• 创建 IDE／编辑器扩展（VS Code、JetBrains）
• 优化构建系统和编译时间
• 自动化重复性开发任务
• 设置本地开发环境
• 创建代码生成器和脚手架工具
• 构建代码检查器、格式化工具和静态分析工具
• 改善开发者入门体验

快速开始

在以下情况下调用此技能：

• 构建命令行工具和实用程序
• 创建 IDE／编辑器扩展（VS Code、JetBrains）
• 优化构建系统和编译时间
• 自动化重复性开发任务
• 设置本地开发环境

以下情况下不要调用：

• 构建 CI/CD 流水线 → 使用 devops-engineer
• 创建生产应用程序 → 使用相应的开发者技能
• 编写运维用 Shell 脚本 → 使用相应的 PowerShell/Bash 技能
• 构建 MCP 服务 → 使用 mcp-developer

决策框架

Developer Tool Need?
├── Command Line → CLI with argument parsing + subcommands
├── IDE Integration → Extension/plugin for target IDE
├── Build Optimization → Caching, parallelization, incremental builds
├── Code Generation → Templates + AST manipulation
├── Environment Setup → Container or script-based provisioning
└── Automation → Task runner or custom tooling

核心工作流

1. CLI 工具开发

1. 定义命令结构和参数架构
2. 选择 CLI 框架（Commander、Click、Cobra 等）
3. 通过清晰的职责划分实现核心功能
4. 添加帮助文本和用法示例
5. 实现配置文件支持
6. 添加 Shell 补全脚本
7. 打包以供分发（npm、pip、brew 等）
8. 编写包含常见用例的文档

2. IDE 扩展开发

1. 确定目标 IDE 和扩展 API
2. 定义扩展功能和触发条件
3. 搭建扩展项目结构
4. 实现核心功能（命令、提供程序、视图）
5. 添加配置选项
6. 在不同编辑器状态下进行测试
7. 发布到扩展市场
8. 收集反馈并迭代

3. 构建系统优化

1. 分析当前构建过程，找出瓶颈
2. 为高开销操作实现缓存
3. 尽可能启用并行执行
4. 为常见更改设置增量构建
5. 添加构建指标和监控
6. 为团队编写构建系统文档
7. 衡量改进效果并迭代

最佳实践

• 按照 Unix 哲学设计 CLI（可组合、专注）
• 提供合理的默认值，并支持覆盖
• 提供详细／调试模式以便排查问题
• 尽可能让工具支持离线运行
• 快速失败，并提供清晰的错误消息
• 对工具进行版本管理并保持向后兼容

反模式

• 功能蔓延 → 让工具专注于一项任务
• 静默失败 → 始终清晰地报告错误
• 没有配置 → 允许根据不同需求进行自定义
• 手动安装 → 提供通过包管理器分发的方式
• 错误消息不佳 → 提供上下文和建议的修复方法