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

@@ -0,0 +1,77 @@
## Purpose
技能详情页面布局规范定义了技能开发台详情页的四段式布局结构,确保信息层级清晰,用户能够快速定位内部信息、当前生效版本、版本历史和管理操作。
## Requirements
### Requirement: 四段式页面布局
技能详情页面 SHALL 采用四段式卡片布局结构,依次展示头部概览(内部信息)、当前生效版本、版本历史、管理操作。
#### Scenario: 页面结构展示
- **WHEN** 用户打开技能详情页面
- **THEN** 页面从上到下依次显示:头部概览卡片(内部信息)、当前生效版本卡片、版本历史卡片、管理操作卡片
### Requirement: 返回按钮
技能详情页面 SHALL 在页面顶部显示返回按钮,允许用户返回上一级页面。
#### Scenario: 返回按钮显示
- **WHEN** 用户查看技能详情页面
- **THEN** 页面顶部显示返回按钮,点击后返回"我的技能"页面
### Requirement: 头部概览卡片(内部信息)
技能详情页面 SHALL 在页面顶部显示头部概览卡片,展示开发者内部信息。卡片具有白色背景、圆角 12px、轻微阴影效果。
#### Scenario: 概览卡片信息展示
- **WHEN** 用户查看技能详情页面
- **THEN** 头部概览卡片展示开发者内部信息:内部技能名称、状态标签
#### Scenario: 概览卡片第一行布局
- **WHEN** 用户查看头部概览卡片
- **THEN** 第一行显示:内部技能名称、状态标签、右上角"编辑内部信息"按钮
#### Scenario: 状态标签样式
- **WHEN** 用户查看概览卡片中的状态标签
- **THEN** 状态标签为纯文字样式,不使用图标,通过颜色区分状态类型(开发中、已上架、下架审核中、已下架)
#### Scenario: 响应式布局
- **WHEN** 用户在较小屏幕设备上查看概览卡片
- **THEN** 卡片内容自动调整布局,确保信息清晰可读
### Requirement: 当前生效版本卡片
技能详情页面 SHALL 在头部概览卡片下方显示当前生效版本卡片。
#### Scenario: 当前生效版本展示
- **WHEN** 用户查看技能详情页面且技能已上架
- **THEN** 显示当前生效版本卡片,展示该版本在技能商店的展示效果:技能发布名称、技能发布描述、分类、标签、图标、安装数、评分、版本号
#### Scenario: 无生效版本时
- **WHEN** 用户查看技能详情页面且技能尚未上架
- **THEN** 不显示当前生效版本卡片,或显示空状态提示
### Requirement: 版本历史卡片
技能详情页面 SHALL 在当前生效版本卡片下方显示版本历史卡片。
#### Scenario: 版本历史卡片展示
- **WHEN** 用户查看技能详情页面
- **THEN** 版本历史卡片包含标题"版本历史"和版本历史卡片列表(非表格)
#### Scenario: 版本历史操作按钮
- **WHEN** 用户查看版本历史卡片
- **THEN** 卡片标题栏右侧显示"上传新版本"按钮
### Requirement: 管理操作卡片
技能详情页面 SHALL 在版本历史卡片下方显示管理操作卡片。
#### Scenario: 管理操作卡片展示
- **WHEN** 用户查看技能详情页面
- **THEN** 管理操作卡片包含标题"管理"和操作按钮区
#### Scenario: 管理操作按钮展示
- **WHEN** 用户查看管理操作卡片
- **THEN** 卡片内直接展示"下架技能"和"删除技能"按钮
### Requirement: 卡片间距规范
技能详情页面的卡片之间 SHALL 保持一致的间距。
#### Scenario: 卡片间距
- **WHEN** 用户查看技能详情页面
- **THEN** 每个卡片之间有 16px 的垂直间距