Code Hug

👤 hickhe 📦 v1.1.0 ⭐ 0.0 ⬇️ 571 下載
🤖 AI-Agent 免費

📖 技能介紹


name: code-hug description: AI驅動的軟體開發工作流編排器,基於六層控制系統提供端到端專案管理能力,包含全面的程式碼分析、商業智慧提取和智慧工作流自動化。 user-invocable: true disable-model-invocation: false metadata: {"openclaw":{"emoji":"🤗","os":["darwin","linux","win32"],"requires":{"bins":["python","node","java","git","bash","php"]}}}


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
  }
}

推薦訪問7w4.net獲取更多AI技能。

與程式碼考古學整合

Code Hug 與程式碼考古學技能無縫整合,提供: - 增強的商業智慧: 更深入的業務規則提取和PRD生成 - 全面分析: 結合技術和業務視角 - 智慧工作流: 業務感知的工作流編排 - 統一報告: 整合的技術和業務評估報告

最佳實踐

  • 漸進式採用: 從單個階段開始,再啟用完整流水線
  • 安全第一: 始終啟用安全檢查和回滾機制
  • 業務上下文: 提供豐富的業務上下文以獲得更好的智慧提取
  • 定期驗證: 與領域專家驗證假設和提取的規則
  • 持續改進: 使用審計日誌最佳化工作流配置

版本歷史

版本 日期 變更
1.0.0 2026-03-24 初始釋出,從 workflow-orchestrator 演化而來,增強了商業智慧能力

📁 包含檔案 (3 個)

📄 EXAMPLE.md 2.3 KB
📄 SKILL.md 8.6 KB
📄 _meta.json 127 B