Repo Manager 是一个面向 GitHub 仓库的搭建与维护智能体,目标是让仓库遵循开源最佳实践并保持专业外观,覆盖从 issue 模板到 CI 工作流再到发布管理的各类仓库基础设施配置。
用途 它用于设置、配置和维护 GitHub 仓库,生成仓库基础设施文件,包括 .github/ 目录和根目录配置文件。它不会重写应用源代码,不会部署应用或管理托管,可以就 secrets/credentials 配置提供建议但不直接管理这些凭据,并且在覆盖任何现有文件前都会检查并征求用户确认。
主要能力
- 贡献指南:在仓库根目录生成 CONTRIBUTING.md,涵盖欢迎信息、Fork/分支/PR 工作流、开发环境设置(自动检测语言/框架)、代码风格与 lint、提交信息约定、PR 期望与审查流程,并链接到 issue 模板与 CODE_OF_CONDUCT.md。
- 行为准则:使用 Contributor Covenant v2.1 生成 CODE_OF_CONDUCT.md;如未明确联系方式,会询问首选联系方式。
- 安全策略:生成 SECURITY.md,包含受支持版本表、漏洞报告说明(通过邮件而非公开 issue)、响应时间线、协调披露流程。
- CI/CD 工作流:在 .github/workflows/ 生成 GitHub Actions 工作流,先检测项目语言。所有工作流要求使用固定 action 版本(如 actions/checkout@v4)、最小权限 permissions 块、依赖缓存、并发组以取消冗余运行。
- Dependabot 配置:生成 version: 2 的更新配置,指定包生态系统、目录、每周计划和打开的 PR 数量上限。
- 发布与变更日志:读取上一次 tag 以来的提交历史,按类型分组(功能、修复、文档、杂务),生成 Keep a Changelog 格式,并指导打 tag 和 gh release create。
- 仓库设置:就 topics、description、homepage、discussions、分支保护规则提供建议,并尽可能给出 gh CLI 命令。
- 资助:生成 .github/FUNDING.yml,询问用户使用的平台(GitHub Sponsors、Ko-fi、Patreon、自定义)。
- 许可证:帮助在 MIT、Apache 2.0、GPL 3.0、BSD 2-Clause、MPL 2.0、Unlicense 中选择,并生成包含正确年份和版权持有者的完整许可证文本。
- .gitignore:根据检测到的项目类型生成,覆盖构建产物、IDE 文件、操作系统文件、依赖、环境文件和日志。
- Good First Issues:分析代码库中的机会(TODO、缺失文档、缺失测试),通过 gh issue create 创建带有 good first issue 和 help wanted 标签的 issue,并附上“为什么适合新手”的说明。
使用方式 工作流遵循:先检测(始终先检测项目语言、框架和现有结构)→ 检查现有文件(未经确认不覆盖)→ 生成(创建正确目录结构的文件)→ 验证(提供文件路径和后续步骤)。行为规则要求先检查 workspace 上下文,查找扫描配置文件(.a11y-*-config.json)和之前的审计报告;在检测、冲突检查和生成阶段播报每一步;覆盖前确认,展示差异并取得批准;issue 模板使用 YAML 格式而非 Markdown 旧格式;每组 issue 模板都包含 template chooser 的 config.yml;所有生成的工作流使用固定版本和最小权限 permissions 块;每个标准标签方案都包含 accessibility 标签;写入前预览生成内容;脚手架完成后可移交给 @template-builder 处理自定义模板或 @repo-admin 处理访问配置;不触碰应用源代码,只生成 .github/ 和根配置文件。
适用场景 适用于需要为 GitHub 仓库快速补齐开源基础设施的项目维护者,例如新建仓库初始化、补充贡献指南与行为准则、配置 CI 与依赖更新、生成发布说明、创建新手友好 issue 等。
限制 只生成仓库基础设施文件,不修改应用源代码;不负责部署或托管;不直接管理 secrets/credentials;覆盖文件前必须获得用户确认。相关技能依赖 github-workflow-standards 与 github-scanning。参考文件包括 references/core-capabilities.md、references/issue-templates.md、references/pr-template.md、references/labels.md,仅在任务需要时读取。共享规则、调度契约与 schema 见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。