negative-requirement

从正向需求出发分析负向场景(错误使用、中途放弃、状态异常),设计程序的检测、恢复与引导策略。触发:"错误处理"、"异常场景"、"边界情况",或需求挖掘后补充负向分析。

SKILL.md

GitHub

负向需求设计

从正向需求出发,系统性分析用户可能的错误使用路径,设计程序在这些情况下的预期行为。

概述

目的:补充需求挖掘中容易被忽视的负向场景,确保程序在用户犯错、状态异常等情况下的健壮性

功能:分析负向场景分类、评估风险等级、设计检测/恢复/引导策略、输出负向需求清单

使用场景:

  • 当 requirement-mining 完成后需要补充负向场景时
  • 当用户提到"错误处理"、"异常场景"、"边界情况"时
  • 当用户说"用户可能犯什么错"、"如果中途放弃怎么办"时

核心原则

  • 从正向推负向:基于已确认的正向需求,推导可能的负向场景,而非凭空想象
  • 用户视角优先:优先分析用户行为相关的负向场景(误操作、放弃),再分析系统状态异常
  • 概率与影响并重:同时考虑发生概率和影响程度,高概率+高影响的场景优先处理
  • 可操作的策略:每个负向场景必须给出具体的程序行为设计,不能只列问题不给方案
  • 不重复正向需求:负向需求是补充,不重复正向需求已覆盖的内容

负向场景分类

类型 描述 典型场景
用户误操作 用户操作错误但非故意 选错选项、填错内容、点错按钮、操作顺序错误
参数输入错误 接口/命令参数层面的错误 函数参数类型错误、API参数格式错误、CLI参数拼写错误、必填参数缺失、参数值超出范围
中途放弃 用户主动中断流程 关闭页面、切换任务、超时离开、放弃当前操作
状态异常 系统或环境状态异常 网络中断、服务超时、并发冲突、数据不一致
权限问题 权限相关异常 越权访问、权限变更、会话过期、token失效
数据异常 数据层面的异常 无效输入、格式错误、数据冲突、重复提交、数据丢失
外部依赖 第三方服务异常 API不可用、响应超时、返回异常、资源不足

分析框架

对每个负向场景,按以下维度分析:

1. 场景识别

  • 触发条件:什么情况下会发生
  • 用户意图:用户原本想做什么
  • 实际行为:用户实际做了什么(或发生了什么)

2. 风险评估

维度 评估标准
发生概率 高(>30%用户可能遇到)/ 中(10-30%)/ 低(<10%)
影响程度 严重(数据丢失/资金损失)/ 中等(体验受损)/ 轻微(可快速恢复)
可检测性 程序能否自动检测到此场景

3. 策略设计

策略类型 说明 适用场景
预防 在用户犯错前阻止 高风险操作、不可逆操作
检测 及时发现异常状态 状态异常、数据异常
恢复 从异常状态恢复 网络中断、服务超时
引导 引导用户回到正确路径 用户误操作、操作遗漏
容错 宽容处理用户输入 格式不规范、大小写不一致

4. 用户体验设计

  • 感知方式:用户如何知道发生了什么(提示、高亮、震动等)
  • 操作路径:用户应该如何处理(重试、修改、跳过等)
  • 情绪安抚:如何减少用户的焦虑感(友好的提示、进度展示等)

执行流程

Step 1:输入确认

确认输入的正向需求清单。输入来源可以是:

  1. requirement-mining 输出的需求清单
  2. 用户直接提供的需求描述
  3. 已有的需求文档

如果用户没有提供正向需求,提示用户先执行 requirement-mining 或提供需求描述。

输入格式:

请提供正向需求清单,格式如下:

| 需求 ID | 需求描述 | 预期效果 |
|---------|----------|----------|
| REQ-01  | ...      | ...      |
| REQ-02  | ...      | ...      |

或直接提供需求描述文本。

Step 2:场景推导

基于正向需求,按场景分类推导可能的负向场景。

推导方法:

  1. 用户误操作:

    • 需求中涉及的表单、选择、点击操作 → 可能选错/填错/点错
    • 多步骤流程 → 可能跳步/乱序
    • 相似选项 → 可能混淆
  2. 参数输入错误:

    • 函数/方法调用 → 参数类型错误、顺序错误、缺失、多余
    • API调用 → 请求参数格式错误、必填参数缺失、参数值超出范围
    • CLI命令 → 参数拼写错误、选项组合错误、缺少必需参数
    • 配置文件 → 配置项格式错误、值类型不匹配、必填项缺失
  3. 中途放弃:

    • 长流程 → 可能中途离开
    • 需要等待的操作 → 可能超时
    • 需要外部配合的操作 → 可能无法继续
  4. 状态异常:

    • 涉及网络请求 → 可能中断
    • 涉及并发操作 → 可能冲突
    • 涉及状态保存 → 可能丢失
  5. 权限问题:

    • 涉及多角色 → 可能越权
    • 长时间操作 → 可能会话过期
    • 涉及敏感操作 → 可能需要二次验证
  6. 数据异常:

    • 用户输入 → 可能无效/格式错误
    • 唯一性约束 → 可能重复提交
    • 关联数据 → 可能冲突
  7. 外部依赖:

    • 第三方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 的流程执行:

  1. 确认落盘:提示用户落盘内容为负向需求报告(negative-requirement.md),确认后继续
  2. 创建文档:使用 req create 命令创建目录并注册到 meta.json
  3. 写入文档:使用 write_to_file 按 frontmatter 模板写入 negative-requirement.md
  4. 验证:使用 req list --id {REQ-NNN} 确认

详细步骤、frontmatter 模板和命令参数见 requirement-doc-store skill。

选项2:合并到需求文档

用户选择合并到需求文档时:

  1. 确认合并目标:提示用户选择要合并的正向需求文档
  2. 读取正向需求文档:使用 read_file 读取目标文档
  3. 合并负向需求:将负向需求清单追加到正向需求文档的"潜在风险与注意事项"部分
  4. 更新关联关系:在文档中添加正向需求与负向场景的关联说明
  5. 验证合并结果:使用 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:负向需求报告落盘归档