chore(trae-skills): 新增软著登记技能并删除旧的英雄信息同步技能
1. 新增software-copyright-desk技能，用于辅助用户完成计算机软件著作权登记申请 2. 删除HeroInfo_to_CardPoolList.md废弃技能文档
This commit is contained in:
panFD
@@ -1,70 +0,0 @@
|
||||
---
|
||||
name: HeroInfo_to_CardPoolList
|
||||
description: 将 Cocos Creator 项目中 heroSet.ts 的 HeroInfo 全量同步到 CardSet.ts 的 CardPoolList。只要用户提到“根据 HeroInfo 自动补全/同步 CardPoolList”“按 cards_lv 映射 CardPoolList.lv”“按 HeroInfo.lv 映射 hero_lv”就应立即使用本技能执行批量转换与校验。
|
||||
---
|
||||
|
||||
# HeroInfo_to_CardPoolList
|
||||
|
||||
## 适用场景
|
||||
|
||||
当用户提出以下目标时使用本技能：
|
||||
|
||||
- 把 `HeroInfo` 里的所有英雄补进 `CardPoolList`
|
||||
- 保证卡池条目和英雄配置一一对应
|
||||
- 批量同步等级映射关系，避免手动漏配
|
||||
|
||||
## 固定输入位置
|
||||
|
||||
- 英雄源：`assets/script/game/common/config/heroSet.ts`
|
||||
- 卡池目标：`assets/script/game/common/config/CardSet.ts`
|
||||
|
||||
## 固定映射规则
|
||||
|
||||
- 仅处理英雄条目（`CardType.Hero`）
|
||||
- `CardPoolList.uuid = HeroInfo.uuid`
|
||||
- `CardPoolList.lv = HeroInfo.cards_lv`
|
||||
- `CardPoolList.hero_lv = HeroInfo.lv`
|
||||
- 英雄条目按 `CardPoolList.lv` 升序排序（同级按 `uuid` 升序）
|
||||
- 未指定时，英雄卡默认使用：
|
||||
- `type: CardType.Hero`
|
||||
- `cost: 3`
|
||||
- `weight: 25`
|
||||
|
||||
## 执行流程
|
||||
|
||||
1. 读取 `heroSet.ts`，定位 `export const HeroInfo` 对象。
|
||||
2. 解析所有英雄项（按实际对象内容为准，不依赖号段硬编码）。
|
||||
3. 提取每个英雄的 `uuid`、`cards_lv`、`lv`。
|
||||
4. 读取 `CardSet.ts` 中 `CardPoolList`。
|
||||
5. 仅对 `type: CardType.Hero` 条目做“新增或更新”：
|
||||
- 已存在同 `uuid`：更新 `lv` 与 `hero_lv`
|
||||
- 不存在同 `uuid`：按默认字段新增
|
||||
6. 对全部英雄卡条目按 `lv` 升序重排（同级按 `uuid` 升序）。
|
||||
7. 非英雄卡（如 `Special/Skill/Buff/Debuff`）保持原样和原顺序。
|
||||
8. 输出结果后做一致性校验：
|
||||
- `HeroInfo` 英雄数量 == `CardPoolList` 英雄数量
|
||||
- 每个英雄 `uuid` 都能在 `CardPoolList` 找到
|
||||
- 每个条目都满足 `lv=cards_lv` 且 `hero_lv=HeroInfo.lv`
|
||||
- 英雄条目顺序满足 `lv` 升序
|
||||
|
||||
## 输出要求
|
||||
|
||||
- 优先直接修改 `CardSet.ts`，不新建额外文档文件。
|
||||
- 最终反馈必须包含：
|
||||
- 新增了多少英雄条目
|
||||
- 更新了多少已有英雄条目
|
||||
- 是否存在无法映射的异常条目
|
||||
|
||||
## 失败处理
|
||||
|
||||
出现以下情况必须停止并明确报错：
|
||||
|
||||
- `HeroInfo` 结构不存在或语法异常
|
||||
- 英雄缺失 `uuid/cards_lv/lv` 任一关键字段
|
||||
- `CardPoolList` 结构不存在
|
||||
|
||||
## 质量门槛
|
||||
|
||||
- 不改动与本任务无关的字段
|
||||
- 不改变非英雄卡逻辑
|
||||
- 修改后需确认 TypeScript 诊断无新增错误
|
||||
288
.trae/skills/software-copyright-desk/SKILL.md
Normal file
288
.trae/skills/software-copyright-desk/SKILL.md
Normal file
@@ -0,0 +1,288 @@
|
||||
---
|
||||
name: "software-copyright-desk"
|
||||
description: "Guides users through filling the official software copyright (计算机软件著作权) registration application. Invoke when user asks about 软著 / 软件著作权 / 软件登记 / 著作权人填报 / 源程序 / 设计说明书 / 操作手册 / 软著加急 / 软著流程."
|
||||
---
|
||||
|
||||
# Software Copyright Desk
|
||||
|
||||
通过结构化提问，帮用户整理《计算机软件著作权登记申请表》所需的全部材料，并输出可直接粘贴到中国版权保护中心在线填报系统的规范化文本。
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 用户首次办理软著登记，不知道该准备什么
|
||||
- 用户已有初稿，需要按登记要求规范化、补齐必填项
|
||||
- 用户想确认材料是否齐全、是否有常见退回风险
|
||||
|
||||
不适用于：
|
||||
- 电子版权认证（项目已停用此线）
|
||||
- 软件专利、商标、版权交易等其他知识产权事务
|
||||
|
||||
## 工作流程
|
||||
|
||||
### 第 1 步：明确用户当前进度
|
||||
|
||||
先问清用户处于以下哪个阶段，据此决定提问顺序：
|
||||
|
||||
1. **完全空白**：还没填过任何材料
|
||||
2. **已有部分信息**：手头有软件名、著作权人信息、功能描述等
|
||||
3. **已有初稿**：需要审校、补全、规范
|
||||
|
||||
### 第 2 步：按 Profile 结构收集信息
|
||||
|
||||
参考 `src/types/index.ts` 的字段结构，分四组提问：
|
||||
|
||||
**软件基本信息（SoftwareInfo）**
|
||||
- 软件全称（必填，格式建议：品牌/主体名 + 功能 + 软件）
|
||||
- 软件简称（可选）
|
||||
- 版本号（默认 V1.0）
|
||||
- 软件分类（应用软件 / 系统软件 / 支撑软件 / 嵌入式软件 / 中间件 / 游戏软件 / 其他）
|
||||
- 开发完成日期（须早于或等于申请日期）
|
||||
- 发表状态：未发表 / 已发表（如已发表需补充首次发表日期与地点）
|
||||
- 开发方式：独立开发 / 合作开发 / 委托开发 / 下达任务开发
|
||||
- 权利取得方式：原始取得 / 继受取得
|
||||
- 权利范围：全部权利（默认）
|
||||
|
||||
**著作权人信息（OwnerInfo）**
|
||||
- 主体类型：个人 / 企业 / 其他组织
|
||||
- 姓名 / 单位全称（须与证件完全一致）
|
||||
- 证件类型（依主体类型变化）
|
||||
- 证件号码
|
||||
- 国籍 / 注册地（默认中国）
|
||||
- 地址（与证件地址或营业执照住所一致）
|
||||
- 邮编、联系人、联系电话、电子邮箱
|
||||
|
||||
**软件描述（DescInfo）**
|
||||
- 硬件环境（CPU、内存、硬盘、网络）
|
||||
- 软件环境（操作系统 / 平台）
|
||||
- 编程语言
|
||||
- 源程序量（行数）
|
||||
- 主要功能（200-300 字）
|
||||
- 技术特点（150-250 字，可选）
|
||||
|
||||
**功能模块（ManualModule[]）**
|
||||
- 用户补充或从"主要功能"拆解得到 6-8 个模块
|
||||
- 每个模块名 + 一句话描述
|
||||
|
||||
### 第 3 步：生成材料
|
||||
|
||||
按以下顺序产出，每段都可直接复制使用：
|
||||
|
||||
1. **填报速查表**：调用 `buildSummary` 的输出结构（分组：软件基本信息 / 著作权人信息 / 软件描述）
|
||||
2. **源程序文档**：见下方"源程序专项"章节
|
||||
3. **设计说明书 / 用户操作手册**：调用 `buildManual` 的章节模板，可选其一：
|
||||
- 设计说明书：引言 / 运行环境 / 功能模块设计 / 数据结构与接口设计 / 安全与异常处理 / 联系方式
|
||||
- 用户操作手册：引言 / 运行环境 / 安装与启动 / 功能操作说明 / 常见问题 / 联系方式
|
||||
|
||||
### 源程序专项
|
||||
|
||||
源程序文档与说明书是两件不同的材料，必须**分别**准备和提交。
|
||||
|
||||
#### 提交要求（来自登记规范）
|
||||
|
||||
- 取前 30 页 + 后 30 页，不足 60 页时全部提交
|
||||
- 每页不少于 50 行有效代码
|
||||
- 页眉：左侧标注 `软件全称 版本号`，右侧标注 `第 N 页 共 M 页`
|
||||
- 9.5pt 等宽字体，每行不超过 84 字符（A4 折行限制）
|
||||
- 文件名示例：`软件全称_V1.0_源程序.pdf`
|
||||
|
||||
#### 三种生成方式（按用户掌握情况选用）
|
||||
|
||||
**方式 A：用户手头有源代码（推荐）**
|
||||
|
||||
让用户提供源代码文件路径或粘贴代码文本，Skill 直接执行 `paginateCode` 逻辑：
|
||||
|
||||
```text
|
||||
1. 把 \r\n 替换为 \n，\t 替换为 4 空格
|
||||
2. 按每页 50 行切分，得到 N 页
|
||||
3. 若 N > 60：保留前 30 页 + 后 30 页，丢弃中间
|
||||
4. 给每页加上统一页眉
|
||||
5. 用 A4 纸张打印 / 导出 PDF
|
||||
```
|
||||
|
||||
输出格式示例：
|
||||
|
||||
```
|
||||
============== 第 1 页 共 60 页 ==============
|
||||
软件全称：星辰记账软件 V1.0
|
||||
=============================================
|
||||
[此处为第 1-50 行代码]
|
||||
```
|
||||
|
||||
```
|
||||
============== 第 60 页 共 60 页 ==============
|
||||
软件全称：星辰记账软件 V1.0
|
||||
=============================================
|
||||
[此处为最后 50 行代码]
|
||||
```
|
||||
|
||||
**方式 B：用户仅有软件雏形 / 部分代码**
|
||||
|
||||
引导用户补齐以下内容后再次提交：
|
||||
|
||||
- 主入口文件（如 `main.ts` / `MainActivity.java` / `app.py`）
|
||||
- 核心业务模块（至少 6-8 个关键文件）
|
||||
- 与"主要功能 / 功能模块"一一对应的实现片段
|
||||
|
||||
如果代码量不足 3000 行（登记常见下限），提示用户补充占位实现 / 注释 / 单元测试，使总行数达到合理区间（3000-10000 行）。
|
||||
|
||||
**方式 C：用户完全没有代码**
|
||||
|
||||
明确告知：**软著登记不接受纯文字描述代替源程序**，必须有真实可运行的代码。Skill 可以：
|
||||
|
||||
- 引导用户先把软件做出来（或至少做出 MVP）
|
||||
- 或者按用户描述的功能，生成一份**可直接复制运行的参考骨架代码**（如 React + Vite + TS 项目骨架、Python Flask API 骨架、Android Activity 骨架），用户拿去做二次开发
|
||||
|
||||
骨架生成时遵循：
|
||||
- 不依赖任何有版权争议的代码片段
|
||||
- 包名 / 模块名用中性占位（`com.example.app`）
|
||||
- 文件头不留第三方 License 声明（避免 `reviewCode` 第 4 条报错）
|
||||
|
||||
#### 源程序审校（调用 `reviewCode` 规则）
|
||||
|
||||
生成或用户提供代码后，必须执行以下检查并报告问题：
|
||||
|
||||
| # | 检查项 | 等级 | 处理方式 |
|
||||
|---|---|---|---|
|
||||
| 1 | 乱码 / 控制字符 > 0.5% | error | 提示用户上传了二进制文件，需重传 |
|
||||
| 2 | 空行占比 > 30% | warn | 删除无意义空行，避免被认定"凑页数" |
|
||||
| 3 | 注释行占比 > 40% | info | 建议补充有效代码 |
|
||||
| 4 | 含第三方 License / Copyright 声明且与著作权人不一致 | error | 必须删除或修改 |
|
||||
| 5 | 实际行数与速查表"源程序量"相差 > 10% | warn | 同步修改申请表 |
|
||||
| 6 | 单行字符数 > 84 | warn | 折行换段 |
|
||||
| 7 | 含与著作权人无关的手机号 / 邮箱 | info | 脱敏后提交 |
|
||||
| 8 | 混入 package-lock.json / node_modules / .min.js 等构建产物 | warn | 移除后再上传 |
|
||||
|
||||
#### 输出三档结论
|
||||
|
||||
- ✅ **可直接提交**：无 error，无 warn
|
||||
- ⚠️ **建议修改**：无 error，有 warn，列出具体项
|
||||
- ❌ **必须修改**：有 error，阻断提交
|
||||
|
||||
## 设计说明书与用户操作手册（详细）
|
||||
|
||||
Skill 必须能根据"功能模块"列表生成完整的说明书文档，章节结构与项目代码 `buildManual` 一致：
|
||||
|
||||
### 设计说明书模板
|
||||
|
||||
```
|
||||
# 软件全称 V1.0
|
||||
# 设计说明书
|
||||
著作权人 · 完成日期
|
||||
|
||||
## 一、引言
|
||||
### 1.1 编写目的
|
||||
本文档用于说明「软件全称（V1.0）」的总体设计思路、功能结构与运行环境，作为计算机软件著作权登记的鉴别材料。
|
||||
### 1.2 软件概述
|
||||
主要功能正文（200-300 字）
|
||||
### 1.3 技术特点
|
||||
技术特点正文（150-250 字）
|
||||
|
||||
## 二、运行环境
|
||||
### 2.1 硬件环境
|
||||
### 2.2 软件环境
|
||||
开发语言：xxx
|
||||
|
||||
## 三、功能模块设计
|
||||
### 3.1 模块A
|
||||
模块A的处理流程、输入输出
|
||||
### 3.2 模块B
|
||||
...
|
||||
|
||||
## 四、数据结构与接口设计
|
||||
（请根据实际补充：核心数据表结构、关键字段说明、模块间接口与调用关系）
|
||||
|
||||
## 五、安全与异常处理
|
||||
（请根据实际补充：权限控制、数据校验、异常捕获与日志记录机制）
|
||||
|
||||
## 六、联系方式
|
||||
技术支持：xxx
|
||||
联系电话：xxx 电子邮箱：xxx
|
||||
```
|
||||
|
||||
### 用户操作手册模板
|
||||
|
||||
```
|
||||
# 软件全称 V1.0
|
||||
# 用户操作手册
|
||||
著作权人 · 完成日期
|
||||
|
||||
## 一、引言
|
||||
### 1.1 编写目的
|
||||
### 1.2 软件概述
|
||||
|
||||
## 二、运行环境
|
||||
### 2.1 硬件环境
|
||||
### 2.2 软件环境
|
||||
开发语言：xxx
|
||||
|
||||
## 三、安装与启动
|
||||
### 3.1 安装步骤
|
||||
### 3.2 启动与登录
|
||||
|
||||
## 四、功能操作说明
|
||||
### 4.1 模块A
|
||||
入口位置、操作步骤、预期结果
|
||||
### 4.2 模块B
|
||||
...
|
||||
|
||||
## 五、常见问题
|
||||
（请列举 3-5 个使用中的常见问题及解决办法）
|
||||
|
||||
## 六、联系方式
|
||||
```
|
||||
|
||||
### 写作要求
|
||||
|
||||
- 使用书面语，句式完整
|
||||
- 一律用「本软件」指代软件本身
|
||||
- 不出现第三方产品名、公司名、品牌名
|
||||
- 游戏软件使用玩家、关卡、战斗、背包、任务、商城等术语
|
||||
- 其他软件使用用户、模块、数据、接口、权限、校验等术语
|
||||
- 操作手册中"操作步骤"用 1. 2. 3. 编号
|
||||
- 说明书建议配图 5-10 张（提示用户在 Word 中补）
|
||||
|
||||
### 第 4 步：自动审校
|
||||
|
||||
参考 `src/lib/core.ts` 的 `reviewCode` 思路，对用户提交的内容做轻量检查：
|
||||
|
||||
- 必填项是否齐全（软件全称、版本号、完成日期、著作权人姓名/证件号/地址/联系方式、运行环境、主要功能）
|
||||
- 软件名称、版本号在申请表、源程序页眉、说明书封面是否完全一致
|
||||
- 著作权人姓名/单位名是否与平台注册主体一致
|
||||
- 主要功能、技术特点是否包含第三方品牌名、公司名
|
||||
- 源程序量是否在 3000 行以上、不超过 10 万行
|
||||
- 主要功能是否使用书面语、是否完整描述软件做什么、面向谁、解决什么问题
|
||||
- 源程序是否通过 `reviewCode` 的 8 项检查（详见"源程序专项"章节）
|
||||
- 说明书 / 操作手册的"软件全称 / 版本号 / 著作权人"与速查表是否完全一致
|
||||
|
||||
输出"通过 / 建议修改 / 必须修改"三档结论，列出问题清单。
|
||||
|
||||
## 关键规则
|
||||
|
||||
- 所有对外材料一律使用「本软件」指代软件本身，不出现具体产品名
|
||||
- 不夸大功能，不杜撰用户量、市场数据
|
||||
- 著作权人姓名 / 单位名必须与证件完全一致，提醒用户核对
|
||||
- 软件分类影响描述模板：游戏软件用玩家、关卡、战斗等术语；其他软件用用户、模块、接口、权限等术语
|
||||
- 写作风格：书面语、句式完整、不使用口语化表达
|
||||
|
||||
## 输出格式
|
||||
|
||||
每次回复使用以下结构：
|
||||
|
||||
```
|
||||
📋 当前进度：<阶段>
|
||||
✅ 已收集：<字段列表>
|
||||
⏳ 待补充：<字段列表>
|
||||
📝 下一步建议：<具体动作>
|
||||
```
|
||||
|
||||
材料生成完毕后，附上"提交前自检清单"和"官方办理入口"提示（[中国版权保护中心](https://www.ccopyright.com.cn)）。
|
||||
|
||||
## 项目代码参考
|
||||
|
||||
实现细节可参考 `src/lib/core.ts` 中的以下函数：
|
||||
- `buildSummary(p)`：生成填报速查表
|
||||
- `buildManual(p, type, modules)`：生成说明书
|
||||
- `reviewCode(input)`：源程序提交前检查规则
|
||||
- `paginateCode(code, linesPerPage, keepHeadTail)`：源程序分页逻辑
|
||||
- `FEATURE_TEMPLATES` / `TECH_TEMPLATES`：主要功能与技术特点模板
|
||||
- `HARDWARE_PRESETS` / `OS_PRESETS` / `LANGUAGE_PRESETS`：硬件/软件/语言常用片段
|
||||
Reference in New Issue
Block a user