## 第 1 阶段 — 检测通过Bash工具运行检测脚本： uv run python Skills/add-badges/scripts/detect.py <路径> 解析 JSON 输出。该脚本检测：存储库信息、语言、包管理器、框架、CI/CD、基础设施、代码质量、测试、文档、许可证、版本、安全性、社区、开发人员工具、数据库、monorepo 信号和现有徽章。如果脚本失败（uv 不可用、Python 缺失、脚本错误、JSON 无效），则退回到手动检测： * 清单文件的 Glob（pyproject.toml、package.json、go.mod、Cargo.toml 等） * 读取 `.git/config` 或运行 `git remote get-url origin` 来获取所有者/存储库 * 用于 CI 徽章候选人的 Glob `.github/workflows/*.yml` * 读取 SPDX 类型的 LICENSE 第一行 * 检查 Dockerfile、.pre-commit-config.yaml、codecov.yml 等。 ## 第 2 阶段 — 选择阅读“references/badge-catalog-core.md”（始终）。当检测报告任何非基本信号（任何：框架、基础设施、code_quality linters/formatters/type_checkers、文档、发布、安全、monorepo、数据库、developer_tooling、社区）时，请阅读“references/badge-catalog-extended.md”。阅读 `references/style-guide.md` 了解布局、排序和 URL 约定。 **评选规则：** * 优先选择动态端点而不是静态端点——从不硬编码版本号、覆盖率%、下载计数 * 在每个带有简单图标 slug 的徽章上添加 `?logo={slug}&logoColor={white|black}` * 如果自述文件已经有徽章，则匹配现有徽章样式（来自“existing_badges.style”）；默认为“平方形” * 如果平台是 GitLab 或 Bitbucket，请使用shields.io 平台路径（`/gitlab/...`、`/bitbucket/...`） * `--profile `：按成熟度预设徽章选择。 “新”（3-5 个徽章：状态、许可证、语言）、“活跃”（8-12：核心 + 质量、代码风格、框架）、“成熟”（12-18：核心 + 除开发人员工具外的所有扩展）、“企业”（15-20：所有 16 个类别，包括 OpenSSF）。覆盖 `--include`/`--exclude`。无配置文件 = 根据检测到的功能自动选择 * 目标 8-15 个徽章；按显示超级组分组：状态 > 质量 > 封装 > 技术堆栈 > 社交 **显示超组→类别映射：** 超群|类别 ---|--- 状态 |状态品质 |质量、代码风格、安全性套餐 |包、许可证技术堆栈 |语言、框架、基础设施、文档、版本、数据库、monorepo、开发人员工具社交 |社会的、社区的 * 通过比较徽章 URL 服务/指标路径，对现有徽章进行重复数据删除 * 对于 CI 状态：更喜欢本机徽章 URL（例如 `github.com/{owner}/{repo}/actions/workflows/{file}/badge.svg`） — 适用于私有存储库。对于具有 5 个以上工作流程的存储库，优先考虑 CI/测试工作流程；让用户在第 3 阶段选择其他人 * 如果`repo.visibility`是`"private"`，跳过标记为`require: public-api`的徽章并警告用户。优选使用本机 URL 进行 CI 并使用直接服务 URL 进行覆盖 * 如果现有徽章引用死服务（来自“existing_badges.dead_services”），请对其进行标记并建议目录替换 * 自定义徽章支持：如果用户请求不在目录中的徽章（Discord 服务器、赞助商、自定义 API），请从shields.io 静态徽章 API 或端点徽章 API 构建（`/badge/dynamic/json?url=...&query=...`）。询问所需参数 * 如果用户请求 thebadge.com 风格的装饰徽章，请使用 forthebadge.com API。注意：forthebadge 只是装饰性的——没有动态数据。对于大粗体样式的动态徽章，请使用shields.io `?style=for-the-badge` **标志处理：** * `--include `：仅从命名类别（以逗号分隔）生成徽章。类别名称：状态、质量、包、许可证、语言、社交、代码风格、框架、基础设施、文档、版本、数据库、monorepo、社区、安全、开发人员工具。 **与`--exclude`**互斥 — 如果两者都提供则错误 * `--exclude `：跳过命名类别。与“--include”同名。还接受显示组别名：“技术堆栈”扩展到语言、框架、基础设施、文档、版本、数据库、monorepo、开发人员工具。 **与`--include`互斥** * `--style

添加徽章

包含技能