需求分析技能 (Requirement Analysis Skill)

版本: v1.2.2 | 许可: MIT

简介

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

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

快速开始

安装

# 通过 skills.sh 一键安装（推荐，支持 Claude Code / Codex / Cursor / Gemini CLI 等 20+ agent）
npx skills add WikkyGao/requirement-analysis

# 或手动复制到技能目录
cp -r requirement-analysis ~/.claude/skills/

# 安装可选依赖（增强文档解析能力）
cd ~/.claude/skills/requirement-analysis
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       # 打包脚本