Self-Evolved dev-tools
📖 技能介紹
name: "dev-toolkit-pro" description: "全功能開發工具箱：Git/腳手架/CI-CD/測試/規範管理/程式碼審查/技術債務/依賴分析" metadata: openclaw: emoji: "🔧" version: "2.2.1" author: "墨魚精@g1776933879" tags: ["dev", "git", "scaffold", "ci-cd", "testing", "code-review"]
🔧 Dev Toolkit Pro — 全功能開發工具箱
slug:
dev-toolkit-pro| 安裝:clawhub install @g1776933879/dev-toolkit-pro一鍵部署:bash install.sh（自動安裝 prettier + flake8 + black）
模組總覽
| 模組 | 子命令 | 說明 |
|---|---|---|
| 🪪 Git助手 | git |
提交/分支/PR/回滾 |
| 🏗️ 腳手架 | scaffold |
專案初始化/模板生成 |
| 🚀 CI/CD | build |
構建/部署/Docker |
| 🧪 測試 | test |
測試執行/覆蓋率/質量檢查 |
| ✨ 格式化 | fmt |
程式碼格式化/lint修復 |
| 🔍 程式碼審查 | review |
預提交檢查/深度審查 |
| 📐 規範管理 | spec |
專案規範定製/衝突檢測 |
| 🩺 錯誤診斷 | diag |
構建/執行時錯誤分析 |
| 💳 技術債務 | debt |
債務跟蹤/報告生成 |
| 🔗 依賴分析 | dep |
依賴圖譜/迴圈依賴/邊界檢查 |
| 📊 差異對比 | diff |
程式碼變更視覺化 |
| 🛠️ 重構助手 | refactor |
重構建議/方案生成 |
1. 🪪 Git 助手
自動提交
dev-tk git commit "feat: 新增使用者登入"
dev-tk git commit "fix: 修復空指標"
型別: feat / fix / docs / style / refactor / test / chore
分支管理
dev-tk git branch # 列出分支，提示合併/刪除
dev-tk git squash # 互動式rebase壓縮提交
dev-tk git pr # 建立PR（需gh CLI）
安全回滾
- 用
git stash儲存當前工作 - 用
git revert代替git reset --hard
2. 🏗️ 腳手架
快速初始化
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. 🚀 構建與部署
dev-tk build # 自動檢測語言並構建
dev-tk build --docker # Docker構建
dev-tk deploy # 部署檢查清單
部署檢查
- [ ] 構建成功
- [ ] 測試通過
- [ ] lint無錯誤
- [ ] 版本號已更新
- [ ] CHANGELOG更新
- [ ] 確認部署目標
4. 🧪 測試工具
dev-tk test # 執行測試
dev-tk test --coverage # 覆蓋率報告
dev-tk test --watch # 監聽模式
質量標準
- 覆蓋率 ≥ 80%
- 無
.skip跳過測試 - 測試命名規範
- 公共函式必須測試
5. ✨ 格式化
dev-tk fmt # 全量格式化
dev-tk fmt --check # 僅檢查不修改
自動檢測專案型別並格式化： - JS/TS: prettier + eslint - Python: black + isort - Go: gofmt - Rust: rustfmt
6. 🔍 預提交審查（pre-commit）
觸發
dev-tk review # 審查當前修改
dev-tk review src/ # 審查指定目錄
P0 檢查（必須通過）
- ✅ 編譯/語法通過
- ✅ 無嚴重安全問題
- ✅ 無嚴重空指標風險
- ✅ 測試通過率 100%
- ✅ 無敏感資訊洩露
P1 檢查（推薦通過）
- ⚠️ 程式碼規範遵循
- ⚠️ 覆蓋率 > 80%
- ⚠️ 無重複程式碼
- ⚠️ 提交資訊規範
輸出示例
🔍 預提交檢查
P0: ✅✅✅✅✅ (5/5)
P1: ✅✅✅⚠️✅ (4/5)
結論: ✅ 可以提交 (建議提升覆蓋率至80%)
7. 📐 規範管理（spec）
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）
dev-tk diag # 診斷最近錯誤
dev-tk diag --cmd "npm run build" # 診斷指定命令
診斷流程
- 收集錯誤資訊（命令、錯誤輸出、上下文）
- 分析可能原因（帶機率評估）
- 執行診斷步驟（逐步排查）
- 給出診斷結論 + 修復方案
9. 💳 技術債務（debt）
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）
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）
dev-tk diff # 對比工作區變更
dev-tk diff --staged # 暫存區變更
dev-tk diff --commit=HEAD~1 # 最近提交
dev-tk diff --file=main.js # 指定檔案
報告內容
小蔥技能7w4.net持續更新中。
- 概覽（新增/修改/刪除檔案數、行數統計）
- 檔案變更詳情（每檔案diff摘要）
- 影響分析（影響模組、介面數、風險等級）
輸出檔案: docs/diff/YYYY-MM-DD-diff-report.md
12. 🛠️ 重構助手（refactor）
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
## 🛠️ 內建工具指令碼
技能包含 `scripts/` 和 `bin/` 目錄下的 CLI 工具：
```bash
cd scripts/
node dev-tk.js review # 預提交檢查（P0/P1檢查項）
node dev-tk.js fmt # 格式化程式碼
node dev-tk.js dep # 依賴分析
node dev-tk.js debt list # 技術債務清單
node dev-tk.js debt add "描述" # 新增債務
node dev-tk.js scaffold <名> <型> # 腳手架（node/python/vue）
也可以直接用 bin/dev-tk 入口：
bin/dev-tk review
bin/dev-tk dep
bin/dev-tk scaffold my-app node
注意事項
- 所有檔案寫入前確保目標目錄已存在
- 每個子命令單獨執行，不要合併在一個命令中
- diff/refactor/dep 的文件輸出放在
docs/下 - spec 的配置檔案放在
.ads/下 - 標記為子命令的引數要準確解析
```
🤖 AI 評測
這個開發工具箱功能覆蓋面廣，但完成度參差不齊。文件看起來很專業，列出了很多實用功能，但在實際使用時會發現不少功能點沒有真正實現。對於需要腳手架生成、程式碼格式化、依賴檢查等基礎功能的開發者來說有一定幫助，但如果你期望使用文件中提到的 Git 分支管理、錯誤診斷、程式碼差異對比等功能，可能會失望。建議先用小專案測試一下實際可用範圍，避免在正式專案中遇到未實現的功能導致流程中斷。
