woostack-design-system 是一个面向项目组件目录创建与维护的技能。它的核心用途是：根据随技能发布的版本化资产，在目标仓库中建立一个可运行、项目自有的组件目录（component catalog），并在已有目录时检查其覆盖缺口或漂移，或在明确请求下对指定范围进行添加、修复与更新。
主要能力
该技能围绕三种授权操作展开。第一，当仓库中不存在目录且为普通调用时，执行有界的本地创建，包括必要的目录依赖与配置变更以及验证。第二，当目录已存在且为普通调用或检查请求时，只生成只读的缺口/漂移报告，不写入源码、配置、依赖、锁文件或生成文件。第三，当用户明确要求添加、修复或更新时，仅处理被命名的维护范围及其必要验证。
技能强调“先检查”。即使目录未文档化，也视为已存在。若存在组件库但没有目录，不阻止创建，但必须复用其兼容控件。显式的只读或仅本地限制优先。技能不会自动创建分支、提交、推送、发布 PR/issue、变更 Projects、初始化 Woostack 配置或迁移产品 UI。
使用方式
使用前需阅读仓库指令、设计规则、清单、锁文件、公共 UI 导出及其调用方、样式/令牌、现有目录和验证命令，并保留无关工作。技能使用规范的 Execute 实现模式与测试指导，但阅读这些内容不会调用 Execute 或其交付工作流。
在放置目录时，应选择仓库原生的目录位置，而不是复制的工作区路径。在样例和导航/框架中复用兼容控件。目录调用方应适配其公共 API，不应为了适配起始模板而重写现有组件。对于不兼容或非 React 产品，使用隔离的 React 目录，其依赖与配置不得改变产品的框架、运行时依赖集或行为。
若目录已存在且未请求维护，应在安装或生成前停止，并报告其位置、观察到的覆盖范围、API/样式兼容性、来源、交互缺口以及具体的限定修复选项。需区分已检查事实与未验证的运行时行为。
创建或维护时，应遵循已安装 SKILL.md 旁边的资产进行适配与重建，而不是使用 Woostack 检出或从 Git Stacks 运行时抓取。模板是最小的目录专用输入，不是捆绑的 UI 库或完整实现。版本化的规范清单定义了完整基线覆盖与来源；应保留它，并将项目扩展分开。
应尊重项目令牌、排版与设计规则。若无规则，使用中性的 shadcn 基线，而不是 Git Stacks 品牌或 Quiet Workbench 样式。新需要的、清单选定的控件应通过当前 shadcn CLI 使用 Base UI 获取；绝不用 CLI 覆盖现有 UI，也不要在自定义设置上初始化。兼容的现有原语应复用，而非迁移。创建可能需要 CLI 网络访问；生成的目录在运行时没有远程源要求。仅从权威注册表解析新选定的依赖，并遵循规范依赖指导。
不得覆盖自定义组件、令牌、示例、规则或无关工作。更改现有目标前先比较。报告冲突并保持冲突表面不变；完成独立的范围内工作，不静默替换为重复实现。维护不等于允许重新生成目录或升级无关依赖。
验证与报告
使用验证和目标的原生命令。验证真实导入、完整声明的基线覆盖、实时样例和实际浏览器行为；占位目录、成功复制源码、仅类型检查或站点打包检查都不算重建。不得留下模拟控件、死样例或不受支持的“完成”声明。
报告应包括目录位置与命令、模板/基线来源、复用与新建控件、设计适配、保留的自定义、冲突以及实际观察到的检查。区分确定性检查、已安装技能/宿主结果与浏览器证据。失败或未运行的必需检查保持未验证；指出缺失的前提条件，不声称完成。本地验证的更改是终点；发布需要单独的用户请求。
适用场景与限制
该技能适用于需要建立项目自有组件目录、检查现有目录缺口或漂移、或在明确范围内维护目录的场景。它不适用于自动发布、自动迁移产品 UI 或未经请求的目录重新生成。其限制包括：需要遵循仓库现有规则与令牌；创建可能需要 CLI 网络访问；非 React 产品需使用隔离目录；不得覆盖现有自定义内容；发布需单独请求。