SuperAPI AI 工具集

organizing-conversations-code

前端与建站

查看项目

更新于 10-16 03:44

技能介绍

用途:规范 conversations 产品代码的文件组织方式,适用于在 products/conversations/ 下创建、移动或重命名文件,向前端添加 React 组件、辅助函数或测试,以及审查新增文件的 conversations 变更。仓库级 UI 规则仍然适用,需另行参考 writing-ui-components(一个组件一个文件、不使用 barrel 文件、导入需清扫);本技能只负责 conversations 内部文件应放在哪里。

主要能力与约定:每个 React 组件放在 products/conversations/frontend/components/ 下以组件名命名的独立文件夹中,文件按导出名命名,例如 products/conversations/frontend/components/<Name>/<Name>.tsx,测试文件同目录就近放置为 <Name>.test.tsx。导入时指向文件而非文件夹,如 import { SlaDisplay } from '../../components/SlaDisplay/SlaDisplay' 或使用 products/conversations/frontend/components/SlaDisplay/SlaDisplay 路径。

禁止做法:不要把组件作为散落文件直接放进 frontend/components/;不要把组件放在 products/conversations/frontend/(产品前端根目录);不要添加 index.ts barrel 以便调用方按文件夹导入。返回 props 或数据而非标记的辅助函数不算组件,应放在功能附近或 products/conversations/frontend/<name>.ts(x),例如 clearFilterButtonProps.tsx。移动组件时使用 git mv,更新所有使用方指向新路径,并删除旧文件,不保留 re-export 兼容层。

限制:资料未提供更多关于适用平台、版本或收费的信息。