ZUI 公共开发规范
工作流
- 按 references/workflow.md 完成所需发现并复用已有上下文。
- 按当前任务需要读取下列对应规范:
- 库角色、包骨架或元数据:references/library.md
- 将外部 ZUI 库接入当前仓库的
exts/共同调试、构建或维护文档:references/extension-library.md - UI 组件:references/component.md
- 组件、调试页和文档示例的布局与样式:辅助类优先规范
- 组件运行时按需加载外部 JS/CSS:references/external-library.md,并同时读取组件规范
- helper、store 或 utils:references/helper.md
- 官网文档:references/documentation.md
README.md与dev.ts:references/dev-page.md- 国际化:references/i18n.md
- 需要定位目标或筛选参考实现时可运行盘点脚本;阅读范围和参考数量遵循共享工作流:
node <本技能目录>/scripts/inspect-zui-lib.mjs --root <repo-root>
node <本技能目录>/scripts/inspect-zui-lib.mjs --root <repo-root> --lib <name> --json
- 从相关源码、类型或实际行为核实决策所需事实,按共享工作流的优先级解决冲突。
- 本技能的规范查询阶段保持只读并给出仓库证据。用户已要求实施时,主流程完成查询后继续进入相应实施技能,直到其必要确认点或任务完成;仅指出技能名称不构成实施任务交付。由其他技能调用时只提供约束,不增加独立确认门禁,也不由本查询阶段修改文件。
输出要求
- 清楚区分仓库事实、相似实现惯例和建议。
- 指出目标包角色与实现架构;两者不是同一维度。
- 只报告当前任务需要的规范、证据路径、风险与建议验证方式。
- 不生成固定源码模板,不自动提交代码,不顺带迁移无关实现。