refactor: 整理规范文件 - 合并冗余、优化命名(32→20)
- 删除 12 个规范:空目录、重复规范、被吸收的子集规范 - 合并 4 组规范:管理台页面、开发台页面、布局体系、组件+反馈 - 重命名 8 个规范:统一平台前缀、暴露可搜索关键词、消除语义冲突 - 新增 docs/规范整理.md:规范审查流程提示词模板
This commit is contained in:
37
openspec/specs/skill-publish-versioning/spec.md
Normal file
37
openspec/specs/skill-publish-versioning/spec.md
Normal 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** 发布信息表单默认继承当前生效版本的发布信息值
|
||||
Reference in New Issue
Block a user