1.摘要:
用 TRAE SOLO 制作了3个生成计算机软著相关材料的技能,能够稳定按照软著规范要求约束材料输出效果,无需再人工修改,真实可靠、拿来即用。
2.背景:
我是一名产品研发负责人,定期需要撰写计算机软著材料申报,原本每个产品需要3-4小时,效率较低。现在可以通过SOLO开发技能来提效。
3.实践过程:
3.1 背景说明
软著材料申报通常要求提供3份材料:《A1-软件新登记、采集登记表》、《A2-软件源代码-不能少于4000行》、《A3-软件操作手册-不能少于15页》。我希望能够制作3个技能来完成上述3份文档的生成,且能严格按照国家版权局的规范要求稳定输出,并且长期可复用于后续的软件产品的软著申报,达到长期提效的目的。
特别说明:通过AI仅作为辅助编写提效,实际中并非原封不动采纳。国家版权局规范要求是不能直接使用AI生车来申报的,请大家务必注意。这里是创新比赛,所以萌生创意想法探索而已。
3.2 任务拆解,一共4个步骤完成:
第一步,我要遵循国家版权局的规范要求,分别设计3个技能的流程与输出要求。
第二步,分别定义3个技能的Skill.md,可以通过SOLO帮我完成技能制作
第三步,分别验证3个技能的执行可行性,可以通过SOLO来打通Figma和Gitlab
第四步,分别使用3个技能生成软著的3份材料,验证效果是否存在偏差、异常,反复跟SOLO交互完善技能
3.3 使用到SOLO的能力主要有以下:
-
针对每个技能的规范要求,给SOLO输入流程设计步骤和输出要求,制作Skill
-
软著操作手册,需要SOLO与Figma能够打通并能读取Figma的设计稿并理解产品流程与设计意图,按照产品的主流程及核心功能输出操作说明和功能描述,并调用Figma MCP的元素级接口获得配图
-
软著新登记、采集登记表中的软件主要功能,要求至少500字描述。通过SOLO读取操作手册并理解产品核心功能,归纳总结输出主要功能的描述
-
软著源代码文档,需要SOLO与Gitlab项目仓库打通并能读取多个Gitlab项目获得指引文件和源代码文件,理解仓库代码的组织结构和意图,整合输出源代码文档
-
通过SOLO对比人工输出的软著材料,进行复盘、修正、自我成长,以此更加拟合人工输出的格式及要求
3.4 关键Prompt/操作流程
- 软著操作手册,对技能的定义:
技能用途
software-copyright-manual用于根据“软件名称 + Figma 设计稿链接”,生成可用于计算机软件著作权申报的软件操作手册/说明书,最终输出.docxWord 文件,默认不少于 15 页。用户需要提供
软件产品名称:必填,例如:飞书妙记
Figma 设计稿链接:必填,最好是具体页面或节点链接
历史说明书/操作手册:选填,用于参考排版、图注、语言风格
推荐提问模板
请根据以下 Figma 设计稿生成软著操作手册。 软件名称:XXX Figma 链接: 1. https://www.figma.com/design/xxx?node-id=xxx 2. https://www.figma.com/design/xxx?node-id=xxx 要求: 1. 重点覆盖:登录注册、我的主页、开始录制、字幕设置、会议总结、观点提炼、生成待办等模块。 2. 配图必须使用具体功能页面截图,不要使用 Figma 总览图、需求页或远景缩略图。 3. 文档不少于 15 页,输出 Word 文件。生成规则重点
必须读取真实 Figma 页面和截图,不能只根据图层名称编写。
配图要对应当前章节功能,例如列表页、详情页、编辑页、发布页、弹窗页。
禁止用 Figma 画布总览图、需求说明页、范围说明图替代功能截图。
截图必须完整清晰,不能裁掉顶部、导航、边缘或关键操作区。
敏感信息会统一脱敏为
****。软件名称全文保持一致。
输出结果
生成一个可交付的 Word 文档,通常命名为类似:
3-软件名称-软件说明书.docx如果 Figma 无权限或无法读取,需要先配置 Figma 访问能力(通常为PERSONAL_ACCESS_TOKEN)或提供可读截图。
- 软著新登记、采集登记表中的软件主要功能,对技能的定义:
技能用途
software-copyright-main-functions用于根据软件操作手册、说明书或用户手册,生成软著登记信息采集表中的“软件主要功能”Word 文档,也就是常说的 A1 材料之一。输出文件名通常为:
A1-软件名称-登记信息采集表-软件主要功能不少于500字.docx用户需要提供
软件操作手册 / 软件说明书 / 用户手册:必填,支持.docx、.md、.txt
软件名称:建议提供;如果不提供,会优先从手册封面、标题或概述中提取
输出目录:选填,默认输出到当前工作目录推荐提问模板
请根据以下软件说明书生成“软件主要功能”文档。 说明书文件:D:\path\3-XXX软件说明书.docx 软件名称:XXX如果已经上传附件,也可以这样写:
请根据附件中的软件操作手册生成软著登记信息采集表中的“软件主要功能”文档。 软件名称:XXX生成内容口径
正文默认控制在
500-1300字,采用“总-分-总”结构:开头:说明软件定位、服务对象和核心业务流程 中间:按模块说明主要功能 结尾:概括软件形成的业务闭环或使用效果功能描述会尽量写清楚:
用户可以做什么 系统如何处理 最终形成什么结果注意事项
必须有来源手册,不能只凭软件名称编写。
只写手册中能追溯到的功能,不编造模块。
不写营销化表述,例如“极大提升效率”“充分体现先进性”。
不暴露“根据手册”“AI 生成”等过程性措辞。
敏感信息会按需替换为
****。输出结果
最终交付 Word
.docx,并通常会同时生成一个.manifest.json,用于记录来源文件、字数和检查结果。
- 软著源代码文档,对技能的定义:
技能用途
software-copyright-source-code用于根据一个或多个 GitLab 仓库生成软著申报用的 A2 源代码 Word 文档,输出文件名通常为:A2-软件名称-源代码-不能少于4000行.docx用户需要提供
软件名称:必填,例如:飞书妙记
GitLab 仓库地址:必填,支持一个或多个仓库
PERSONAL_ACCESS_TOKEN:私有仓库通常必填
操作手册/说明书:选填;如果提供,会优先按手册中的核心功能匹配源码Token 权限要求
GitLab Token 至少需要:
read_api read_repository如果是 Project Access Token,角色建议至少为
Reporter。Token 只用于读取仓库源码,不应写入 Word、manifest 或技能文件。推荐提问模板:单仓库
请根据以下 GitLab 项目生成软著源码文档。 软件名称:XXX GitLab 地址:https://gitlab.example.com/group/project PAT:glpat-xxxx 要求: 1. 源码尽可能覆盖操作手册中的核心功能:登录、首页、录制管理、字幕设置、会议总结。 2. 剔除测试、配置、资源、常量表等非有效源码。 3. 输出 Word 文档。推荐提问模板:多仓库
请根据多个 GitLab 项目生成软著源码文档。 软件名称:XXX 前端项目:https://gitlab.example.com/group/frontend 前端项目 PAT:glpat-xxxx 后台项目:https://gitlab.example.com/group/backend 后台项目 PAT:glpat-yyyy 要求: 1. 尽可能覆盖核心功能:登录、我的主页、开始录制、字幕设置、会议总结、观点提炼、生成待办。 2. 尽可能同时包含前端代码和后端代码。 3. 剔除跟源码无关的文件。源码筛选规则
会保留真实源码,例如:
.java、.ts、.tsx、.js、.jsx、.vue、.py、.go、.kt、.cs 等会排除:
配置文件、资源文件、文档、图片、lock 文件、构建产物、node_modules、dist、target、测试文件、mock、demo、常量表、地区字典、纯静态数据文件同时会删除代码中的空行和注释,只保留有效代码行。
生成策略
优先从启动入口代码开始,例如
Application.java、main.ts、App.vue。优先覆盖用户指定或操作手册提到的功能模块。
如果有前端和后端,尽量同时体现两类技术栈。
默认生成约 5500-6500 行有效代码,不一定固定 6000 行,避免过于机械。
输出说明
完成后会告知:
Word 文件路径 有效代码总行数 源码文件数量 前端/后端代码行数分布 是否覆盖了指定功能模块如果仓库无权限、Token 过期或角色不足,会提示重新提供具备权限的 PAT。
3.5 中间过程踩过什么坑?
-
通过SOLO打通figma、gitlab的授权过程中,遇到Persional Access Token的授权问题,要确保覆盖读取权限,特别gitlab还要至少Reporter角色及以上
-
通过SOLO + figma MCP时,要明确指定获取图片元素级导出或者截图方式获得配图,避免获得figma的全局预览图等模糊的图片,不符合规范要求
-
SOLO产生的交付物目录是在SOLO 的内置应用数据区域(
/mnt/appuserdata/),属于系统内部路径,无法直接在自己的电脑文件管理器中找到,它存在于 SOLO 运行的虚拟机内部。如果需要本地查看或编辑,要将它们复制到你的工作区文件夹中 —— 这一点表示疑惑,这个设计的意图(技术人员看到可以联系我)
4.成果展示:
-
软著3个技能的定义,见上述3.4章节
-
软著3个技能成品的skill.md,见链接(30天有效):SOLO作品
阿里云盘分享
- software-copyright-manual.md,操作手册skill.md
- software-copyright-source-code.md,源代码文档skill.md
- software-copyright-main-functions.md,软件主要功能skill.md
- figma-guide.md,说明如何从 Figma 设计稿中获取功能页面截图,用于软著操作手册的配图
- doc-template.md,操作手册文档模板与规范
- 生成3份文档的案例,仅截取几张脱敏的图片
源代码文件,不少于4000行代码:
软件操作手册,不少于15页,覆盖软件主要功能:
5.效果与总结:
使用SOLO后确实带给我很大的提效,特别是将过程沉淀为技能后,重复性的工作能够持续被复用提效。
原本每个软件产品完成3个软著材料大概要3~4个小时甚至更长,现在只需要10分钟就可以完成,且通过我多个产品反复验证,技能输出稳定且严格符合规范要求,基本无需人工修改的必要。
通过沉淀为技能,现在只需要一两句话,提供figma链接、gitlab项目地址,几分钟内就可以输出目标文档。下一步,我将会将这3个技能赋予给我即将设计的“软著小助手”,让这个过程变得更加简单,并且Agent能够具备Context上下文管理、记忆体系,能够更加理解我的习惯。


