copyright-docs

catlog22's avatarfrom catlog22

Generate software copyright design specification documents compliant with China Copyright Protection Center (CPCC) standards. Creates complete design documents with Mermaid diagrams based on source code analysis. Use for software copyright registration, generating design specification, creating CPCC-compliant documents, or documenting software for intellectual property protection. Triggers on "软件著作权", "设计说明书", "版权登记", "CPCC", "软著申请".

⭐837stars🔀72forks📁View on GitHub🕐Updated Jan 4, 2026
[Technical Writing]

When & Why to Use This Skill

This Claude skill automates the generation of professional software copyright design specification documents compliant with China Copyright Protection Center (CPCC) standards. By performing multi-phase source code analysis, it produces comprehensive documentation featuring Mermaid diagrams for system architecture, functional modules, and core algorithms, significantly accelerating the intellectual property registration process and ensuring high-quality technical documentation.

Use Cases

  • Software Copyright Registration: Automatically generating the mandatory 'Software Design Specification' (软件设计说明书) required for CPCC filings, reducing manual drafting time by over 90%.
  • Intellectual Property Protection: Creating structured technical records of software logic, data structures, and interfaces to establish a robust legal foundation for corporate IP assets.
  • Automated Architecture Visualization: Transforming complex source code into clear Mermaid-based flowcharts, class diagrams, and sequence diagrams for technical audits or project handovers.
  • Compliance-Ready Documentation: Ensuring all technical documents adhere to specific regulatory formats through an automated multi-agent verification and refinement workflow.
namecopyright-docs
descriptionGenerate software copyright design specification documents compliant with China Copyright Protection Center (CPCC) standards. Creates complete design documents with Mermaid diagrams based on source code analysis. Use for software copyright registration, generating design specification, creating CPCC-compliant documents, or documenting software for intellectual property protection. Triggers on "软件著作权", "设计说明书", "版权登记", "CPCC", "软著申请".
allowed-toolsTask, AskUserQuestion, Read, Bash, Glob, Grep, Write

Software Copyright Documentation Skill

Generate CPCC-compliant software design specification documents (软件设计说明书) through multi-phase code analysis.

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐
│  Context-Optimized Architecture                                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Phase 1: Metadata        → project-metadata.json               │
│           ↓                                                      │
│  Phase 2: 6 Parallel      → sections/section-N.md (直接写MD)    │
│           Agents              ↓ 返回简要JSON                     │
│           ↓                                                      │
│  Phase 2.5: Consolidation → cross-module-summary.md             │
│           Agent               ↓ 返回问题列表                     │
│           ↓                                                      │
│  Phase 4: Assembly        → 合并MD + 跨模块总结                  │
│           ↓                                                      │
│  Phase 5: Refinement      → 最终文档                             │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Key Design Principles

  1. Agent 直接输出 MD: 避免 JSON → MD 转换的上下文开销
  2. 简要返回: Agent 只返回路径+摘要，不返回完整内容
  3. 汇总 Agent: 独立 Agent 负责跨模块问题检测
  4. 引用合并: Phase 4 读取文件合并，不在上下文中传递

Execution Flow

┌─────────────────────────────────────────────────────────────────┐
│  Phase 1: Metadata Collection                                    │
│  → Read: phases/01-metadata-collection.md                        │
│  → Collect: software name, version, category, scope              │
│  → Output: project-metadata.json                                 │
├─────────────────────────────────────────────────────────────────┤
│  Phase 2: Deep Code Analysis (6 Parallel Agents)                 │
│  → Read: phases/02-deep-analysis.md                              │
│  → Reference: specs/cpcc-requirements.md                         │
│  → Each Agent: 分析代码 → 直接写 sections/section-N.md           │
│  → Return: {"status", "output_file", "summary", "cross_notes"}   │
├─────────────────────────────────────────────────────────────────┤
│  Phase 2.5: Consolidation (New!)                                 │
│  → Read: phases/02.5-consolidation.md                            │
│  → Input: Agent 返回的简要信息 + cross_module_notes              │
│  → Analyze: 一致性/完整性/关联性/质量检查                         │
│  → Output: cross-module-summary.md                               │
│  → Return: {"issues": {errors, warnings, info}, "stats"}         │
├─────────────────────────────────────────────────────────────────┤
│  Phase 4: Document Assembly                                      │
│  → Read: phases/04-document-assembly.md                          │
│  → Check: 如有 errors，提示用户处理                               │
│  → Merge: Section 1 + sections/*.md + 跨模块附录                  │
│  → Output: {软件名称}-软件设计说明书.md                            │
├─────────────────────────────────────────────────────────────────┤
│  Phase 5: Compliance Review & Refinement                         │
│  → Read: phases/05-compliance-refinement.md                      │
│  → Reference: specs/cpcc-requirements.md                         │
│  → Loop: 发现问题 → 提问 → 修复 → 重新检查                        │
└─────────────────────────────────────────────────────────────────┘

Document Sections (7 Required)

Section Title Diagram Agent
1 软件概述 - Phase 4 生成
2 系统架构图 graph TD architecture
3 功能模块设计 flowchart TD functions
4 核心算法与流程 flowchart TD algorithms
5 数据结构设计 classDiagram data_structures
6 接口设计 sequenceDiagram interfaces
7 异常处理设计 flowchart TD exceptions

Directory Setup

// 生成时间戳目录名
const timestamp = new Date().toISOString().slice(0,19).replace(/[-:T]/g, '');
const dir = `.workflow/.scratchpad/copyright-${timestamp}`;

// Windows (cmd)
Bash(`mkdir "${dir}\\sections"`);
Bash(`mkdir "${dir}\\iterations"`);

// Unix/macOS
// Bash(`mkdir -p "${dir}/sections" "${dir}/iterations"`);

Output Structure

.workflow/.scratchpad/copyright-{timestamp}/
├── project-metadata.json          # Phase 1
├── sections/                      # Phase 2 (Agent 直接写入)
│   ├── section-2-architecture.md
│   ├── section-3-functions.md
│   ├── section-4-algorithms.md
│   ├── section-5-data-structures.md
│   ├── section-6-interfaces.md
│   └── section-7-exceptions.md
├── cross-module-summary.md        # Phase 2.5
├── iterations/                    # Phase 5
│   ├── v1.md
│   └── v2.md
└── {软件名称}-软件设计说明书.md     # Final Output

Reference Documents

Document Purpose
phases/01-metadata-collection.md Software info collection
phases/02-deep-analysis.md 6-agent parallel analysis
phases/02.5-consolidation.md Cross-module consolidation
phases/04-document-assembly.md Document merge & assembly
phases/05-compliance-refinement.md Iterative refinement loop
specs/cpcc-requirements.md CPCC compliance checklist
templates/agent-base.md Agent prompt templates
../_shared/mermaid-utils.md Shared Mermaid utilities