# Ruanzhu

当用户执行 /ruanzhu 命令或请求生成软著源代码文档时触发。提供软著源代码 DOCX 生成规范。

- Repository: https://github.com/doccker/cc-use-exp (1063 stars)
- Category: Documents
- License: see repository
- Last updated: 2026-08-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add doccker/cc-use-exp --skill ruanzhu -g -a claude-code -y`
Codex: `npx skills add doccker/cc-use-exp --skill ruanzhu -g -a codex -y`
Cursor: `npx skills add doccker/cc-use-exp --skill ruanzhu -g -a cursor -y`
Gemini CLI: `npx skills add doccker/cc-use-exp --skill ruanzhu -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add doccker/cc-use-exp`

## Description

当用户执行 /ruanzhu 命令或请求生成软著源代码文档时触发。提供软著源代码 DOCX 生成规范。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ruanzhu 技能 - 软著源代码DOCX生成

## ⚠️ 强制执行规则

**必须执行以下命令，禁止任何其他操作：**

```bash
cp ~/.claude/templates/ruanzhu/generate_docx.py ./generate_docx.py && python3 generate_docx.py $ARGUMENTS && rm generate_docx.py
```

### 禁止事项

- ❌ 自行编写生成脚本
- ❌ 在项目中创建任何 `.py` 文件
- ❌ 检测 python-docx 是否安装
- ❌ 创建 venv 或手动安装依赖
- ❌ 搜索项目中的文件
- ❌ 执行项目中已有的任何脚本

### 唯一允许的操作

✅ 执行上面的 bash 命令（一条命令，用 && 连接）

### 执行后状态

- ✅ 生成 `docs/ruanzhu/{软件名称}{版本}-源代码.docx`
- ✅ 使用 `--different` 时，生成 `{软件名称}{版本}-源代码-2.docx`（编号递增）
- ✅ 项目中**不应有任何新增的 .py 文件**
- ✅ 临时脚本 `./generate_docx.py` 已被删除

---

## 参考信息（仅供了解，不要自行实现）

以下内容已由 `generate_docx.py` 脚本实现，**不需要手动处理**：

### 项目信息检测

按优先级读取项目名称和版本：

```python
# 优先级 1: CLAUDE.md
# 查找 "# {项目名}" 或 "## 项目概述" 下的内容
# 版本：查找 "版本：" 或 "version:"

# 优先级 2: package.json
{
  "name": "project-name",
  "version": "1.0.0"
}

# 优先级 3: pom.xml
<artifactId>project-name</artifactId>
<version>1.0.0</version>

# 优先级 4: 用户输入
```

### 2. 检测项目语言

根据文件存在性判断：

| 检测文件 | 语言 |
|---------|------|
| `pom.xml` 或 `build.gradle` | Java |
| `package.json` | JavaScript/TypeScript |
| `Cargo.toml` | Rust |
| `Gemfile` | Ruby |
| `go.mod` | Go |
| `*.cpp` 或 `CMakeLists.txt` | C++ |
| `requirements.txt` 或 `pyproject.toml` | Python |

### 3. 源代码扫描规则

#### Java
```
优先目录：
  - src/main/java/**/controller/
  - src/main/java/**/service/
  - src/main/java/**/entity/
  - src/main/java/**/repository/
  - src/main/java/**/config/
  - src/main/java/**/security/
  - src/main/java/**/dto/
  - src/main/java/**/

排除：
  - *Test.java
  - *IT.java
  - *Tests.java
  - target/
```

#### TypeScript/Vue/React
```
优先目录：
  - src/api/
  - src/stores/
  - src/pages/
  - src/views/
  - src/components/
  - src/hooks/
  - src/utils/
  - src/layouts/
  - frontend/src/

排除：
  - *.spec.ts
  - *.test.ts
  - *.test.tsx
  - *.d.ts
  - node_modules/
  - dist/
```

#### C++
```
优先目录：
  - src/
  - include/
  - lib/

排除：
  - *_test.cpp
  - *_test.cc
  - test/
  - tests/
  - build/
```

The rest: https://github.com/doccker/cc-use-exp/blob/HEAD/.antigravity/skills/ruanzhu/SKILL.md