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…

What is this?A Skill that automatically generates the materials needed to register a Chinese software copyright (软件著作权): an application form, user manual, technical documentation, and code material, built from real analysis of your project and delivered as checked DOCX and PDF files.
Is this a standalone app, or does it run inside an AI agent?It is an Agent Skill, not a standalone app: you open your target project inside an AI agent that has the skill installed (Codex, Claude Code, Cursor, OpenCode, WorkBuddy, QoderWork, TraeWork, etc.) and the agent drives the whole process.
How do I generate the materials?Open your target project in an agent that has the skill installed and invoke it; the agent collects registration facts, lets you pick a screenshot method, then runs project analysis, material generation, PDF conversion, page-by-page review and packaging, and tells you the final delivery location.
What do I need installed to run it standalone, outside an agent?You need the base dependencies installed, plus extra packages only if you want automatic web screenshots; PDF conversion requires LibreOffice or Microsoft Word (LibreOffice preferred), and page-by-page rendering needs Poppler's pdftoppm or pdftocairo.
Does this guarantee my registration will be accepted?No - it only handles material compilation, formatting, and quality checks; it does not verify ownership, originality, factual accuracy, or the registration system's current-day requirements, so you must double-check every fact before submitting.
What does the agent actually scan to build its evidence?It scans README files, config, routes, pages, components, services, APIs, models, tests, deployment setup and any existing screenshots, so every claim in the generated materials can be traced back to real evidence or a real run.
What exactly do I get when it finishes?A 申请表信息.txt to paste into the registration system, a DOCX for editing in Word or WPS, a PDF for upload, and a code material document made of the full original source files with original filenames, line numbers, and hashes preserved for traceability.
How long are the generated manual and code material?The user manual is organized by real features in A4, black-white-gray office formatting, typically 40-60 pages for content-rich projects and shorter for small ones; the code material is one volume unless it exceeds 60 pages, in which case it splits into first/last 30-page volumes.
How does it capture UI screenshots for the manual?It supports four routes: Chrome DevTools automation, Computer Use, screenshots you provide yourself, or skipping screenshots entirely; whichever route is used, the plan, file hash, and section mapping get recorded.
Size
5.4 MB
Stars
164
Updated
CommitAug 17
Age
2mo
Commits · 90 Days