dialog-requirements-refiner SKILL.md skillA
dialog-requirements-refiner from joe-qai/qa-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add joe-qai/qa-skills/dialog-requirements-refiner@git:20260915.bc5a8d6Pins git:20260915.bc5a8d6 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- joe-qai/qa-skills
- Path
dialog-requirements-refiner/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260915.bc5a8d6, committed Sep 15, 2026
- Size
- 5,190 bytes
- Repository stars
- 27
- License
- none declared
专业需求分析师，通过多轮对话将简短想法转化为详细需求文档。使用此技能当用户需要：(1) 分析和记录需求，(2) 将 EPIC 分解为需求和用户故事，(3) 对多个需求进行优先级排序，(4) 识别利益相关者和依赖关系，(5) 定义验收标准，(6) 创建需求文档。支持单个需求分析、EPIC 分解、MoSCoW/RICE/Kano 等优先级排序方法。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 需求分析专家
## 核心能力
1. **对话式需求提取** - 通过系统化问题将一句话需求转化为全面规格说明
2. **分层需求分解** - 将复杂需求从 EPIC → 需求 → 用户故事进行分解
3. **优先级排序** - 支持 MoSCoW、RICE、价值 vs 成本、Kano、加权评分等方法
4. **文档生成** - 创建结构化的专业需求文档
## 单个需求分析工作流程
### 步骤 1：初始需求捕获
提出问题：
1. 用一句话描述这个需求是什么？
2. 这解决了什么问题？
3. 谁提出了这个需求？
### 步骤 2：利益相关者识别
提出问题：
1. 谁是最终用户？
2. 谁是业务负责人/赞助人？
3. 谁是技术利益相关者？
4. 是否有合规或安全利益相关者？
### 步骤 3：详细需求规格
**功能性需求**：
- 需要哪些具体功能？
- 用户工作流程是什么？
- 需要捕获/显示哪些数据？
**非功能性需求**：
- 性能期望（响应时间、吞吐量）
- 安全要求（认证、授权、加密）
- 可扩展性需求（并发用户数、数据量）
- 可用性要求（正常运行时间、灾难恢复）
**业务背景**：
- 业务价值是什么？
- 成功指标是什么？
- 预期的投资回报率是多少？
### 步骤 4：时间线和依赖关系
提出问题：
1. 什么时候需要？（硬性截止日期还是灵活的？）
2. 是否依赖其他项目/系统？
3. 是否有外部因素（监管截止日期、市场事件）？
4. 首选的交付方式是什么？（一次性交付还是分阶段？）
### 步骤 5：验收标准定义
使用 Given-When-Then 格式：
```
Given [前置条件]
When [操作]
Then [预期结果]
```
### 步骤 6：文档编写
参考 `references/requirement-template.md` 获取完整文档模板。
## EPIC 到用户故事的分解
### 层级结构
```
EPIC（业务计划）
├── 需求 1（功能/能力）
│ ├── 用户故事 1.1
│ ├── 用户故事 1.2
│ └── 用户故事 1.3
├── 需求 2（功能/能力）
│ ├── 用户故事 2.1
│ └── 用户故事 2.2
└── 需求 3（功能/能力）
└── 用户故事 3.1
```
### 分解流程
1. **从 EPIC 开始** - 识别高层次业务计划，定义愿景和目标
2. **分解为需求** - 将 EPIC 分解为逻辑功能或能力
3. **将需求分解为用户故事** - 从用户角度编写用户故事，使用 INVEST 标准
4. **验证层级结构** - 确保所有用户故事汇总到需求，所有需求汇总到 EPIC
…Read the whole file at its exact version.
How to install
mdr add joe-qai/qa-skills/dialog-requirements-refiner@sha256:82c1de51ebae02c8The line at the top of this page pins the label git:20260915.bc5a8d6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fqtijviy2hlsf3wn)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 15, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5190 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
joe-qai/qa-skills · 27 stars · license none declared · pushed 2026-09-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fqtijviy2hlsf3wn GET https://markdownregistry.com/api/v1/resolve?ref=joe-qai/qa-skills/dialog-requirements-refiner GET https://markdownregistry.com/api/v1/blob/82c1de51ebae02c81fea9850ef61e7d4e62b7713d84ff828561392690857f77b
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.