专业技术文档提升工具。评估文档质量（完整性、准确性、清晰度、结构化、可维护性），自动生成缺失文档（README、API 文档），检查文档与代码一致性，提供可执行的改进建议。使用场景：文档质量审计、缺失文档生成、文档一致性检查、文档改进规划、新项目文档搭建、发布前检查。支持所有编程语言。
专业的技术文档分析、生成和改进工具。
# 完整流程：分析 + 生成 + 检查 + 改进
python3 scripts/docs-improver.py --path /path/to/project --mode all --report report.md
# 仅质量评估
python3 scripts/analyze.py --path /path/to/project --output quality.md
# 仅文档生成
python3 scripts/generate.py --path /path/to/project --type readme
# 仅一致性检查
python3 scripts/consistency-check.py --path /path/to/project --output issues.md
# 仅改进建议
python3 scripts/improve.py --path /path/to/project --output plan.md
| 维度 | 说明 |
|---|---|
| 完整性 | 覆盖关键内容（30% 权重） |
| 清晰度 | 易读易懂（25% 权重） |
| 结构化 | 组织清晰（20% 权重） |
| 可维护性 | 易于更新（15% 权重） |
| 准确性 | 与代码一致（10% 权重） |
| 文档类型 | 说明 |
|---|---|
| README.md | 项目概述和快速开始 |
| API.md | API 接口文档 |
| ARCHITECTURE.md | 架构设计文档 |
| INSTALL.md | 安装部署指南 |
| CONTRIBUTING.md | 贡献指南 |
| CHANGELOG.md | 变更日志 |
| 优先级 | 时间 | 说明 |
|---|---|---|
| 快速获胜 | 几小时 | 立即可改的小问题 |
| 短期 | 几天 | 需要一定工作量 |
| 长期 | 几周 | 系统性改进 |
# 文档质量评估报告
## 总体评分：88/100 ✅
| 维度 | 评分 | 状态 |
|------|------|------|
| 完整性 | 80/100 | ✅ 良好 |
| 清晰度 | 100/100 | ✅ 优秀 |
| 结构化 | 85/100 | ✅ 良好 |
| 可维护性 | 100/100 | ✅ 优秀 |
## 改进建议
### 快速获胜（几小时）
- [ ] 添加项目描述和徽章
- [ ] 添加代码示例
### 短期（几天）
- [ ] 创建 API 文档
- [ ] 添加架构图
### 长期（几周）
- [ ] 建立自动化文档生成
- [ ] 建立文档审查流程
# 一致性检查报告
## 发现问题：5 个
### 严重 (1)
1. API 端点 /api/users 存在于代码但未文档化
### 主要 (2)
1. README 中的示例代码使用了过时的 API
2. 架构图缺少新增的微服务
### 次要 (2)
1. 3 个外部链接失效
2. 术语不统一（用户/客户混用）
python3 scripts/analyze.py --path . --output audit.md
适用：
python3 scripts/generate.py --path . --output ./docs
适用：
python3 scripts/consistency-check.py --path . --output check.md
适用：
python3 scripts/docs-improver.py --path . --mode all --output ./docs --report report.md
适用：
包含 6+ 专业模板：
包含 10+ 图表模板：
Claude/Codex:
"评估我们的文档质量并提出改进建议"
AI 会：
详见 references/best-practices.md：
ZIP package — ready to use