用SOLO 10分钟生成一套计算机软著材料的技能包

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的能力主要有以下:

  1. 针对每个技能的规范要求,给SOLO输入流程设计步骤和输出要求,制作Skill

  2. 软著操作手册,需要SOLO与Figma能够打通并能读取Figma的设计稿并理解产品流程与设计意图,按照产品的主流程及核心功能输出操作说明和功能描述,并调用Figma MCP的元素级接口获得配图

  3. 软著新登记、采集登记表中的软件主要功能,要求至少500字描述。通过SOLO读取操作手册并理解产品核心功能,归纳总结输出主要功能的描述

  4. 软著源代码文档,需要SOLO与Gitlab项目仓库打通并能读取多个Gitlab项目获得指引文件和源代码文件,理解仓库代码的组织结构和意图,整合输出源代码文档

  5. 通过SOLO对比人工输出的软著材料,进行复盘、修正、自我成长,以此更加拟合人工输出的格式及要求

3.4 关键Prompt/操作流程

  1. 软著操作手册,对技能的定义:

技能用途

software-copyright-manual 用于根据“软件名称 + Figma 设计稿链接”,生成可用于计算机软件著作权申报的软件操作手册/说明书,最终输出 .docx Word 文件,默认不少于 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)或提供可读截图。

  1. 软著新登记、采集登记表中的软件主要功能,对技能的定义:

技能用途

software-copyright-main-functions 用于根据软件操作手册、说明书或用户手册,生成软著登记信息采集表中的“软件主要功能”Word 文档,也就是常说的 A1 材料之一。

输出文件名通常为:

A1-软件名称-登记信息采集表-软件主要功能不少于500字.docx

用户需要提供

  • 软件操作手册 / 软件说明书 / 用户手册:必填,支持 .docx.pdf.md.txt

  • 软件名称:建议提供;如果不提供,会优先从手册封面、标题或概述中提取

  • 输出目录:选填,默认输出到当前工作目录

推荐提问模板


请根据以下软件说明书生成“软件主要功能”文档。
说明书文件:D:\path\3-XXX软件说明书.docx
软件名称:XXX

如果已经上传附件,也可以这样写:


请根据附件中的软件操作手册生成软著登记信息采集表中的“软件主要功能”文档。
软件名称:XXX

生成内容口径

正文默认控制在 500-1300 字,采用“总-分-总”结构:

开头:说明软件定位、服务对象和核心业务流程
中间:按模块说明主要功能
结尾:概括软件形成的业务闭环或使用效果

功能描述会尽量写清楚:

用户可以做什么
系统如何处理
最终形成什么结果

注意事项

  • 必须有来源手册,不能只凭软件名称编写。

  • 只写手册中能追溯到的功能,不编造模块。

  • 不写营销化表述,例如“极大提升效率”“充分体现先进性”。

  • 不暴露“根据手册”“AI 生成”等过程性措辞。

  • 敏感信息会按需替换为 ****

输出结果

最终交付 Word .docx,并通常会同时生成一个 .manifest.json,用于记录来源文件、字数和检查结果。

  1. 软著源代码文档,对技能的定义:

技能用途

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.javamain.tsApp.vue

  • 优先覆盖用户指定或操作手册提到的功能模块。

  • 如果有前端和后端,尽量同时体现两类技术栈。

  • 默认生成约 5500-6500 行有效代码,不一定固定 6000 行,避免过于机械。

输出说明

完成后会告知:

Word 文件路径
有效代码总行数
源码文件数量
前端/后端代码行数分布
是否覆盖了指定功能模块

如果仓库无权限、Token 过期或角色不足,会提示重新提供具备权限的 PAT。

3.5 中间过程踩过什么坑?

  1. 通过SOLO打通figma、gitlab的授权过程中,遇到Persional Access Token的授权问题,要确保覆盖读取权限,特别gitlab还要至少Reporter角色及以上

  2. 通过SOLO + figma MCP时,要明确指定获取图片元素级导出或者截图方式获得配图,避免获得figma的全局预览图等模糊的图片,不符合规范要求

  3. SOLO产生的交付物目录是在SOLO 的内置应用数据区域(/mnt/appuserdata/),属于系统内部路径,无法直接在自己的电脑文件管理器中找到,它存在于 SOLO 运行的虚拟机内部。如果需要本地查看或编辑,要将它们复制到你的工作区文件夹中 —— 这一点表示疑惑,这个设计的意图(技术人员看到可以联系我)

4.成果展示:

  1. 软著3个技能的定义,见上述3.4章节

  2. 软著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,操作手册文档模板与规范
  1. 生成3份文档的案例,仅截取几张脱敏的图片

源代码文件,不少于4000行代码:

软件操作手册,不少于15页,覆盖软件主要功能:

5.效果与总结:

使用SOLO后确实带给我很大的提效,特别是将过程沉淀为技能后,重复性的工作能够持续被复用提效。

原本每个软件产品完成3个软著材料大概要3~4个小时甚至更长,现在只需要10分钟就可以完成,且通过我多个产品反复验证,技能输出稳定且严格符合规范要求,基本无需人工修改的必要。

通过沉淀为技能,现在只需要一两句话,提供figma链接、gitlab项目地址,几分钟内就可以输出目标文档。下一步,我将会将这3个技能赋予给我即将设计的“软著小助手”,让这个过程变得更加简单,并且Agent能够具备Context上下文管理、记忆体系,能够更加理解我的习惯。

1 个赞

软著材料自动化这个点挺实际,第四点的避坑提醒也不错,比赛加这条确实更周全。

1 个赞

哎,楼主请教下——你说“A2-源代码不少于4000行”,那SOLO技能是怎么保证生成的行数达标且格式合规的?我之前自己写的时候经常被卡在分页和注释格式上。

1 个赞

你看我生成策略那里,是要约束生成的代码行数在要超出4000行,但在6000行左右上下浮动。

文件要排除某些格式,同时文件内容要排除那种包括常量定义、注释太多的文件。我定义里有说