用途：add-badges 用于检测仓库技术栈并生成、更新 README 中的 shields.io 徽章块，边界限定在徽章相关操作，不涉及通用 README 改写、文档工作或 CI/CD 设计。
主要能力：工作流分为 detect（检测）、select（选择）、present（预览）、insert（插入）四个阶段。检测脚本可识别仓库信息、语言、包管理器、框架、CI/CD、基础设施、代码质量、测试、文档、许可证、发布、安全、社区、开发工具、数据库、monorepo 信号及已有徽章。选择阶段优先使用动态端点而非硬编码版本号、覆盖率或下载量，并为带 Simple Icons slug 的徽章添加 ?logo={slug}&logoColor={white|black}。支持 --profile（new/active/mature/enterprise 预设）、--include/--exclude、--style、--layout、--readme、--dark-mode、--dry-run、--yes、--replace 等参数。
使用方式：通过 Bash 运行 uv run python skills/add-badges/scripts/detect.py <path> 进行检测，脚本失败时可回退到手动检测（查找 pyproject.toml、package.json 等清单文件，读取 .git/config 或 git remote get-url origin，查找 .github/workflows/*.yml 等）。插入后可选运行 uv run python scripts/validate-badges.py <readme-path> 验证徽章 URL。徽章插入到 <!-- BADGES:START --> 与 <!-- BADGES:END --> 标记之间，插入点优先为已有标记、首个 # 标题之后、文件顶部。
适用场景：为项目 README 添加或更新状态、质量、包、技术栈、社交等分组徽章；支持 GitLab、Bitbucket 平台路径；支持自定义徽章与 forthebadge.com 装饰性徽章。
限制：不用于通用 README 重写或非徽章文档改动；私有仓库需跳过标记 requires: public-api 的徽章；缺少 owner/repo、工作流文件名等必要信息时必须询问，--yes 也不能跳过；写入前默认需用户批准，--dry-run 始终在预览后停止；不得修改标记之外的任何内容。