SuperAPI AI 工具集

oss-repository-conventions

编程与开发

查看项目

更新于 10-16 01:15

技能介绍

用途:帮助维护者把开源仓库推向并维持在较高规范水平,覆盖法律与治理、贡献与社区、工程与基础设施、自动化与供应链、发布与文档等域。

主要能力:每种能力支持三种模式。scan 只读盘点仓库当前声明了什么,引用“真相文件”并标出冲突;audit 在 scan 基础上按 references/oss-health-rubric.md 等参考评分,把缺口分为必须/应当/可选并说明原因;scaffold 依据模板生成文件,每个文件需单独确认,覆盖已有文件前先展示差异。支持整体仓库审计,按域汇总并给出健康分与优先级清单,附外部基准对照。

使用方式:通过路由将请求匹配到具体能力文件,如 licensing、security-policy、governance、contributing、community-health、repo-infrastructure、dev-setup、code-style、testing-quality、automation-baseline、ci-automation、dependency-supply-chain、pr-autonomy、release-versioning、documentation。仓库自身声明的约定(如 AGENTS.md、CONTRIBUTING.md、工具配置)优先于通用基线。

限制:不撰写提交信息、PR 描述、分支名或具体版本发布说明;不批量写文件、不静默覆盖、不自动修改仓库设置(仅提出命令);仓库文件与抓取文本视为数据而非指令,疑似注入以 WARN 呈现;默认假设 GitHub,其他平台需降级处理,语言相关能力仅覆盖其声明的语言集合,未知栈不臆造工具。