用途：扫描项目中的设计系统资产，将结果写入项目参考文档（如 docs/project-reference/design-system/README.md），内容包括概览、应用与文档映射、设计令牌清单和组件目录。
主要能力：先分类设计系统类型（Token-first、Component-library、Figma-driven、Ad-hoc/CSS-only、Hybrid），再并行扫描结构、组件清单、令牌与组件来源；输出令牌分类（颜色、字体、间距、断点、z-index、阴影等）与组件表（名称、类别、变体、路径、是否有文档），并要求包含缺口分析。文档路径与令牌文件由 docs/project-config.json 的 designSystem.canonicalDoc、designSystem.tokenFiles 等配置驱动。
使用方式：在 Codex 中用 $scan-design-system 调用；执行前先读 docs/project-config.json、docs/project-reference/docs-index-reference.md 与 lessons.md，按需打开相关参考文档。流程分阶段：分类、计划（建立任务跟踪）、并行子代理扫描、分析生成、写入与验证；初始化模式会创建规范文档与令牌文件，同步模式只做外科式更新，保留手工内容。
限制：所有组件名与令牌值必须 grep/glob 验证，不得虚构；置信度低于 60% 的内容应省略；令牌发现仅限声明的白名单路径，排除 node_modules、dist 等；若必要步骤或工具在当前环境无法运行，应停止并询问用户。具体项目配置、价格与平台支持等未在资料中提供。