用途:按 GitHub 社区标准审计与维护社区健康文件,检查标准文件是否存在、是否过时、内容是否准确,并在所有者批准后从模板生成缺失文件。作为执行顺序中的第 3 个模块运行,也可单独针对某仓库或跨仓库执行。
主要能力:用 gh-manager repo community 获取社区档案分数;用 gh-manager files exists 逐个检查 SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md、SUPPORT.md、FUNDING.yml、CODEOWNERS、ISSUE_TEMPLATE、PULL_REQUEST_TEMPLATE.md、DISCUSSION_TEMPLATE 等;用 gh-manager files get 读取内容做准确性检查(如 CONTRIBUTING 是否引用正确默认分支、SECURITY 是否含有效联系方式、CODEOWNERS 句柄是否合理);用 gh-manager files put 创建或更新文件。组织仓库会解析组织级 .github 仓库的继承文件。
使用方式:模板位于 ${CLAUDE_PLUGIN_ROOT}/templates/,含 SECURITY.md.tmpl 等;创建前先向所有者展示渲染内容确认。Tier 1-3 直接提交默认分支,Tier 4 走维护分支加 PR:先 gh-manager branches create 建 maintenance/community-health-YYYY-MM-DD 分支,再 gh-manager files put 提交并 gh-manager prs create 开 PR,标签为 maintenance。创建前用 gh-manager prs list --label maintenance 检测已有维护 PR,避免重复。
限制:LICENSE 缺失时只提示不生成;准确性检查为启发式观察而非结论;社区档案 API 不覆盖 SUPPORT.md、FUNDING.yml、CODEOWNERS、讨论模板,且组织仓库分数不含继承文件;Tier 4 提交后内容立即公开需谨慎;标签需先完成引导。具体模板内容与完整命令细节请以原始资料为准。