refactor: 整理规范文件 - 合并冗余、优化命名(32→20)

- 删除 12 个规范:空目录、重复规范、被吸收的子集规范
- 合并 4 组规范:管理台页面、开发台页面、布局体系、组件+反馈
- 重命名 8 个规范:统一平台前缀、暴露可搜索关键词、消除语义冲突
- 新增 docs/规范整理.md:规范审查流程提示词模板
This commit is contained in:
2026-03-27 13:24:00 +08:00
parent 7f493aa921
commit 9feb62da3f
24 changed files with 523 additions and 603 deletions

View File

@@ -1,5 +1,8 @@
# Capability: 布局系统
## Purpose
布局系统提供应用级外壳布局、聊天页面布局、管理台布局等核心页面骨架。
布局系统提供应用级外壳布局、页面内容区骨架、页面导航行为和样式文件组织规范。
## Requirements
@@ -106,3 +109,76 @@
#### Scenario: 侧边栏遮罩
- **WHEN** 移动端侧边栏展开时
- **THEN** 系统 SHALL 显示 `.sidebar__overlay` 遮罩层,点击可关闭侧边栏
### Requirement: 表单页面按钮组合完整
表单类二级页面必须同时具有左上角返回按钮和底部取消按钮。
#### Scenario: 表单页面包含返回和取消按钮
- **WHEN** 用户访问表单类二级页面(如新增、编辑页面)
- **THEN** 页面左上角显示返回按钮
- **AND** 页面底部显示"取消"和"确定/保存"按钮组合
#### Scenario: 点击返回按钮返回上级
- **WHEN** 用户点击左上角返回按钮
- **THEN** 页面返回至上级页面
- **AND** 不触发任何保存操作
#### Scenario: 点击取消按钮返回上级
- **WHEN** 用户点击底部取消按钮
- **THEN** 页面返回至上级页面
- **AND** 不触发任何保存操作
### Requirement: 详情页面仅保留返回按钮
只读详情类二级页面仅需左上角返回按钮,无需底部取消按钮。
#### Scenario: 详情页返回按钮
- **WHEN** 用户访问详情类二级页面(如任务详情、审核详情)
- **THEN** 页面左上角显示返回按钮
- **AND** 页面底部不显示取消按钮
### Requirement: 样式文件按页面拆分
系统 SHALL 将页面特定样式从 global.scss 中拆分到独立的页面样式文件中,按功能组织。
#### Scenario: 工作台样式独立文件
- **WHEN** 系统包含 _console.scss 文件
- **THEN** 该文件包含工作台相关的所有样式(聊天、技能市场、日志查询、定时任务、项目管理等)
#### Scenario: 管理台样式独立文件
- **WHEN** 系统包含 _admin.scss 文件
- **THEN** 该文件包含管理台相关的所有样式(总览、部门管理、用户管理、项目管理等)
#### Scenario: 开发台样式独立文件
- **WHEN** 系统包含 _developer.scss 文件
- **THEN** 该文件包含开发台相关的所有样式(我的技能、技能编辑、开发文档等)
#### Scenario: 首页样式独立文件
- **WHEN** 系统包含 _home.scss 文件
- **THEN** 该文件包含首页相关的所有样式
### Requirement: global.scss 作为样式主入口
系统 SHALL 保持 global.scss 作为样式主入口文件,导入所有样式模块。
#### Scenario: global.scss 导入设计系统模块
- **WHEN** global.scss 文件被加载
- **THEN** 系统按顺序导入 _variables.scss、_mixins.scss、_base.scss、_components.scss、_layout.scss
#### Scenario: global.scss 导入页面样式模块
- **WHEN** global.scss 文件被加载
- **THEN** 系统导入 pages/_console.scss、pages/_admin.scss、pages/_developer.scss、pages/_home.scss
#### Scenario: 通用样式保留在主文件中
- **WHEN** 样式属于通用组件(按钮、表单、表格、状态标签等)
- **THEN** 该样式保留在 _components.scss 或 _layout.scss 中,不移动到页面样式文件
### Requirement: 页面样式文件组织结构
系统 SHALL 在 src/styles/pages/ 目录下按页面组织样式文件,每个文件包含对应页面的所有特定样式。
#### Scenario: 页面样式文件命名规范
- **WHEN** 创建页面样式文件
- **THEN** 文件名使用 _<page-name>.scss 格式(如 _console.scss、_admin.scss
#### Scenario: 页面样式文件内容结构
- **WHEN** 查看页面样式文件
- **THEN** 该文件包含页面特定的布局、组件、状态等样式,使用清晰的注释分节