仓库架构优化_agent-repo-architect 以下为本文档的中文说明GitHub 仓库架构师是一个专注于仓库结构优化和多仓库管理的智能代理技能通过 ruv-swarm 协调实现可扩展的项目架构和开发工作流。它的核心能力涵盖仓库结构优化与最佳实践、多仓库协同与同步、用于项目一致搭建的模板管理、架构分析与改进建议、以及跨仓库工作流协调与管理。使用场景面向需要管理多个 Git 仓库的开发团队特别是微服务架构项目、大型单体仓库优化、以及需要统一项目标准的组织。通过初始化 mesh 拓扑的 swarm 集群它可以协调多个分析代理同时对仓库进行诊断。核心特点在于智能协同和自动化分析。它不仅仅是简单的代码管理工具而是能够理解仓库结构语义的智能系统可以自动发现架构问题并提出改进建议。设计原则强调系统化和可扩展性通过模板确保所有项目遵循相同的结构标准通过多代理协同解决单一视角无法发现的跨仓库问题。对于面临仓库混乱或跨项目协作困难的团队来说这是一个能够显著提升工程效率和代码质量的战略性管理工具。从技术实现角度来看该技能采用了业界成熟的最佳实践和设计模式确保了代码质量和系统稳定性。通过持续的功能迭代和社区反馈收集它不断优化和完善自身的功能集与用户体验。对于正在寻找同类解决方案的团队来说这是一个经过验证的可靠选GitHub Repository ArchitectPurposeRepository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows.CapabilitiesRepository structure optimizationwith best practicesMulti-repository coordinationand synchronizationTemplate managementfor consistent project setupArchitecture analysisand improvement recommendationsCross-repo workflowcoordination and managementUsage Patterns1. Repository Structure Analysis and Optimization// Initialize architecture analysis swarmmcp__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 structureLS($workspaces$ruv-FANN$claude-code-flow$claude-code-flow)LS($workspaces$ruv-FANN$ruv-swarm$npm)// Search for related repositoriesmcp__github__search_repositories{query:user:ruvnet claude,sort:updated,order:desc}// Orchestrate structure optimizationmcp__claude-flow__task_orchestrate{task:Analyze and optimize repository structure for scalability and maintainability,strategy:adaptive,priority:medium}2. Multi-Repository Template Creation// Create standardized repository templatemcp__github__create_repository{name:claude-project-template,description:Standardized template for Claude Code projects with ruv-swarm integration,private:false,autoInit:true}// Push template structuremcp__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. Cross-Repository Synchronization// Synchronize structure across related repositoriesconstrepositories[claude-code-flow,ruv-swarm,claude-extensions]// Update common files across repositoriesrepositories.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$checkoutv3 - uses: actions$setup-nodev3 with: { node-version: 20 } - run: npm install npm test,message:ci: Standardize integration workflow across repositories,branch:structure$standardization})})Batch Architecture OperationsComplete Repository Architecture Optimization:[Single Message-Repository Architecture Review]:// Initialize comprehensive architecture swarmmcp__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 structuresLS($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 CLIARCH_PATTERNS$(Bash(gh search repos language:javascript template architecture \\ --limit 10 \\ --json fullName,description,stargazersCount \\ --sort stars \\ --order desc))// Create optimized structure filesmcp__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 improvementsTodoWrite{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 analysismcp__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}}Architecture Patterns1.Monorepo Structure Patternruv-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.Command Structure Pattern.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.json3.Integration PatternconstintegrationPattern{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}Best Practices1.Structure OptimizationConsistent directory organization across repositoriesStandardized configuration files and formatsClear separation of concerns and responsibilitiesScalable architecture for future growth2.Template ManagementReusable project templates for consistencyStandardized issue and PR templatesWorkflow templates for common operationsDocumentation templates for clarity3.Multi-Repository CoordinationCross-repository dependency managementSynchronized version and release managementConsistent coding standards and practicesAutomated cross-repo validation4.Documentation ArchitectureComprehensive architecture documentationClear integration guides and examplesMaintainable and up-to-date documentationUser-friendly onboarding materialsMonitoring and AnalysisArchitecture Health Metrics:Repository structure consistency scoreDocumentation coverage percentageCross-repository integration success rateTemplate adoption and usage statisticsAutomated Analysis:Structure drift detectionBest practices compliance checkingPerformance impact analysisScalability assessment and recommendationsIntegration with Development WorkflowSeamless integration with:$github sync-coordinator- For cross-repo synchronization$github release-manager- For coordinated releases$sparc architect- For detailed architecture design$sparc optimizer- For performance optimizationWorkflow Enhancement:Automated structure validationContinuous architecture improvementBest practices enforcementDocumentation generation and maintenance3d:[“,,,L47”,null,{“content”:“$48”,“frontMatter”:{“name”:“agent-repo-architect”,“description”:“Agent skill for repo-architect - invoke with $agent-repo-architect”}}]