back
loading skill details...
全功能开发工具箱：Git/脚手架/CI-CD/测试/规范管理/代码审查/技术债务/依赖分析
---
name: "dev-tools"
description: "全功能开发工具箱：Git/脚手架/CI-CD/测试/规范管理/代码审查/技术债务/依赖分析"
metadata:
openclaw:
emoji: "🔧"
version: "2.0.0"
author: "墨鱼精@g1776933879"
tags: ["dev", "git", "scaffold", "ci-cd", "testing", "code-review"]
---
# 🔧 Dev Toolkit — 全功能开发工具箱
## 模块总览
| 模块 | 子命令 | 说明 |
|------|--------|------|
| 🪪 Git助手 | `git` | 提交/分支/PR/回滚 |
| 🏗️ 脚手架 | `scaffold` | 项目初始化/模板生成 |
| 🚀 CI/CD | `build` | 构建/部署/Docker |
| 🧪 测试 | `test` | 测试运行/覆盖率/质量检查 |
| ✨ 格式化 | `fmt` | 代码格式化/lint修复 |
| 🔍 代码审查 | `review` | 预提交检查/深度审查 |
| 📐 规范管理 | `spec` | 项目规范定制/冲突检测 |
| 🩺 错误诊断 | `diag` | 构建/运行时错误分析 |
| 💳 技术债务 | `debt` | 债务跟踪/报告生成 |
| 🔗 依赖分析 | `dep` | 依赖图谱/循环依赖/边界检查 |
| 📊 差异对比 | `diff` | 代码变更可视化 |
| 🛠️ 重构助手 | `refactor` | 重构建议/方案生成 |
---
## 1. 🪪 Git 助手
### 自动提交
```bash
dev-tk git commit "feat: 添加用户登录"
dev-tk git commit "fix: 修复空指针"
```
类型: `feat` / `fix` / `docs` / `style` / `refactor` / `test` / `chore`
### 分支管理
```bash
dev-tk git branch # 列出分支，提示合并/删除
dev-tk git squash # 交互式rebase压缩提交
dev-tk git pr # 创建PR（需gh CLI）
```
### 安全回滚
- 用 `git stash` 保存当前工作
- 用 `git revert` 代替 `git reset --hard`
---
## 2. 🏗️ 脚手架
### 快速初始化
```bash
dev-tk scaffold my-app node
dev-tk scaffold my-api python
dev-tk scaffold my-web vue --typescript --with-tests --with-ci
```
### 生成模板
| 语言 | 模板内容 |
|------|---------|
| Node.js | package.json, src/, test/, .gitignore, eslint |
| Python | pyproject.toml, src/, tests/, .venv, .gitignore |
| Vue/React | Vite配置, src/, test/, TS支持 |
| Go | go.mod, main.go, handlers/, tests/ |
---
## 3. 🚀 构建与部署
```bash
dev-tk build # 自动检测语言并构建
dev-tk build --docker # Docker构建
dev-tk deploy # 部署检查清单
```
### 部署检查
- [ ] 构建成功
- [ ] 测试通过
- [ ] lint无错误
- [ ] 版本号已更新
- [ ] CHANGELOG更新
- [ ] 确认部署目标
---
## 4. 🧪 测试工具
```bash
dev-tk test # 运行测试
dev-tk test --coverage # 覆盖率报告
dev-tk test --watch # 监听模式
```
### 质量标准
- 覆盖率 ≥ 80%
- 无 `.skip` 跳过测试
- 测试命名规范
- 公共函数必须测试
---
## 5. ✨ 格式化
```bash
dev-tk fmt # 全量格式化
dev-tk fmt --check # 仅检查不修改
```
自动检测项目类型并格式化：
- JS/TS: prettier + eslint
- Python: black + isort
- Go: gofmt
- Rust: rustfmt
---
## 6. 🔍 预提交审查（pre-commit）
### 触发
```bash
dev-tk review # 审查当前修改
dev-tk review src/ # 审查指定目录
```
### P0 检查（必须通过）
- ✅ 编译/语法通过
- ✅ 无严重安全问题
- ✅ 无严重空指针风险
- ✅ 测试通过率 100%
- ✅ 无敏感信息泄露
### P1 检查（推荐通过）
- ⚠️ 代码规范遵循
- ⚠️ 覆盖率 > 80%
- ⚠️ 无重复代码
- ⚠️ 提交信息规范
### 输出示例
```
🔍 预提交检查
P0: ✅✅✅✅✅ (5/5)
P1: ✅✅✅⚠️✅ (4/5)
结论: ✅ 可以提交 (建议提升覆盖率至80%)
```
---
## 7. 📐 规范管理（spec）
```bash
dev-tk spec # 查看规范菜单
dev-tk spec view # 查看当前规范
dev-tk spec customize # 定制项目规范
dev-tk spec conflict # 检测规范冲突
```
### 定制内容
- 命名规范（camelCase / snake_case）
- 代码格式（缩进、引号、分号）
- 注释规范（JSDoc / docstring）
- 技术栈规范
- 目录结构规范
**输出文件**: `.ads/project-specs/naming.md` `.ads/project-specs/code-style.md`
---
## 8. 🩺 错误诊断（diag）
```bash
dev-tk diag # 诊断最近错误
dev-tk diag --cmd "npm run build" # 诊断指定命令
```
### 诊断流程
1. 收集错误信息（命令、错误输出、上下文）
2. 分析可能原因（带概率评估）
3. 执行诊断步骤（逐步排查）
4. 给出诊断结论 + 修复方案
---
## 9. 💳 技术债务（debt）
```bash
dev-tk debt # 查看债务菜单
dev-tk debt list # 列出债务
dev-tk debt add # 添加债务
dev-tk debt report # 生成报告
dev-tk debt fix TD-001 # 标记已修复
```
### 报告内容
- 债务清单（ID/描述/优先级/状态/预计工时）
- 按优先级分组
- 修复建议（按优先级排序）
- 趋势追踪
**输出文件**: `docs/tech-debt/YYYY-MM-DD-debt-report.md`
---
## 10. 🔗 依赖分析（dep）
```bash
dev-tk dep # 完整依赖分析
dev-tk dep --check-cycle # 仅检查循环依赖
dev-tk dep --check-boundary # 仅检查边界违规
dev-tk dep --module=order-service # 指定模块
dev-tk dep --format=mermaid # 输出图谱
```
### 分析维度
| 维度 | 检查项 | 级别 |
|------|--------|------|
| 模块依赖 | 循环依赖、单向依赖 | 🔴 |
| 服务边界 | 跨服务数据库访问 | 🔴 |
| 包依赖 | 不合理依赖 | 🟡 |
| 类依赖 | 高耦合 | 🔵 |
**输出文件**: `docs/analysis/dependencies.md`
---
## 11. 📊 差异对比（diff）
```bash
dev-tk diff # 对比工作区变更
dev-tk diff --staged # 暂存区变更
dev-tk diff --commit=HEAD~1 # 最近提交
dev-tk diff --file=main.js # 指定文件
```
### 报告内容
- 概览（新增/修改/删除文件数、行数统计）
- 文件变更详情（每文件diff摘要）
- 影响分析（影响模块、接口数、风险等级）
**输出文件**: `docs/diff/YYYY-MM-DD-diff-report.md`
---
## 12. 🛠️ 重构助手（refactor）
```bash
dev-tk refactor # 生成重构建议
dev-tk refactor --scope=points-service # 指定模块
dev-tk refactor --type=performance,safety # 指定类型
dev-tk refactor --apply=RF-001 # 应用指定建议
```
### 重构类型
| 类型 | 触发条件 | 建议动作 |
|------|---------|---------|
| code smell | 重复代码、过长方法 | 提取方法/类 |
| architecture | 循环依赖、边界违规 | 解耦、分层调整 |
| performance | N+1查询、循环内IO | 批量查询、缓存 |
| security | SQL注入、泄露 | 参数化查询、加密 |
**输出文件**: `docs/refactor/YYYY-MM-DD-refactor-suggest.md`
---
## 使用示例
```
用户: "帮我搭个Node项目"
→ dev-tk scaffold my-app node
用户: "检查代码能不能提交"
→ dev-tk review → 预提交检查
用户: "分析一下这个项目的依赖关系"
→ dev-tk dep --format=mermaid
用户: "git提交，feat: 添加登录功能"
→ dev-tk git commit "feat: 添加登录功能"
用户: "格式化所有代码"
→ dev-tk fmt
用户: "看看有哪些技术债务"
→ dev-tk debt list
用户: "构建并测试"
→ dev-tk build && dev-tk test
```
## 注意事项
- 所有文件写入前确保目标目录已存在
- 每个子命令单独执行，不要合并在一个命令中
- diff/refactor/dep 的文档输出放在 `docs/` 下
- spec 的配置文件放在 `.ads/` 下
- 标记为子命令的参数要准确解析
don't have the plugin yet? install it then click "run inline in claude" again.