SuperAPI AI 工具集

oss-readiness

智能体与模型

查看项目

更新于 10-15 17:27

技能介绍

用途:在仓库公开发布前做就绪度审计(OSS Readiness / Public Release Gate),检查开源基础项、补全缺失的公开文档与模板、生成 AI 友好文档、校验 CI、同步版本引用,并评估发布标题与公告措辞。

主要能力:提供 23 项检查清单,分为 12 项 BLOCKING(License、README 存在与质量、CONTRIBUTING.md、.gitignore、无密钥泄露、CI 测试与 lint、GitHub 描述、CHANGELOG.md、llms.txt、llms-full.txt)与 11 项 WARN(GitHub topics、AGENTS.md、各类 harness 别名、SECURITY.md、CODE_OF_CONDUCT.md、Issue/PR 模板、发布工作流、docs/ 目录、文档版本一致性、公开 src 无 TODO/FIXME)。评分公式为 SCORE = (blocking_pass/blocking_total)*70 + (warn_pass/warn_total)*30,A/B 需 0 个 BLOCKING 失败,任一 BLOCKING 失败最高只能评 C。输出带表格的分级报告。

使用方式:支持自然语言与斜杠命令两种入口,路由一致。例如 /oss 或“audit OSS readiness”做完整审计;/oss fix 补全缺失文件;/oss llms 生成 llms.txt 与 llms-full.txt;/oss bump 同步版本引用;/oss ci 校验 CI;也可直接询问发布标题与说明是否合适。脚手架按顺序:检测技术栈(npm/cargo/python/go/app)、运行清单、询问补全范围、逐项生成文件、报告并建议重新审计。生成文件统一使用 {REPO_NAME}、{ORG}、{LICENSE_TYPE}、{MAINTAINER_CONTACT_URL} 等占位符。

限制与依赖:文件读写为必需能力;shell、git 为推荐,gh、node/python 为可选,缺少时降级为手动检查或标记为未检查。技能本身保持与具体 harness 无关,AGENTS.md 为规范文件,CLAUDE.md、.cursorrules 等仅作可选别名,不硬编码链接、社交账号或维护者联系方式,不虚构联系渠道。非 git 仓库无法审计;私有仓库可用但会提示。资料未提供具体模板内容、llms 生成算法细节、版本同步与 CI 规则的实现细节及价格信息。