用途:在项目中安装并按项目品牌配置 shadcn/ui,同时保留现有主题和组件修改。适用于“安装并按项目品牌配置 shadcn/ui”或“Install and configure shadcn/ui for a project”这类请求;仅查询说明或无关任务不触发,仅预览或审查时保持只读。
主要能力:读取包管理器、框架、Tailwind 主版本、components.json 与现有组件,从项目品牌 token 确定主题;按当前官方安装文档选择命令,已有项目只补缺项;配置路径别名、全局样式与 semantic token,区分 Tailwind v3 配置文件与 v4 CSS-first 方式并保留必要 reset;仅安装需求涉及的组件;运行构建并验证按钮状态、表单、暗色主题与响应式,输出实际新增依赖、组件和配置路径。
使用方式:自然语言请求即可触发,无需旧 slash 路径、参数插值或指定助手。执行时解析当前请求中的项目、目标文件、选项与输出位置,使用宿主实际提供的文件、搜索、CLI 和浏览器能力。随包脚本从 Skill 根解析,业务文件从目标项目根解析。先读当前状态,保护已有未提交内容与其他任务的暂存区。修改、提交、推送、部署和发布各依当前请求的明确范围执行。
限制:项目依赖版本与外部 API 需在执行时核实,不能假设示例为现行配置。不固定使用旧 preset,不因 CLI 初始化覆盖已有 CSS 和人工组件修改。对 button hover、border reset 等问题先检查实际生成代码并复现,不能无条件套用历史补丁。网络失败时才使用用户已配置代理,不写固定本机代理到通用 Skill 或 shell profile。不绕过保护、不自动发送消息、不强制结束用户进程或抢前台,失败保留可诊断原始错误。配置缺失只问影响结果的一个问题;长期保存值通过 scripts/profile_store.py 原子写入并报告实际路径,不保存推断、凭据或其他任务资料。运行前读取本包 skill.yaml 与 Profile 合同,优先级为当前请求、项目上下文、本 Skill records、共享 preferences、brand/user Profile、安全默认值。