code-hug（代码 HUG）

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

可用工具

配置

在 ~/.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
    }
  }
}

配置选项

使用示例

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

阶段定义

支持的项目类型

• ✅ Java: Maven/Gradle 项目、Spring Boot、Java EE
• ✅ JavaScript/TypeScript: npm/yarn/pnpm、Node.js、React、Vue.js
• ✅ Python: Django、Flask、数据科学项目
• ✅ PHP: 遗留企业应用、现代框架
• ✅ 混合项目: 多语言微服务架构

问题类型与自动修复支持

错误处理

常见错误码

审计日志

所有操作都会记录到审计轨迹中:

{
  "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生成
• 全面分析: 结合技术和业务视角
• 智能工作流: 业务感知的工作流编排
• 统一报告: 集成的技术和业务评估报告

最佳实践

• 渐进式采用: 从单个阶段开始，再启用完整流水线
• 安全第一: 始终启用安全检查和回滚机制
• 业务上下文: 提供丰富的业务上下文以获得更好的智能提取
• 定期验证: 与领域专家验证假设和提取的规则
• 持续改进: 使用审计日志优化工作流配置

版本历史