# requirement-analysis

**Repository Path**: vicoproplus/requirement-analysis

## Basic Information

- **Project Name**: requirement-analysis
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 需求分析技能 (Requirement Analysis Skill)

> **版本**: v1.0.0 | **许可**: MIT

## 简介

多格式需求文档分析与整合技能。自动解析 Markdown、Excel、Word、思维导图文件，智能去重和补充需求信息，生成标准化的 PRD 文档。

支持三种工作模式：**标准模式**（完整流程含澄清交互）、**快速模式**（跳过逐条提问，自动填默认值）、**增量模式**（检测已有 PRD.md 并输出变更）。

## 快速开始

### 安装

```bash
# 复制到技能目录
cp -r requirement-analysis-1.0.0 ~/.claude/skills/

# 安装可选依赖（增强文档解析能力）
cd ~/.claude/skills/requirement-analysis-1.0.0
pip install python-docx openpyxl    # 增强 Word/Excel 解析
# 或 npm install                    # 备选依赖
```

### 使用

打开你的项目，说：
- "进行需求分析"
- "分析需求"
- "整理需求文档"

### 工作模式说明

| 模式 | 触发条件 | 特点 |
|------|----------|------|
| 标准模式 | 无 PRD.md + 默认选择 | 逐条澄清、完整交互 |
| 快速模式 | 无 PRD.md + 用户选择 | 自动填默认值、批量确认 |
| 增量模式 | 检测到已有 PRD.md | 输出变更差异、版本递增 |

## 支持的文档格式

| 格式 | 扩展名 | 优先级 | 解析方式 |
|------|--------|--------|----------|
| Markdown | `.md`, `.markdown` | 1 | AI 读取，标题/表格/列表解析 |
| Word | `.docx` | 2 | 系统命令 (`python-docx`) |
| Excel | `.xlsx`, `.xls` | 3 | 系统命令 (`openpyxl` / `in2csv`) |
| 思维导图 | `.xmind`, `.mm`, `.mmap` | 4 | XML 解析 + 节点层级映射 |

## 工作流程

```
文档扫描 → 文档解析 → 功能提取 → 智能整合(含质量评估) → 需求澄清 → 用户确认 → 生成 PRD
```

## 核心特性

- **语义去重**: AI 语义理解识别重复功能，合并冗余信息
- **冲突检测**: 标注文档间不一致，不自动解决
- **需求质量评估 (INVEST)**: 从独立性、价值、可测试性等 6 维评分
- **来源追溯**: 每项功能标注来源文档
- **增量更新**: 检测已有 PRD.md 自动进入增量模式
- **快速模式**: 跳过逐条提问，自动填充合理默认值

## 输出结构

生成的 `PRD.md` 包含：
- 需求概述（背景、目标用户）
- 功能模块（功能列表 + 字段定义 + 来源）
- 页面结构（页面清单 + 关系图）
- 数据字段（实体/字段表格）
- 附录（变更历史 + 待确认事项 + 质量评估报告）

## 常见问题

**Q: .doc 文件无法解析？**
A: 仅支持 `.docx`。请先转换格式。

**Q: 缺少 Word/Excel 解析依赖？**
A: 运行 `pip install python-docx openpyxl` 或继续（AI 会尝试直接读取）。

**Q: 相似度阈值可以调整吗？**
A: 采用 AI 语义判断而非固定阈值，没有硬编码的百分比限制。

**Q: 冲突会自动解决吗？**
A: 不会。所有冲突需用户确认，确保需求准确性。

**Q: 已经生成过 PRD 了，再运行会怎样？**
A: 自动进入增量模式，对比差异输出变更。

## 目录结构

```
requirement-analysis/
├── _meta.json       # 技能元数据
├── SKILL.md         # 核心执行指令
├── README.md        # 本文件
├── package.json     # npm 依赖（备选）
└── package.sh       # 打包脚本
```
# requirement-analysis