项目简介

MyClaudeFlowSetup 是一个为AI驱动开发而设计的先进系统蓝图。它结合了 Claude Flow 多智能体编排框架和 Serena MCP 语义代码分析工具,旨在实现企业级的AI辅助开发。该仓库预配置了43+专业的博士级研究智能体、通用搜索算法 (USACF) 以及Serena MCP提供的符号级代码理解与操作能力,旨在显著提升AI开发效率和代码质量。

主要功能点

  • 多智能体编排: 利用Claude Flow框架,协调多个专业智能体(如商业研究、渗透测试、博士研究、战略销售等)并行或串行执行复杂的开发任务。
  • 语义代码分析 (Serena MCP): Serena MCP作为核心MCP服务器组件,提供类似IDE的功能,对30多种编程语言进行符号级代码导航、精确编辑、引用追踪和结构化分析,支持LLM直接操作代码。
  • 通用搜索算法 (USACF): 一套博士级研究方法论,用于复杂代码库分析、商业策略研究、安全审计等,涵盖多维度分析、不确定性量化、RAG集成、对抗性验证和元学习。
  • PRD到规范转换: 提供AI-Agent规范开发指南,将产品需求文档 (PRD) 自动转化为AI智能体可执行的、结构化的技术规范。
  • AI驱动的文件模块化: 智能地将大型、复杂的代码文件重构为清洁、可维护的模块化架构,同时确保100%向后兼容性,并显著提高代码质量。
  • 内存协调与神经训练: 智能体间可共享跨会话持久化内存,并通过学习成功的操作模式进行自我改进和“神经训练”。

安装步骤

  1. 克隆仓库: 首先,将此蓝图仓库克隆到您的本地机器:
    git clone https://github.com/ChrisRoyse/myclaudeflowsetup.git
    cd myclaudeflowsetup
  2. 安装必要工具:
    • Claude Code CLI: 这是与系统交互的客户端命令行工具。 'npm install -g @anthropics/claude-code'
    • UV (用于Serena MCP): Serena MCP的依赖管理工具。 'curl -LsSf https://astral.sh/uv/install.sh | sh'
  3. 初始化系统:
    • Claude Code CLI 中,输入以下指令。这会引导Claude Code自动配置和初始化所有必要的MCP服务器和系统,包括Serena MCP: '"Please ensure all MCP systems are properly configured: 1. Verify Serena MCP is working correctly and can access language servers 2. Initialize AgentDB for vector-based memory storage 3. Verify the memory coordination system is fully functional 4. Confirm all MCP servers (claude-flow, ruv-swarm, serena) are connected Please run any necessary setup commands and verify everything is operational."'
    • 初始化完成后,打开一个新的终端 并运行 '/mcp' 命令,验证 'claude-flow'、'ruv-swarm' 和 'serena' 服务器是否已成功连接并正常工作。

服务器配置 (Serena MCP)

Serena MCP 服务器的设计旨在与 MCP 客户端(例如 Claude Code CLI)无缝集成。MCP 客户端在启动或连接到 Serena MCP 服务器时,需要了解服务器的名称、启动命令及其所需的参数。这些配置通常由 MCP 客户端自动处理,用户无需手动编辑复杂的 JSON 配置文件。

以下是 MCP 客户端在内部连接 Serena MCP 服务器时可能用到的关键信息:

  • 服务器名称: 'serena'
  • 启动命令: 通常由 'uvx' 工具执行。
  • 命令参数:
    • '--from git+https://github.com/oraios/serena': 指示 'uvx' 从 Serena 的 GitHub 仓库获取并运行服务器。
    • 'serena': 调用 Serena 内部用于启动服务的入口点。
    • 'start-mcp-server': 明确指令 Serena 启动其 MCP 服务器功能。

这些信息确保 MCP 客户端能够找到并正确启动 Serena MCP 服务器,进而利用其提供的语义代码分析工具。用户只需按照上述“安装步骤”中的指示,在 Claude Code CLI 中执行初始化命令即可。

基本使用方法

在 Claude Code CLI 中,您可以根据需求通过引用仓库中的配置文档和智能体来驱动AI工作流:

  1. 始终引用核心配置: 在任何项目开始时,务必在提示中引用 'docs2/claudeflow.md' 文件,它包含了项目运行的关键指南和优化策略: '"Please read docs2/claudeflow.md and follow all instructions within it for this project."'
  2. 使用Serena MCP工具进行代码操作: 当需要进行精确的代码分析、导航或修改时,可以调用Serena提供的MCP工具。这些工具以 'mcp__serena__' 为前缀,例如: '"Use mcp__serena__find_symbol to locate the 'DemoClass/printValue' in 'index.ts'"'
  3. 协调智能体执行任务: 结合不同的专业智能体系统(如 'phdresearch' 智能体用于研究、'coder' 智能体用于编码),并遵循文档中描述的并行/串行执行模式来完成复杂任务: '"Implement the new feature: 1. Use the 'research-agent' to gather requirements. 2. Use 'coder' to implement. 3. Use 'tester' to create unit tests. All steps should follow the guidelines in docs2/claudeflow.md"'

信息

分类

开发者工具