# frontend-admin-architecture-skill **Repository Path**: linyinneng/frontend-admin-architecture-skill ## Basic Information - **Project Name**: frontend-admin-architecture-skill - **Description**: skill 功能: - 从零创建 React + TypeScript 后台管理系统 - 统一团队后台项目目录规范 - 生成项目架构文档 - 创建 `AGENTS.md` 让 AI 后续开发遵守规范 - 搭建企业后台基础工程结构 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-07-08 - **Last Updated**: 2026-08-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # frontend-admin-architecture-skill 用于创建和规范化 React/Vue 前端后台管理系统的 Agent/Codex Skill。 该仓库包含一个可安装的 skill: ```text frontend-admin-architecture/ SKILL.md README.md references/ react/ architecture.md vue/ architecture.md assets/ AGENTS.react.template.md AGENTS.vue.template.md docs/ ai-interaction.md karpathy-guidelines.md ui-style.md ui-quality.md design-tokens.md code-style.md security.md comments.md verification.md git-commit.md knowledge-capture.md ``` ## 能做什么 调用该 skill 时,AI 会按内置架构规范帮助你: - 创建或标准化 React + TypeScript 企业后台项目 - 创建或标准化 Vue 3 + TypeScript 企业后台项目 - 生成 `docs/architecture.md` - 生成 `docs/` 下的 AI 交互、系统 UI 风格记录、UI 质量与创意边界、全局样式、代码风格、安全与数据、注释、验证、Git 提交、规则沉淀等专项规范 - 生成简版 `AGENTS.md` - 在 `AGENTS.md` 中要求后续 AI 开发前按任务类型读取并遵守 `docs/` 下的专项规范 - 按 `modules/shared/lib/layouts/router` 以及 React `store`、Vue `stores` 等目录规范创建项目结构 - 创建或脚手架项目时,询问框架、系统 UI 风格、布局风格、基础登录认证和是否立即安装依赖;默认方案为不预设系统 UI 风格 + 经典后台布局 + 基础登录认证 + 不立即安装依赖 - 允许系统风格有创造性,但要求登录页、布局壳、标签页、表格、表单、状态页按 UI 质量底线稳定输出 ## 安装方式 将 `frontend-admin-architecture` 文件夹复制到本机 skills 目录。 Windows 示例: ```powershell Copy-Item -Recurse .\frontend-admin-architecture $env:USERPROFILE\.agents\skills\ ``` 安装后重启 Codex,或打开一个新的 Codex 会话。 ## 调用方式 ```text $frontend-admin-architecture 我想新建一个 React + TypeScript 企业后台管理系统,请按规范初始化项目 ``` 或者: ```text $frontend-admin-architecture 我想新建一个 Vue 3 + TypeScript 企业后台管理系统,请按规范初始化项目 ``` 如果只想生成文档: ```text $frontend-admin-architecture 只帮我生成 docs/ 规范文档和 AGENTS.md,暂时不要创建代码。 ``` 创建项目时如果没有特别说明,skill 会先询问: ```text 请选择项目框架:React + TypeScript / Vue 3 + TypeScript 请选择系统 UI 风格: 1. 经典稳重型:浅色背景、低饱和主色、清晰表格和表单,适合通用企业后台。 2. 极简清爽型:留白更充足、边框和阴影更克制,适合轻量 SaaS 和低复杂度管理端。 3. 数据密集型:紧凑表格、高信息密度、弱装饰,适合运营、报表、BI、数据管理类后台。 4. SaaS 工作台型:工作区感更强,强调概览、快捷入口和多租户/多项目切换,适合 B2B 产品。 5. 科技深色型:深色背景、高对比数据状态、适度科技感,适合监控、安全、运维和大屏相关系统。 6. 金融严谨型:克制配色、强表格、明确风险和金额状态,适合财务、结算、风控类后台。 7. 政企规范型:蓝白基调、层级清晰、表单和审批链路规范,适合政企、OA、审批系统。 8. 内容运营型:重视素材预览、批量操作、状态标签和审核流,适合 CMS、内容和营销运营后台。 9. 工具效率型:强调快捷操作、分栏面板、键盘友好和配置效率,适合工具型或配置型后台。 10. 轻量门户型:顶部导航、模块入口清晰、页面复杂度低,适合模块较少的内部系统。 也可以自定义描述;如果暂不选择,则 docs/ui-style.md 保持待补充。 请选择布局风格: 1. 经典后台布局:左侧菜单 + 顶部栏 + 内容区 + 标签页。适合菜单层级较多、传统管理后台,作为默认布局。 2. 顶部导航型:顶部横向主导航 + 内容区。适合模块较少、层级较浅、希望页面更开阔的轻量后台。 3. 混合导航型:顶部一级业务域 + 左侧二级菜单 + 内容区。适合多业务域后台,例如订单、财务、系统、内容等模块并存的项目。 4. 图标窄栏型:左侧窄图标栏 + 展开菜单或二级面板 + 内容区。适合工具型后台和希望节省横向空间的现代 SaaS。 5. 工作台型:顶部产品栏 + 组织/项目切换 + 左侧可折叠菜单 + 内容区。适合多租户、多项目、组织切换频繁的 B2B 系统。 6. 不预设布局:只保留基础路由和页面容器。适合后续由业务或设计稿决定布局。 是否启用基础登录认证?如果启用,登录页会按已选择的系统 UI 风格生成。 是否立即安装依赖并运行验证?默认不安装,只生成项目文件和后续命令。 是否采用默认方案:不预设系统 UI 风格 + 经典后台布局 + 基础登录认证 + 不立即安装依赖? ``` ## 后续开发约定 项目生成后,后续给 AI 开发任务时建议加上: ```text 请先阅读 AGENTS.md,并按任务类型读取 docs/ 下的专项规范,严格按项目规范开发。 ```