用途：为 README 等文档中的 shields.io 徽章提供设计与选择知识，供 AI 文档代理在首次生成时产出正确、美观的徽章标记。它不是徽章插入工具，而是决策知识库。
主要能力：静态徽章 URL 模式 https://img.shields.io/badge/{LABEL}-{MESSAGE}-{COLOR}，含编码规则（单下划线转空格、双下划线转字面下划线、双连字符转字面连字符）；样式选择（for-the-badge、flat-square、flat、social、plastic）；按项目类型推荐徽章（Python 库/CLI、JS/TS 包、Claude Code 插件、Rust crate、通用开源项目）；布局模式（两层式、行内左对齐、居中单行）；logo 用法与 Simple Icons slug；颜色参考与语义别名；动态与静态徽章区分；常见错误提示。
使用方式：按 URL 模式拼装徽章，追加 ?style=、?logo=、?logoColor= 等查询参数，并用 Markdown 或 HTML 包裹链接。示例：https://img.shields.io/badge/Claude_Code-compatible-D97757?logo=claude&logoColor=white。
限制：资料未提供安装命令、收费或价格信息；部分品牌（如 AWS、Azure、OpenAI 等）无 Simple Icons slug，需自定义 SVG 或代理图标；同一行混用样式会导致高度不齐；徽章过多、缺少 alt 文本、slug 错误、未加链接等属常见反模式。