Code Hug
Code Hug 是一個先進的 AI 驅動的軟體開發工作流編排器,提供全面的端到端專案管理能力。基於六層控制系統構建,它無縫集成了程式碼考古學、商業智慧提取和智慧工作流自動化。
核心能力
智慧工作流編排
- 端到端流水線: 需求分析 → 功能分解 → 程式碼實現 → 整合驗證 → 部署準備
- 質量門禁: 可配置的 YAML 准入/準出標準驗證
- 會話管理: 完整的審計軌跡和決策日誌
- 成果物管理: 各階段產出物的自動歸檔和版本跟蹤
高階程式碼分析與商業智慧
- 業務規則提取: 自動發現和記錄嵌入的業務邏輯
- PRD生成: 從程式碼實現反向工程生成產品需求
- 工作流對映: 提取和視覺化端到端業務流程
- 資料模型分析: 發現實體關係和資料流
- 多語言支援: 全面支援 Java、JavaScript/TypeScript、Python、PHP 和 Vue.js 專案
智慧診斷與自動修復
- 失敗分析: 支援 Java 和 JavaScript/TypeScript 專案失敗診斷
- 自動修復: 構建配置、依賴衝突、編譯錯誤
- 智慧建議: 上下文感知的程式碼改進建議
- 安全控制: 內建安全檢查和回滾機制
系統要求
執行時依賴
- Python 3.10+: 核心編排引擎
- Node.js 18+: JavaScript/TypeScript 分析能力
- Java: Java 專案分析和編譯支援
- Git: 版本控制整合
- Bash: 系統命令執行
安裝驗證
# Python 依賴
pip install PyYAML requests python-dotenv
# 驗證安裝
python3 -c "import yaml; print('OK')"
node --version
java -version
可用工具
| 工具 |
描述 |
引數 |
codehug:start_session |
啟動新的工作流會話 |
project_name, project_root, tech_stack |
codehug:run_stage |
執行指定階段 |
session_id, stage, context |
codehug:diagnose |
診斷構建/測試失敗 |
session_id, build_log, test_log |
codehug:auto_fix |
嘗試自動修復問題 |
session_id, problem_type, project_root |
codehug:validate |
執行整合驗證 |
session_id, project_root, test_cases |
codehug:get_status |
獲取當前會話狀態 |
session_id |
codehug:extract_business_rules |
從程式碼庫提取業務規則 |
project_root, output_format |
codehug:generate_prd |
生成PRD文件 |
project_root, business_context |
codehug:map_workflows |
對映業務工作流 |
project_root, workflow_types |
配置
在 ~/.openclaw/config.json 中新增:
{
"skills": {
"code-hug": {
"project_root": "/path/to/your/project",
"auto_fix_enabled": true,
"max_fix_attempts": 3,
"enable_safety_checks": true,
"enable_rollback": true,
"notification_channels": ["webchat", "email"],
"business_intelligence_enabled": true
}
}
}
配置選項
| 選項 |
型別 |
預設值 |
描述 |
project_root |
string |
必填 |
專案根目錄 |
auto_fix_enabled |
boolean |
true |
啟用自動修復 |
max_fix_attempts |
integer |
3 |
最大自動修復嘗試次數 |
enable_safety_checks |
boolean |
true |
啟用安全驗證 |
enable_rollback |
boolean |
true |
啟用回滾機制 |
notification_channels |
array |
["webchat"] |
通知渠道 |
business_intelligence_enabled |
boolean |
true |
啟用商業智慧提取 |
使用示例
1. 啟動新會話
/codehug:start_session {
"project_name": "membership-service",
"project_root": "/Users/dev/projects/membership-service",
"tech_stack": ["Java 17", "Spring Boot 3", "MySQL 8"]
}
2. 執行需求分析(包含商業智慧)
/codehug:run_stage {
"session_id": "membership-service-001",
"stage": "requirements_analysis",
"context": {
"business_context_provided": true,
"success_metrics_defined": true,
"stakeholder_identified": true,
"extract_business_rules": true,
"generate_prd": true
}
}
3. 提取業務規則
/codehug:extract_business_rules {
"project_root": "/Users/dev/projects/membership-service",
"output_format": "markdown"
}
4. 診斷構建失敗
/codehug:diagnose {
"session_id": "membership-service-001",
"build_log": "[ERROR] COMPILATION ERROR: cannot find symbol...",
"test_log": ""
}
5. 自動修復
/codehug:auto_fix {
"session_id": "membership-service-001",
"problem_type": "compilation_error",
"project_root": "/Users/dev/projects/membership-service"
}
階段定義
| 階段 |
准入標準 |
準出標準 |
產出物 |
requirements_analysis |
業務背景、成功指標、干係人 |
PRD完整性≥0.8、干係人批准、技術可行性確認 |
prd.md, business_rules.json |
functional_decomposition |
PRD批准、架構約束、技術棧 |
技術規格完整性≥0.9、API契約驗證、資料庫Schema評審 |
tech_spec.md, api_contracts.json |
code_implementation |
技術規格批准、編碼規範、開發環境 |
單元測試覆蓋率≥80%、靜態分析通過、程式碼評審≥0.85 |
source_code/, test_coverage.json |
integration_validation |
程式碼批准、構建指令碼、測試環境 |
構建成功、整合測試通過、冒煙測試通過 |
test_results.json, integration_report.md |
deployment_preparation |
整合驗證批准、部署指令碼、回滾計劃 |
部署包驗證、生產就緒確認、監控配置 |
deployment_plan.md, production_checklist.md |
支援的專案型別
- ✅ Java: Maven/Gradle 專案、Spring Boot、Java EE
- ✅ JavaScript/TypeScript: npm/yarn/pnpm、Node.js、React、Vue.js
- ✅ Python: Django、Flask、資料科學專案
- ✅ PHP: 遺留企業應用、現代框架
- ✅ 混合專案: 多語言微服務架構
問題型別與自動修復支援
| 問題型別 |
描述 |
自動修復支援 |
build_configuration |
構建配置錯誤(Java版本、Maven/Gradle配置) |
✅ 完全支援 |
dependency_conflict |
依賴衝突、版本不相容 |
✅ 完全支援 |
compilation_error |
編譯錯誤、語法錯誤、符號未找到 |
✅ 完全支援 |
test_failure |
單元/整合測試失敗 |
⚠️ 部分支援 |
runtime_error |
執行時錯誤(空指標、記憶體溢位) |
⚠️ 建議性修復 |
environment_issue |
環境問題(許可權、磁碟空間、網路) |
⚠️ 建議性修復 |
business_rule_violation |
違反提取的業務規則 |
✅ 完全支援 |
錯誤處理
常見錯誤碼
| 錯誤碼 |
描述 |
解決方案 |
SESSION_NOT_FOUND |
會話不存在 |
驗證 session_id |
STAGE_INVALID |
階段名稱無效 |
檢查階段是否在定義列表中 |
ENTRY_CRITERIA_NOT_MET |
不滿足准入標準 |
驗證上下文先決條件 |
EXIT_CRITERIA_NOT_MET |
不滿足準出標準 |
完成所需產出物 |
AUTO_FIX_FAILED |
自動修復失敗 |
檢視日誌,考慮手動干預 |
VALIDATION_FAILED |
整合驗證失敗 |
檢查構建日誌和測試報告 |
審計日誌
所有操作都會記錄到審計軌跡中:
{
"timestamp": "2026-03-24T12:50:00Z",
"action": "stage_completed",
"actor": "code-hug",
"details": {
"session_id": "membership-service-001",
"stage": "requirements_analysis",
"artifact": "/path/to/prd.md",
"business_rules_extracted": true
}
}
與程式碼考古學整合
Code Hug 與程式碼考古學技能無縫整合,提供:
- 增強的商業智慧: 更深入的業務規則提取和PRD生成
- 全面分析: 結合技術和業務視角
- 智慧工作流: 業務感知的工作流編排
- 統一報告: 整合的技術和業務評估報告
小蔥技能站7w4.net發現了升級外掛。
最佳實踐
- 漸進式採用: 從單個階段開始,再啟用完整流水線
- 安全第一: 始終啟用安全檢查和回滾機制
- 業務上下文: 提供豐富的業務上下文以獲得更好的智慧提取
- 定期驗證: 與領域專家驗證假設和提取的規則
- 持續改進: 使用審計日誌最佳化工作流配置
版本歷史
| 版本 |
日期 |
變更 |
| 1.0.0 |
2026-03-24 |
初始釋出,從 workflow-orchestrator 演化而來,增強了商業智慧能力 |