Agent Repo Architect

作者 ruvnet6051f6702b61無授權條款74K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫今天更新

Agent skill for repo-architect - invoke with $agent-repo-architect

僅含說明DevOps & CloudSoftware Development
AI 產生的概覽

分析並最佳化 GitHub 儲存庫結構，協調多儲存庫範本與工作流程。

功能
此技能引導代理進行儲存庫架構工作：分析現有儲存庫配置、提出結構改善建議，並建立標準化的專案範本。它也涵蓋跨儲存庫的檔案、工作流程與文件同步，並追蹤架構任務與分析結果。此技能僅含指示，未附帶指令碼。
適用情境
適用於需要檢視或重整專案儲存庫配置、多個相關儲存庫需要共用範本與工作流程，或需要產出架構文件與結構規範的情況。
執行需求
需要具備 Bash、檔案讀寫編輯、搜尋與任務工具的代理，以及用於建立、分支、搜尋儲存庫和推送檔案的 GitHub MCP 工具，和用於 swarm 初始化、代理產生、任務編排與記憶的 claude-flow MCP 工具。鉤子會呼叫 npx ruv-swarm，儲存庫搜尋使用 gh CLI，因此需要 Node.js 與網路存取。

name: repo-architect description: Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows 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 "🏗️ Initializing repository architecture analysis..." npx ruv-swarm hook pre-task --mode repo-architect --analyze-structure post_edit: | echo "📐 Validating architecture changes and updating structure documentation..." npx ruv-swarm hook post-edit --mode repo-architect --validate-structure post_task: | echo "🏛️ Architecture task completed. Generating structure recommendations..." npx ruv-swarm hook post-task --mode repo-architect --generate-recommendations notification: | echo "📋 Notifying stakeholders of architecture improvements..." npx ruv-swarm hook notification --mode repo-architect

GitHub Repository Architect

Purpose

Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows.

Capabilities

  • Repository structure optimization with best practices
  • Multi-repository coordination and synchronization
  • Template management for consistent project setup
  • Architecture analysis and improvement recommendations
  • Cross-repo workflow coordination and management

Usage Patterns

1. Repository Structure Analysis and Optimization

javascript
// 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

javascript
// 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\`\`\`bashnpx claude-flow init --sparcnpm installnpx claude-flow start --ui\`\`\`
## Features- 🧠 ruv-swarm integration- 🎯 SPARC development modes  - 🔧 GitHub workflow automation- 📊 Advanced coordination capabilities
## DocumentationSee CLAUDE.md for complete integration instructions.`    }  ],  message: "feat: Create standardized Claude project template with ruv-swarm integration"}

3. Cross-Repository Synchronization

javascript
// Synchronize structure across related repositoriesconst repositories = [  "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 Testson: [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"  })})

Batch Architecture Operations

Complete Repository Architecture Optimization:

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

Architecture Patterns

1. Monorepo Structure Pattern

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. 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.json

3. Integration Pattern

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

Best Practices

1. Structure Optimization

  • Consistent directory organization across repositories
  • Standardized configuration files and formats
  • Clear separation of concerns and responsibilities
  • Scalable architecture for future growth

2. Template Management

  • Reusable project templates for consistency
  • Standardized issue and PR templates
  • Workflow templates for common operations
  • Documentation templates for clarity

3. Multi-Repository Coordination

  • Cross-repository dependency management
  • Synchronized version and release management
  • Consistent coding standards and practices
  • Automated cross-repo validation

4. Documentation Architecture

  • Comprehensive architecture documentation
  • Clear integration guides and examples
  • Maintainable and up-to-date documentation
  • User-friendly onboarding materials

Monitoring and Analysis

Architecture Health Metrics:

  • Repository structure consistency score
  • Documentation coverage percentage
  • Cross-repository integration success rate
  • Template adoption and usage statistics

Automated Analysis:

  • Structure drift detection
  • Best practices compliance checking
  • Performance impact analysis
  • Scalability assessment and recommendations

Integration with Development Workflow

Seamless 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 optimization

Workflow Enhancement:

  • Automated structure validation
  • Continuous architecture improvement
  • Best practices enforcement
  • Documentation generation and maintenance

來源與署名

來源：ruvnet/ruflo位於.agents/skills/agent-repo-architect提交6051f67

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 ruvnet/ruflo 的技能

Cron Schedule

ruvnet

使用 CronCreate 安排持久背景工作程序，並提供建議的 cron 間隔。

DevOps & Cloud74K今天更新

Autopilot Predict

ruvnet

運用 Ruflo 自動駕駛 MCP 工具與已學習的模式，預測下一步該執行的工作。

AI & Agents74K今天更新

Autopilot Loop

ruvnet

執行一次自主自駕迴圈：檢查狀態、完成預測任務、記錄日誌並安排下次喚醒。

AI & Agents74K今天更新

Worker Integration

ruvnet

協調背景工作程序與專用代理，將觸發類型對應到代理並追蹤效能。

AI & Agents74K今天更新

Worker Benchmarks

ruvnet

為 agentic-flow worker 系統執行效能基準測試，並回報延遲、輸送量與記憶體指標。

Software Development74K今天更新

Swarm Advanced

ruvnet

指導使用 Claude Flow 進行進階叢集編排，涵蓋研究、開發、測試與分析工作流程。

AI & Agents74K今天更新

更多DevOps & Cloud技能

Playwright Devops

microsoft

精選

Playwright 的 DevOps 工作流程：分析 main 分支最新提交的 GitHub Actions 失敗並下載失敗作業日誌。

包含腳本
DevOps & Cloud97K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

DevOps & Cloud37K今天更新

Yeet

openai

精選

使用 GitHub CLI 一次完成暫存、提交、推送並建立或更新 GitHub 拉取請求。

DevOps & Cloud27K4 週前更新

Runbook

anthropics

精選

為重複性任務建立或更新逐步操作手冊，包含疑難排解、回復與升級流程。

DevOps & Cloud27K今天更新

Incident Response

anthropics

精選

引導事故回應流程：嚴重程度分級、狀態更新、緩解追蹤，以及無責事後檢討。

DevOps & Cloud27K今天更新

Deploy Checklist

anthropics

精選

產生部署前就緒檢查清單，涵蓋部署前、部署、部署後與回復觸發條件。

DevOps & Cloud27K今天更新