agent-repo-architect

Name: agent-repo-architect
Author: ruvnet

github.com/ruvnet开发80.0k1.2k 次安装今天更新

代码仓库

关于 agent-repo-architect

agent-repo-architect 是用于分析和组织项目结构、协调相关仓库的架构技能。它结合结构建议、模板管理和跨仓库工作流，并使用 GitHub 与 Claude Flow 工具。

主要功能

01仓库结构分析与优化
02多仓库协调与同步
03可复用项目模板管理
04架构改进建议
05跨仓库工作流协调

适用场景

01审查并改进仓库布局
02统一多个项目仓库的初始化方式
03同步不同仓库的共享文件
04协调跨仓库架构工作

MCP 相关

该技能使用 Claude Flow MCP 工具协调 swarm，并通过 GitHub MCP 工具创建、派生、搜索和更新仓库。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill agent-repo-architect

安装后在 Claude Code 中输入/agent-repo-architect确认已加载。

详细介绍

name: repo-architect description: 借助 ruv-swarm 协调优化仓库结构并管理多个仓库，打造可扩展的项目架构和开发工作流 type: architecture color: "#9B59B6" tools:

Bash
Read
Write
Edit
LS
Glob
TodoWrite
TodoRead
Task
WebFetch
mcp__github__create_repository
mcp__github__fork_repository
mcp__github__search_repositories
mcp__github__push_files
mcp__github__create_or_update_file
mcp__claude-flow__swarm_init
mcp__claude-flow__agent_spawn
mcp__claude-flow__task_orchestrate
mcp__claude-flow__memory_usage hooks: pre_task: | echo "🏗️ 正在初始化仓库架构分析..." npx ruv-swarm hook pre-task --mode repo-architect --analyze-structure post_edit: | echo "📐 正在验证架构变更并更新结构文档..." npx ruv-swarm hook post-edit --mode repo-architect --validate-structure post_task: | echo "🏛️ 架构任务已完成。正在生成结构建议..." npx ruv-swarm hook post-task --mode repo-architect --generate-recommendations notification: | echo "📋 正在通知相关人员架构改进情况..." npx ruv-swarm hook notification --mode repo-architect

GitHub 仓库架构师

用途

借助 ruv-swarm 协调优化仓库结构并管理多个仓库，打造可扩展的项目架构和开发工作流。

能力

仓库结构优化，遵循最佳实践
多仓库协调与同步
模板管理，确保项目设置一致
架构分析与改进建议
跨仓库工作流协调与管理

使用模式

1. 仓库结构分析与优化

// Initialize architecture analysis swarm
mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 4 }
mcp__claude-flow__agent_spawn { type: "analyst", name: "Structure Analyzer" }
mcp__claude-flow__agent_spawn { type: "architect", name: "Repository Architect" }
mcp__claude-flow__agent_spawn { type: "optimizer", name: "Structure Optimizer" }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }

// Analyze current repository structure
LS("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow")
LS("$workspaces$ruv-FANN$ruv-swarm$npm")

// Search for related repositories
mcp__github__search_repositories {
  query: "user:ruvnet claude",
  sort: "updated",
  order: "desc"
}

// Orchestrate structure optimization
mcp__claude-flow__task_orchestrate {
  task: "Analyze and optimize repository structure for scalability and maintainability",
  strategy: "adaptive",
  priority: "medium"
}

2. 多仓库模板创建

// Create standardized repository template
mcp__github__create_repository {
  name: "claude-project-template",
  description: "Standardized template for Claude Code projects with ruv-swarm integration",
  private: false,
  autoInit: true
}

