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,37 @@
## Purpose
技能发布信息版本化管理,确保所有在技能商店展示的信息(名称、描述、分类、标签、图标)都跟随版本,任何变更都必须经过版本审核流程。
## Requirements
### Requirement: 发布信息跟随版本
每个版本 SHALL 包含完整的技能发布信息,这些信息在版本审核通过后成为技能商店展示的内容。
#### Scenario: 版本发布信息字段
- **WHEN** 创建新版本时
- **THEN** 版本必须包含以下发布信息字段:技能发布名称、技能发布描述、分类、标签、图标
#### Scenario: 商店展示内容来源
- **WHEN** 用户在技能商店查看技能时
- **THEN** 展示内容来自当前生效版本的发布信息字段,而非 Skill 对象
### Requirement: 内部信息与发布信息分离
Skill 对象 SHALL 仅保留开发者内部使用的名称和描述,与商店发布信息完全分离。
#### Scenario: 内部信息字段
- **WHEN** 创建或编辑技能时
- **THEN** Skill 对象仅包含:开发者内部技能名称、开发者内部技能描述
#### Scenario: 内部信息编辑权限
- **WHEN** 开发者编辑技能内部信息时
- **THEN** 可在任何状态下编辑,无需审核,不影响技能商店展示
### Requirement: 发布信息修改必须发版
修改技能商店展示的发布信息 SHALL 必须通过发布新版本实现。
#### Scenario: 发布信息修改路径
- **WHEN** 开发者需要修改技能商店展示的名称、描述、分类、标签或图标时
- **THEN** 必须上传新版本,在新版本中填写新的发布信息,提交审核
#### Scenario: 版本继承发布信息
- **WHEN** 上传非首个版本时
- **THEN** 发布信息表单默认继承当前生效版本的发布信息值