software-certificate-skill README

The project's README from github.com/IvanCodesDev/software-certificate-skill. As one markdown file: README.md.

exec-1908e30b-b18f-440b-bd7f-5c282be37a79

Software Certificate Skill

这是一款面向真实项目的软件著作权申请资料生成 Skill,它能够自动分析项目、提取业务证据、选择源码,生成申请表、操作手册、代码材料,并输出可检查的 DOCX 与 PDF。中间证据和诊断文件写入系统临时目录,项目中只保留正式资料。

Python 3.10+ Multi-Agent DOCX, PDF and TXT output MIT License

快速使用

在已安装此 Skill 的 Agent 中打开目标项目,输入:

为当前项目生成软件著作权申请资料

Agent 会一次收集登记事实并让你选择截图方式,随后完成项目分析、材料生成、PDF 转换、逐页检查和打包。最终交付位置和待确认事项会直接告知你。

交付物

正式资料/
├─ 申请表信息.txt
├─ <软件全称>_操作手册.docx / .pdf
├─ <软件全称>-代码(前30页).docx / .pdf   # 源码达到60页时
├─ <软件全称>-代码(后30页).docx / .pdf   # 源码达到60页时
└─ <软件全称>-代码(全部).docx / .pdf     # 源码不足60页时

示例

下面是一次从登记事实收集到正式材料生成的示例流程。图片仅用于说明界面和交付效果,示例中的登记信息仍需替换为真实事实。

image发起资料生成任务 image确认软件名称、版本和开发事实
image 生成结果与正式资料目录 image操作手册页面
image 操作手册页面 image 代码材料前30页
image 代码材料后30页 image 代码材料后30页
image 申请表信息 image 申请表信息

安装

git clone https://github.com/IvanCodesDev/software-certificate-skill.git
cd software-certificate-skill
python scripts/install_agent_skill.py --platform all --scope project --project E:\path\to\project --force

支持 Codex、Claude Code、Cursor、OpenCode、WorkBuddy、QoderWork、TraeWork等多款Agent平台,只预览不写入:

python scripts/install_agent_skill.py --platform all --scope project --project E:\path\to\project --dry-run

独立运行

安装基础依赖:

python -m pip install -r requirements.txt

需要 Web 自动截图时再安装:

python -m pip install "playwright>=1.49,<2"
python -m playwright install chromium

准备、继续、查看状态或回滚:

python scripts/product_workflow.py prepare --project E:\path\to\project
python scripts/product_workflow.py resume --project E:\path\to\project
python scripts/product_workflow.py status --project E:\path\to\project
python scripts/product_workflow.py rollback --project E:\path\to\project

prepare 生成集中表单、截图选择卡和内部分析任务;完成表单后运行 resume。PDF 转换需要 LibreOffice 或 Microsoft Word(优先 LibreOffice);逐页渲染需要 Poppler 的 pdftoppm 或 pdftocairo。

处理范围与约束

测试

测试会在系统临时目录创建脱敏最小项目,结束后自动清理,不依赖仓库内置 Demo:

python -m unittest discover -s tests -v
python scripts/validate_skill.py
python scripts/self_test.py --workdir "${TEMP}/software-certificate-self-test"

贡献与免责声明

本项目使用 MIT License。提交 Issue/PR 前请阅读 贡献指南。不得提交真实证件、账号、密钥、未授权源码或可识别申请材料;测试夹具必须脱敏;新增规则需标注来源等级和日期。

本项目只负责材料整理、排版和质量检查,不替代申请人核验权属、原创性、事实真实性及登记系统当日要求。提交前请逐项复核登记事实和声明。

software-certificate-skill (IvanCodesDev/software-certificate-skill)

Searching Database…

这是什么?一个自动生成中国软件著作权登记所需材料的技能:申请表、用户手册、技术文档和代码材料,全部基于对你项目的真实分析生成,并交付经过校验的 DOCX 和 PDF 文件。
这是独立应用,还是运行在 AI 智能体里?它是一个 Agent Skill(智能体技能),不是独立应用:你在装有该技能的 AI 智能体(Codex、Claude Code、Cursor、OpenCode、WorkBuddy、QoderWork、TraeWork 等)中打开目标项目,由智能体驱动整个流程。
我怎么生成这些材料?在装有该技能的智能体中打开目标项目并调用它;智能体会收集登记所需信息,让你选择截图方式,然后执行项目分析、材料生成、PDF 转换、逐页审校和打包,并告诉你最终交付位置。
在智能体之外独立运行它,需要安装什么?你需要安装基础依赖,只有想自动截取网页截图时才需要额外软件包;PDF 转换需要 LibreOffice 或 Microsoft Word(优先 LibreOffice),逐页渲染需要 Poppler 的 pdftoppm 或 pdftocairo。
它能保证我的登记申请被接受吗?不能——它只负责材料整理、排版和质量检查;不会核实权属、原创性、事实准确性,也不了解登记系统当下的要求,所以提交前你必须逐项核实所有事实。
智能体实际扫描什么来构建证据?它会扫描 README 文件、配置、路由、页面、组件、服务、API、模型、测试、部署设置以及已有的截图,因此生成材料中的每一条陈述都能追溯到真实证据或真实运行。
它完成时我具体能拿到什么?一个用于粘贴进登记系统的 申请表信息.txt、一个可在 Word 或 WPS 中编辑的 DOCX、一个用于上传的 PDF,以及一份由完整原始源码文件组成的代码材料文档,保留原始文件名、行号和哈希以便溯源。
生成的手册和代码材料有多长?用户手册按真实功能组织,采用 A4 黑白灰办公排版,内容丰富的项目通常 40-60 页,小项目更短;代码材料默认为一册,超过 60 页时拆分为前 30 页和后 30 页两册。
它如何为手册截取 UI 截图?它支持四种途径:Chrome DevTools 自动化、Computer Use、你自己提供的截图,或完全跳过截图;无论采用哪种途径,都会记录计划、文件哈希和章节映射。
Size
5.4 MB
Stars
164
Updated
CommitAug 17
Age
2mo
Commits · 90 Days