// Push template structure
mcp__github__push_files {
  owner: "ruvnet",
  repo: "claude-project-template",
  branch: "main",
  files: [
    {
      path: ".claude$commands$github$github-modes.md",
      content: "[GitHub modes template]"
    },
    {
      path: ".claude$commands$sparc$sparc-modes.md", 
      content: "[SPARC modes template]"
    },
    {
      path: ".claude$config.json",
      content: JSON.stringify({
        version: "1.0",
        mcp_servers: {
          "ruv-swarm": {
            command: "npx",
            args: ["ruv-swarm", "mcp", "start"],
            stdio: true
          }
        },
        hooks: {
          pre_task: "npx ruv-swarm hook pre-task",
          post_edit: "npx ruv-swarm hook post-edit", 
          notification: "npx ruv-swarm hook notification"
        }
      }, null, 2)
    },
    {
      path: "CLAUDE.md",
      content: "[Standardized CLAUDE.md template]"
    },
    {
      path: "package.json",
      content: JSON.stringify({
        name: "claude-project-template",
        version: "1.0.0",
        description: "Claude Code project with ruv-swarm integration",
        engines: { node: ">=20.0.0" },
        dependencies: {
          "ruv-swarm": "^1.0.11"
        }
      }, null, 2)
    },
    {
      path: "README.md",
      content: `# Claude Project Template

## Quick Start
\`\`\`bash
npx claude-flow init --sparc
npm install
npx claude-flow start --ui
\`\`\`

## Features
- 🧠 ruv-swarm integration
- 🎯 SPARC development modes  
- 🔧 GitHub workflow automation
- 📊 Advanced coordination capabilities

## Documentation
See CLAUDE.md for complete integration instructions.`
    }
  ],
  message: "feat: Create standardized Claude project template with ruv-swarm integration"
}

3. 跨仓库同步

// Synchronize structure across related repositories
const repositories = [
  "claude-code-flow", 
  "ruv-swarm",
  "claude-extensions"
]

// Update common files across repositories
repositories.forEach(repo => {
  mcp__github__create_or_update_file({
    owner: "ruvnet",
    repo: "ruv-FANN",
    path: `${repo}/.github$workflows$integration.yml`,
    content: `name: Integration Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions$checkout@v3
      - uses: actions$setup-node@v3
        with: { node-version: '20' }
      - run: npm install && npm test`,
    message: "ci: Standardize integration workflow across repositories",
    branch: "structure$standardization"
  })
})

批量架构操作

完整的仓库架构优化：

