github-repo-architect

用途

GitHub Repository Architect 技能用于仓库结构优化与多仓库管理，并借助 swarm 协调机制支持可扩展的项目架构与开发工作流。它主要处理仓库结构分析、模板管理、跨仓库同步、架构建议以及开发流程优化。

主要能力

结构优化：实施最佳实践。
多仓库协调：跨仓库同步。
模板管理：一致的项目设置。
架构分析：改进建议。
工作流协调：开发流程优化。

使用方式

该技能通过 GitHub CLI 命令和 MCP 工具集成来使用。

快速开始示例：

# 列出仓库结构
ls -la

# 搜索组织中的仓库
gh repo list org --limit 20 --json name,description,languages

# 创建新仓库
gh repo create my-new-repo --public --description "Description"

# 克隆仓库
gh repo clone owner/repo

# 查看仓库信息
gh repo view owner/repo --json name,description,topics

使用示例包括：

仓库结构分析：初始化架构分析 swarm，编排结构优化任务，分析当前结构（列出仓库内容、查找配置文件、分析包依赖、搜索相关仓库）。
创建仓库模板：创建模板仓库，克隆并设置结构，创建目录结构（如 .claude/commands/{github,sparc,swarm}、src tests docs config），创建核心文件（如 package.json、CLAUDE.md），提交并推送。
跨仓库同步：列出组织仓库，遍历更新公共文件（如 CI 工作流），提交并创建 PR。
批量架构操作：在单条消息中初始化架构 swarm，分析当前结构，搜索模式，跟踪架构改进，存储分析结果。

适用场景

分析仓库结构以进行优化。
创建标准化项目模板。
跨仓库同步。
架构分析与建议。
多仓库工作流协调。

架构模式

该技能提供了 Monorepo 结构、命令结构、集成模式等架构模式示例。

Monorepo 结构示例：

project-root/
├── packages/
│   ├── package-a/
│   │   ├── src/
│   │   ├── .claude/
│   │   └── package.json
│   ├── package-b/
│   │   ├── src/
│   │   └── package.json
│   └── shared/
│       ├── types/
│       ├── utils/
│       └── config/
├── tools/
│   ├── build/
│   ├── test/
│   └── deploy/
├── docs/
│   ├── architecture/
│   ├── integration/
│   └── examples/
└── .github/
    ├── workflows/
    ├── templates/
    └── actions/

命令结构示例：

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

集成模式示例：

const integrationPattern = {
    packages: {
            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"
}

MCP 工具集成

Swarm 协调示例：

    topology: "mesh",
    maxAgents: 4,
    strategy: "adaptive"
})

    type: "architect",
    name: "Repository Architect",
    capabilities: ["structure-analysis", "pattern-recognition", "optimization"]
})

用于架构状态的内存存储示例：

    action: "store",
    key: "architecture/structure/analysis",
    namespace: "architecture",
    value: JSON.stringify({
        repositories: ["repo1", "repo2"],
        patterns_found: ["monorepo", "microservices"],
        recommendations: ["standardize", "consolidate"]
    })
})

最佳实践

结构优化：跨仓库一致的目录组织；标准化的配置文件和格式；清晰的关注点和职责分离；可扩展的架构以适应未来增长。
模板管理：可复用的项目模板以保持一致性；标准化的 issue 和 PR 模板；常见操作的工作流模板；清晰的文档模板。
多仓库协调：跨仓库依赖管理；同步的版本和发布管理；一致的编码标准和实践；自动化的跨仓库验证。
文档架构：全面的架构文档；清晰的集成指南和示例；可维护且最新的文档；用户友好的入门材料。

监控与分析

架构健康指标：仓库结构一致性评分、文档覆盖率百分比、跨仓库集成成功率、模板采用和使用统计。

自动化分析：结构漂移检测、最佳实践合规检查、性能影响分析、可扩展性评估和建议。

与其他技能的集成

github-multi-repo：跨仓库同步
github-release-manager：协调发布
sparc-workflow：架构设计
agent-orchestration：多智能体协调

版本历史

1.0.0（2025-01-02）：初始版本 - 从 repo-architect 智能体转换而来。

限制

资料中未提供关于收费、价格、平台支持范围、具体效果或使用步骤的更多信息。