用途：在采用 Panda CSS 的项目中编写、修改或审查样式代码，涉及 css()、cva()、sva()、patterns、recipes 等 API。Panda 在构建时读取源码生成 CSS，读不到的值不会产出 CSS，只会留下一个无效类名，这是多数问题的根源。
主要能力与用法：先读项目再动手。查看最近的 package.json 中 @pandacss/dev 版本（1.x 为 v1，2.x/-beta 为 v2），monorepo 中看正在编辑的包；读取 panda.config.ts（或 .js/.mjs）中的 outdir、include、jsxFramework、strictTokens、presets、designSystem。token、recipe、pattern 名称以生成产物为准：<outdir>/types/tokens.d.ts 列出全部 token 名，<outdir>/specs/design-system.json 含解析值与来源（需 panda codegen --spec 生成），<outdir>/recipes/ 与 <outdir>/patterns/ 展示已有内容，panda doctor --json 输出配置路径、源码数量与产物信息。运行时辅助函数从 outdir 导入（css、cva、sva、cx、patterns、recipes、styled），配置辅助函数从 @pandacss/dev 导入。
限制与注意：outdir 是构建产物，不要手改或提交修复。修改 token、recipe、pattern、conditions、jsxFramework 或 outdir 后需运行 panda codegen。运行时值、动态键、运行时对象展开不会生成 CSS；文件须匹配 include glob；跨文件组合仅支持静态值的具名本地导入。嵌套选择器需带 &。不要写 Tailwind 工具类字符串，不要用 Emotion 或 styled-components 模板字符串，不要用 !important 解决层叠问题。样式不生效时依次检查 include、codegen、@layer 声明、值是否静态、recipe 变体是否为运行时 prop、jsxFramework 是否设置。可用 panda debug 查看提取产物，@pandacss/eslint-plugin 检查问题，@pandacss/mcp 提供实时 token 等数据。主题设计见 panda-css-theming，v1 升级 v2 见 panda-css-migrate。