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

强制执行规则

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

cp ~/.cursor/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 脚本实现，不需要手动处理：

项目信息检测

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

1. README.md / CLAUDE.md：查找标题和版本信息
2. package.json：name + version
3. pom.xml：artifactId + version
4. 用户输入

检测项目语言

检测文件	语言
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

源代码扫描规则

Java: src/main/java/**/controller/、service/、entity/ 等，排除 *Test.java

TypeScript/Vue/React: src/api/、src/stores/、src/pages/ 等，排除 *.spec.ts、node_modules/

Go: cmd/、internal/、pkg/，排除 *_test.go、vendor/

Python: src/、app/、lib/，排除 test_*.py、__pycache__/

C++: src/、include/，排除 *_test.cpp、build/

Ruby: app/controllers/、app/models/，排除 *_spec.rb

Rust: src/，排除 tests/、target/

页数控制

• 固定页数模式（默认60页）：每页约57行，按优先级扫描
• 自动模式（auto）：≤60页输出全部，>60页输出前30+后30页

DOCX格式规范

页面 A4，边距上下2.5cm、左3.0cm、右2.5cm，字体宋体+Courier New 10pt，单倍行距。

错误处理

错误	处理
无法检测项目信息	提示用户输入
未检测到源代码	报错并列出支持的语言
python-docx 未安装	自动 pip install 安装
代码量不足	警告并输出全部