用途:repo-health 是一个“仓库基石”技能,用于在代码仓库中引导、审计或评审社区健康与基础文件。它覆盖 README.md(Standard Readme 规范)、LICENSE(法律契约)、CONTRIBUTING.md、CODE_OF_CONDUCT.md、SECURITY.md、SUPPORT.md、.github/ 下的 issue/PR/CODEOWNERS/FUNDING/CITATION 模板,以及 REUSE 3.3 + SPDX 逐文件版权与许可元数据。每个基石都有独立参考文件,SKILL.md 作为精简入口按需加载。
主要能力:先诊断后创建。对每个基石应用四问诊断:读者是谁、是否已存在等价文件、应放在何处、由谁负责(须为具名的人或别名)。若答案不明则不创建文件,避免为凑数生成无人维护的文档。默认建议:README 和 LICENSE 必需;接受外部贡献时需 CONTRIBUTING;有外部参与时需行为准则(默认 Contributor Covenant 3.0,2.1 为回落);处理不可信输入、机密或对外暴露时需 SECURITY.md;多数小仓库不需要 SUPPORT.md 与 FUNDING.yml;REUSE/SPDX 适用于多许可聚合或需机器可验证许可元数据的仓库。
使用方式:引导时先盘点已有文件,逐一诊断并逐文件推荐创建/合并/保持,不批量生成;创建时加载对应参考并生成含占位符的草案。审计时同样盘点,对照规范标记漂移、缺失章节、过期日期和单一维护者联系方式,输出编号的 KEEP/REWRITE/CREATE/DELETE 清单。每轮只给一条发现,附行号引用、原文引用、规则名与改写建议,逐条确认。
限制与硬规则:不替用户选择许可证,必须路由到 choosealicense.com,仅列出常见默认(MIT、Apache-2.0、BSD-3-Clause、GPL-3.0、MPL-2.0),由人决定。行为准则与 SECURITY 的联系方式须为共享别名或协调渠道,绝不使用个人邮箱,bus factor 为一即拒绝。不编造维护者姓名、联系别名、许可证选择和 SLA 窗口。Markdown 格式检查、ADR、变更日志、运行手册、AGENTS.md 等由其他技能负责。