---
name: zui-standards
description: "查询 ZUI 主仓库的开发规范，为库开发及本地 exts 接入任务提供相关约束和仓库证据；规范查询保持只读。"
---

# ZUI 公共开发规范

## 工作流

1. 按 [references/workflow.md](references/workflow.md) 完成所需发现并复用已有上下文。
2. 按当前任务需要读取下列对应规范：
   - 库角色、包骨架或元数据：[references/library.md](references/library.md)
   - 源码导入、公开入口、分发类型或文档接入示例：[源码与文档接入规范](references/consumption.md)
   - 将外部 ZUI 库接入当前仓库的 `exts/` 共同调试、构建或维护文档：[references/extension-library.md](references/extension-library.md)
   - UI 组件：[references/component.md](references/component.md)
   - 可视组件库的标准静态预览、文档封面与展示墙：[组件预览规范](references/component-preview.md)
   - Web Component 适配、工厂和属性契约：[references/web-component.md](references/web-component.md)
   - 组件、调试页和文档示例的布局、CSS 声明与样式入口：[布局与样式规范](references/component.md#布局与样式)；新增或修改布局类、示例容器类或可复制代码时，读取 [CSS utilities 使用与核实](references/utilities.md)
   - 组件运行时按需加载外部 JS/CSS：[references/external-library.md](references/external-library.md)，并同时读取组件规范
   - helper、store 或 utils：[references/helper.md](references/helper.md)
   - 官网文档：[references/documentation.md](references/documentation.md)
   - `README.md` 与 `dev.ts`：[references/dev-page.md](references/dev-page.md)
   - 国际化：[references/i18n.md](references/i18n.md)
3. 新增组件或工具前按[先查找，再复用](references/workflow.md#复用已有能力)检索已有能力；定位目标或筛选架构参考时使用原有盘点模式：

```sh
node <本技能目录>/scripts/inspect-zui-lib.mjs --root <repo-root>
node <本技能目录>/scripts/inspect-zui-lib.mjs --root <repo-root> --lib <name> --json
node <本技能目录>/scripts/inspect-zui-lib.mjs --root <repo-root> --search '关键词 symbolName' --json
```

4. 从相关源码、类型或实际行为核实决策所需事实，按共享工作流的优先级解决冲突。
5. 本技能的规范查询阶段保持只读并给出仓库证据。用户已要求实施时，主流程完成查询后继续进入相应实施技能，按任务范围持续推进至完成；遇到关键歧义时仅澄清受影响部分；仅指出技能名称不构成实施任务交付。由其他技能调用时只提供约束，不增加独立确认门禁，也不由本查询阶段修改文件。

## 输出要求

- 清楚区分仓库事实、相似实现惯例和建议。
- 指出目标包角色与实现架构；两者不是同一维度。
- 只报告当前任务需要的规范、证据路径、风险与建议验证方式。
- 不生成固定源码模板，不自动提交代码，不顺带迁移无关实现。