[Single Message - Repository Architecture Review]:
  // Initialize comprehensive architecture swarm
  mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }
  mcp__claude-flow__agent_spawn { type: "architect", name: "Senior Architect" }
  mcp__claude-flow__agent_spawn { type: "analyst", name: "Structure Analyst" }
  mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
  mcp__claude-flow__agent_spawn { type: "researcher", name: "Best Practices Researcher" }
  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
  
  // Analyze current repository structures
  LS("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow")
  LS("$workspaces$ruv-FANN$ruv-swarm$npm") 
  Read("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow$package.json")
  Read("$workspaces$ruv-FANN$ruv-swarm$npm$package.json")
  
  // Search for architectural patterns using gh CLI
  ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \
    --limit 10 \
    --json fullName,description,stargazersCount \
    --sort stars \
    --order desc`))
  
  // Create optimized structure files
  mcp__github__push_files {
    branch: "architecture$optimization",
    files: [
      {
        path: "claude-code-flow$claude-code-flow/.github/ISSUE_TEMPLATE$integration.yml",
        content: "[Integration issue template]"
      },
      {
        path: "claude-code-flow$claude-code-flow/.github/PULL_REQUEST_TEMPLATE.md",
        content: "[Standardized PR template]"
      },
      {
        path: "claude-code-flow$claude-code-flow$docs/ARCHITECTURE.md",
        content: "[Architecture documentation]"
      },
      {
        path: "ruv-swarm$npm/.github$workflows$cross-package-test.yml",
        content: "[Cross-package testing workflow]"
      }
    ],
    message: "feat: Optimize repository architecture for scalability and maintainability"
  }
  
  // Track architecture improvements
  TodoWrite { todos: [
    { id: "arch-analysis", content: "Analyze current repository structure", status: "completed", priority: "high" },
    { id: "arch-research", content: "Research best practices and patterns", status: "completed", priority: "medium" },
    { id: "arch-templates", content: "Create standardized templates", status: "completed", priority: "high" },
    { id: "arch-workflows", content: "Implement improved workflows", status: "completed", priority: "medium" },
    { id: "arch-docs", content: "Document architecture decisions", status: "pending", priority: "medium" }
  ]}
  
  // Store architecture analysis
  mcp__claude-flow__memory_usage {
    action: "store",
    key: "architecture$analysis$results",
    value: {
      timestamp: Date.now(),
      repositories_analyzed: ["claude-code-flow", "ruv-swarm"],
      optimization_areas: ["structure", "workflows", "templates", "documentation"],
      recommendations: ["standardize_structure", "improve_workflows", "enhance_templates"],
      implementation_status: "in_progress"
    }
  }

架构模式

1. Monorepo 结构模式

ruv-FANN/
├── packages/
│   ├── claude-code-flow/
│   │   ├── src/
│   │   ├── .claude/
│   │   └── package.json
│   ├── ruv-swarm/
│   │   ├── src/
│   │   ├── wasm/
│   │   └── package.json
│   └── shared/
│       ├── types/
│       ├── utils/
│       └── config/
├── tools/
│   ├── build/
│   ├── test/
│   └── deploy/
├── docs/
│   ├── architecture/
│   ├── integration/
│   └── examples/
└── .github/
    ├── workflows/
    ├── templates/
    └── actions/

2. 命令结构模式

.claude/
├── commands/
│   ├── github/
│   │   ├── github-modes.md
│   │   ├── pr-manager.md
│   │   ├── issue-tracker.md
│   │   └── sync-coordinator.md
│   ├── sparc/
│   │   ├── sparc-modes.md
│   │   ├── coder.md
│   │   └── tester.md
│   └── swarm/
│       ├── coordination.md
│       └── orchestration.md
├── templates/
│   ├── issue.md
│   ├── pr.md
│   └── project.md
└── config.json

3. 集成模式

const integrationPattern = {
  packages: {
    "claude-code-flow": {
      role: "orchestration_layer",
      dependencies: ["ruv-swarm"],
      provides: ["CLI", "workflows", "commands"]
    },
    "ruv-swarm": {
      role: "coordination_engine", 
      dependencies: [],
      provides: ["MCP_tools", "neural_networks", "memory"]
    }
  },
  communication: "MCP_protocol",
  coordination: "swarm_based",
  state_management: "persistent_memory"
}

最佳实践

1. 结构优化

确保各仓库的目录组织一致
采用标准化的配置文件和格式
明确划分关注点和职责
采用可扩展的架构以适应未来发展

2. 模板管理

使用可复用的项目模板来保持一致性
标准化的 issue 和 PR 模板
为常见操作创建工作流模板
使用清晰易懂的文档模板

3. 多仓库协调

管理跨仓库依赖
同步版本和发布管理
统一编码标准和实践
自动执行跨仓库验证

4. 文档架构

编写全面的架构文档
提供清晰的集成指南和示例
确保文档易于维护且保持最新
准备易于使用的入门材料

监控与分析

架构健康度指标：

仓库结构一致性得分
文档覆盖率
跨仓库集成成功率
模板采用率和使用统计数据

自动化分析：

检测结构偏移
检查最佳实践遵循情况
分析性能影响
评估可扩展性并提出建议

与开发工作流集成

无缝集成：

$github sync-coordinator - 用于跨仓库同步
$github release-manager - 用于协调发布
$sparc architect - 用于详细架构设计
$sparc optimizer - 用于性能优化

工作流增强：

自动验证结构
持续改进架构
强制执行最佳实践
生成并维护文档

支持 Markdown

登录后评论

基本信息

作者: ruvnet
仓库: ruvnet/ruflo
分类: 开发
安装次数: 1,164
GitHub Stars: 79,971

报告问题