negative-requirement
从正向需求出发分析负向场景(错误使用、中途放弃、状态异常),设计程序的检测、恢复与引导策略。触发:"错误处理"、"异常场景"、"边界情况",或需求挖掘后补充负向分析。
SKILL.mdskills/negative-requirement/SKILL.md
GitHub负向需求设计
从正向需求出发,系统性分析用户可能的错误使用路径,设计程序在这些情况下的预期行为。
概述
目的:补充需求挖掘中容易被忽视的负向场景,确保程序在用户犯错、状态异常等情况下的健壮性
功能:分析负向场景分类、评估风险等级、设计检测/恢复/引导策略、输出负向需求清单
使用场景:
- 当
requirement-mining完成后需要补充负向场景时 - 当用户提到"错误处理"、"异常场景"、"边界情况"时
- 当用户说"用户可能犯什么错"、"如果中途放弃怎么办"时
核心原则
- 从正向推负向:基于已确认的正向需求,推导可能的负向场景,而非凭空想象
- 用户视角优先:优先分析用户行为相关的负向场景(误操作、放弃),再分析系统状态异常
- 概率与影响并重:同时考虑发生概率和影响程度,高概率+高影响的场景优先处理
- 可操作的策略:每个负向场景必须给出具体的程序行为设计,不能只列问题不给方案
- 不重复正向需求:负向需求是补充,不重复正向需求已覆盖的内容
负向场景分类
| 类型 | 描述 | 典型场景 |
|---|---|---|
| 用户误操作 | 用户操作错误但非故意 | 选错选项、填错内容、点错按钮、操作顺序错误 |
| 参数输入错误 | 接口/命令参数层面的错误 | 函数参数类型错误、API参数格式错误、CLI参数拼写错误、必填参数缺失、参数值超出范围 |
| 中途放弃 | 用户主动中断流程 | 关闭页面、切换任务、超时离开、放弃当前操作 |
| 状态异常 | 系统或环境状态异常 | 网络中断、服务超时、并发冲突、数据不一致 |
| 权限问题 | 权限相关异常 | 越权访问、权限变更、会话过期、token失效 |
| 数据异常 | 数据层面的异常 | 无效输入、格式错误、数据冲突、重复提交、数据丢失 |
| 外部依赖 | 第三方服务异常 | API不可用、响应超时、返回异常、资源不足 |
分析框架
对每个负向场景,按以下维度分析:
1. 场景识别
- 触发条件:什么情况下会发生
- 用户意图:用户原本想做什么
- 实际行为:用户实际做了什么(或发生了什么)
2. 风险评估
| 维度 | 评估标准 |
|---|---|
| 发生概率 | 高(>30%用户可能遇到)/ 中(10-30%)/ 低(<10%) |
| 影响程度 | 严重(数据丢失/资金损失)/ 中等(体验受损)/ 轻微(可快速恢复) |
| 可检测性 | 程序能否自动检测到此场景 |
3. 策略设计
| 策略类型 | 说明 | 适用场景 |
|---|---|---|
| 预防 | 在用户犯错前阻止 | 高风险操作、不可逆操作 |
| 检测 | 及时发现异常状态 | 状态异常、数据异常 |
| 恢复 | 从异常状态恢复 | 网络中断、服务超时 |
| 引导 | 引导用户回到正确路径 | 用户误操作、操作遗漏 |
| 容错 | 宽容处理用户输入 | 格式不规范、大小写不一致 |
4. 用户体验设计
- 感知方式:用户如何知道发生了什么(提示、高亮、震动等)
- 操作路径:用户应该如何处理(重试、修改、跳过等)
- 情绪安抚:如何减少用户的焦虑感(友好的提示、进度展示等)
执行流程
Step 1:输入确认
确认输入的正向需求清单。输入来源可以是:
requirement-mining输出的需求清单- 用户直接提供的需求描述
- 已有的需求文档
如果用户没有提供正向需求,提示用户先执行 requirement-mining 或提供需求描述。
输入格式:
请提供正向需求清单,格式如下:
| 需求 ID | 需求描述 | 预期效果 |
|---------|----------|----------|
| REQ-01 | ... | ... |
| REQ-02 | ... | ... |
或直接提供需求描述文本。
Step 2:场景推导
基于正向需求,按场景分类推导可能的负向场景。
推导方法:
用户误操作:
- 需求中涉及的表单、选择、点击操作 → 可能选错/填错/点错
- 多步骤流程 → 可能跳步/乱序
- 相似选项 → 可能混淆
参数输入错误:
- 函数/方法调用 → 参数类型错误、顺序错误、缺失、多余
- API调用 → 请求参数格式错误、必填参数缺失、参数值超出范围
- CLI命令 → 参数拼写错误、选项组合错误、缺少必需参数
- 配置文件 → 配置项格式错误、值类型不匹配、必填项缺失
中途放弃:
- 长流程 → 可能中途离开
- 需要等待的操作 → 可能超时
- 需要外部配合的操作 → 可能无法继续
状态异常:
- 涉及网络请求 → 可能中断
- 涉及并发操作 → 可能冲突
- 涉及状态保存 → 可能丢失
权限问题:
- 涉及多角色 → 可能越权
- 长时间操作 → 可能会话过期
- 涉及敏感操作 → 可能需要二次验证
数据异常:
- 用户输入 → 可能无效/格式错误
- 唯一性约束 → 可能重复提交
- 关联数据 → 可能冲突
外部依赖:
- 第三方API → 可能不可用/超时
- 文件/资源 → 可能不存在/无权限
Step 3:风险评估
对每个场景评估风险等级:
| 风险等级 | 条件 | 处理优先级 |
|---|---|---|
| P0 | 高概率 + 高影响 | 必须处理 |
| P1 | 高概率 + 中影响 或 中概率 + 高影响 | 应该处理 |
| P2 | 中概率 + 中影响 或 低概率 + 高影响 | 建议处理 |
| P3 | 低概率 + 低影响 | 可选处理 |
Step 4:策略设计
对每个场景设计具体的程序行为:
### NEG-XX:[场景名称]
**场景描述**:[什么情况下会发生]
**触发条件**:[具体的触发条件]
**风险等级**:[P0/P1/P2/P3]
**程序行为**:
#### 预防策略(如有)
- [如何在用户犯错前阻止]
#### 检测策略
- [如何检测到此场景]
- [检测时机:实时/延迟/轮询]
#### 恢复/引导策略
- [检测到后程序应该做什么]
- [用户应该看到什么]
- [用户应该如何操作]
#### 用户体验设计
- **提示方式**:[弹窗/Toast/内联提示/状态栏]
- **提示内容**:[具体的提示文案]
- **操作选项**:[重试/修改/跳过/取消]
- **情绪安抚**:[友好的语气、进度展示等]
Step 5:输出负向需求清单
输出结构化的负向需求清单:
## 负向需求清单
### 风险概览
| 风险等级 | 场景数量 | 说明 |
|----------|----------|------|
| P0 | N 个 | 必须处理 |
| P1 | N 个 | 应该处理 |
| P2 | N 个 | 建议处理 |
| P3 | N 个 | 可选处理 |
### 负向场景清单
| 场景 ID | 类型 | 场景描述 | 风险等级 | 程序行为概述 |
|---------|------|----------|----------|--------------|
| NEG-01 | 用户误操作 | ... | P0 | 二次确认弹窗 |
| NEG-02 | 中途放弃 | ... | P1 | 自动保存草稿 |
| NEG-03 | 状态异常 | ... | P0 | 自动重试+手动查询 |
### 详细场景分析
#### NEG-01:[场景名称]
**场景描述**:...
**风险评估**:
- 发生概率:[高/中/低]
- 影响程度:[严重/中等/轻微]
- 风险等级:[P0/P1/P2/P3]
**程序行为设计**:
[按Step 4格式输出]
---
#### NEG-02:[场景名称]
[同上格式]
---
### 与正向需求的关联
| 负向场景 | 关联的正向需求 | 关联说明 |
|----------|----------------|----------|
| NEG-01 | REQ-01 | 用户在执行REQ-01时可能误操作 |
| NEG-02 | REQ-02 | 用户在执行REQ-02时可能中途放弃 |
### 设计建议
1. **优先级建议**:建议优先实现P0场景的处理
2. **交互建议**:[基于场景特点的交互设计建议]
3. **测试建议**:[需要重点测试的场景]
Step 6:用户确认
请用户确认负向需求清单:
以上是基于正向需求推导的负向场景,请确认:
1. **场景完整性**:是否遗漏了重要的负向场景?
2. **风险评估**:风险等级划分是否合理?
3. **策略可行性**:程序行为设计是否可行?
4. **优先级**:处理优先级是否符合预期?
请确认或提出修改意见。
根据用户反馈迭代修改,最多迭代2次。
报告模板
# 负向需求设计报告
## 1. 输入需求
### 1.1 正向需求清单
[粘贴输入的正向需求清单]
## 2. 风险概览
| 风险等级 | 场景数量 | 说明 |
|----------|----------|------|
| P0 | N 个 | 必须处理 |
| P1 | N 个 | 应该处理 |
| P2 | N 个 | 建议处理 |
| P3 | N 个 | 可选处理 |
## 3. 负向场景清单
| 场景 ID | 类型 | 场景描述 | 风险等级 | 程序行为概述 |
|---------|------|----------|----------|--------------|
| NEG-01 | ... | ... | ... | ... |
## 4. 详细场景分析
### 4.1 NEG-XX:[场景名称]
**场景描述**:...
**风险评估**:
- 发生概率:...
- 影响程度:...
- 风险等级:...
**程序行为设计**:
- 预防策略:...
- 检测策略:...
- 恢复/引导策略:...
- 用户体验设计:...
---
[重复每个场景]
## 5. 与正向需求的关联
| 负向场景 | 关联的正向需求 | 关联说明 |
|----------|----------------|----------|
| ... | ... | ... |
## 6. 设计建议
1. **优先级建议**:...
2. **交互建议**:...
3. **测试建议**:...
后续步骤建议
负向需求清单输出完成后,提示用户选择后续行动:
🚀 后续行动选择
━━━━━━━━━━━━━━━━
负向需求设计已完成,报告已输出。请选择后续行动:
1. 📁 落盘归档
将负向需求报告保存到 .requirements/ 目录,便于后续引用和管理
2. 📋 合并到需求文档
将负向需求清单合并到正向需求文档中,形成完整的需求规格
3. 🎨 进入交互设计
使用 interaction-design 技能基于负向需求设计具体的错误处理交互流程
4. 🧪 进入测试计划
使用 test-planner 技能基于负向需求设计测试用例
5. 📐 进入技术设计
使用 design-craft 技能基于负向需求设计技术实现方案
6. ⏭️ 跳过
不进行后续操作,结束负向需求设计流程
请选择 [1/2/3/4/5/6]:
选项1:落盘归档
用户选择落盘归档时,引导用户确认落盘内容,然后按 requirement-doc-store skill 的流程执行:
- 确认落盘:提示用户落盘内容为负向需求报告(
negative-requirement.md),确认后继续 - 创建文档:使用
req create命令创建目录并注册到 meta.json - 写入文档:使用
write_to_file按 frontmatter 模板写入negative-requirement.md - 验证:使用
req list --id {REQ-NNN}确认
详细步骤、frontmatter 模板和命令参数见
requirement-doc-storeskill。
选项2:合并到需求文档
用户选择合并到需求文档时:
- 确认合并目标:提示用户选择要合并的正向需求文档
- 读取正向需求文档:使用
read_file读取目标文档 - 合并负向需求:将负向需求清单追加到正向需求文档的"潜在风险与注意事项"部分
- 更新关联关系:在文档中添加正向需求与负向场景的关联说明
- 验证合并结果:使用
read_lints检查文档格式
选项3:进入交互设计
用户选择进入交互设计时,调用 interaction-design 技能:
输入准备:
将负向需求报告作为输入传递给 interaction-design 技能:
📋 传递给 interaction-design 的输入
━━━━━━━━━━━━━━━━
来源:negative-requirement 输出的负向需求报告
负向场景清单:
| 场景 ID | 类型 | 场景描述 | 风险等级 | 程序行为概述 |
|---------|------|----------|----------|--------------|
| NEG-01 | ... | ... | ... | ... |
正在调用 interaction-design 技能进行交互设计...
技能调用:
使用 use_skill 工具调用 interaction-design 技能,传入负向需求报告内容。
输出衔接:
interaction-design 技能输出交互设计文档后,提示用户:
✅ 交互设计完成
━━━━━━━━━━━━━━━━
交互设计文档已生成,共 N 个交互场景。
下一步建议:
- 可以进入 design-craft 进行技术设计
- 可以将交互设计文档落盘归档
是否需要将交互设计文档保存到文件?[是/否]
选项4:进入测试计划
用户选择进入测试计划时,调用 test-planner 技能:
输入准备:
将负向需求报告作为输入传递给 test-planner 技能:
📋 传递给 test-planner 的输入
━━━━━━━━━━━━━━━━
来源:negative-requirement 输出的负向需求报告
负向场景清单:
| 场景 ID | 类型 | 场景描述 | 风险等级 | 程序行为概述 |
|---------|------|----------|----------|--------------|
| NEG-01 | ... | ... | ... | ... |
正在调用 test-planner 技能进行测试计划设计...
技能调用:
使用 use_skill 工具调用 test-planner 技能,传入负向需求报告内容。
输出衔接:
test-planner 技能输出测试计划后,提示用户:
✅ 测试计划完成
━━━━━━━━━━━━━━━━
测试计划已生成,共 N 个测试用例。
下一步建议:
- 可以将测试计划落盘归档
- 可以开始编写测试代码
是否需要将测试计划保存到文件?[是/否]
选项5:进入技术设计
用户选择进入技术设计时,调用 design-craft 技能:
输入准备:
将负向需求报告作为输入传递给 design-craft 技能:
📋 传递给 design-craft 的输入
━━━━━━━━━━━━━━━━
来源:negative-requirement 输出的负向需求报告
负向场景清单:
| 场景 ID | 类型 | 场景描述 | 风险等级 | 程序行为概述 |
|---------|------|----------|----------|--------------|
| NEG-01 | ... | ... | ... | ... |
正在调用 design-craft 技能进行技术设计...
技能调用:
使用 use_skill 工具调用 design-craft 技能,传入负向需求报告内容。
输出衔接:
design-craft 技能输出技术设计文档后,提示用户:
✅ 技术设计完成
━━━━━━━━━━━━━━━━
技术设计文档已生成。
下一步建议:
- 可以将技术设计文档落盘归档
- 可以开始编码实现
- 可以进行设计评审
是否需要将技术设计文档保存到文件?[是/否]
选项6:跳过
用户选择跳过时,直接结束负向需求设计流程:
✅ 负向需求设计流程结束
━━━━━━━━━━━━━━━━
负向需求报告已输出,后续行动已跳过。
如需后续操作,可随时:
- 执行落盘归档:保存报告到 .requirements/ 目录
- 合并到需求文档:将负向需求合并到正向需求文档
- 进入交互设计:调用 interaction-design 技能
- 进入测试计划:调用 test-planner 技能
- 进入技术设计:调用 design-craft 技能
行为边界
- 基于正向需求推导:负向场景必须基于正向需求推导,不凭空想象不相关的场景
- 不重复正向需求:负向需求是补充,不重复正向需求已覆盖的内容
- 可操作的策略:每个场景必须给出具体的程序行为设计,不能只列问题不给方案
- 用户确认:输出后必须请用户确认,根据反馈迭代修改
- 不涉及技术实现:只描述程序应该做什么,不涉及具体的技术实现细节
- 概率与影响并重:风险评估必须同时考虑概率和影响,不能只看单一维度
与其他skill的关系
- 输入来源:
requirement-mining输出的需求清单 - 下游应用:
interaction-design:基于负向需求设计具体交互流程test-planner:基于负向需求设计测试用例design-craft:基于负向需求设计技术方案requirement-doc-store:负向需求报告落盘归档