name: user-intent-parser description: 将用户需求解析为具有明确假设、约束和接受标准的结构化格式。在初始需求模糊或非正式时使用。
用户意图解析技能
目的
将非正式的用户请求转换为结构化需求格式。
使用时机
- 用户提供模糊或非正式的请求
- 需求是对话式而非结构化的
- 非技术用户在指定功能
- 需要形式化口头需求
解析过程
步骤1:提取明确语句
识别用户直接陈述的内容:
- 动作(动词):创建、更新、删除、显示、发送等。
- 对象(名词):用户、产品、订单、通知等。
- 条件(何时/如果):触发器、先决条件
- 结果(以便):预期结果
步骤2:识别隐式需求
假定但未陈述的内容:
- 需要身份验证吗?
- 错误处理期望
- 性能期望
- 平台/设备支持
- 数据验证需求
步骤3:标记模糊之处
标记不清晰的项:
- 模糊术语(“快速”、“良好”、“简单”)
- 缺少具体信息(数量、限制)
- 范围不清(边界)
- 未定义参与者(谁做什么)
步骤4:生成结构化格式
输出格式
解析意图文档
保存到:docs/specs/parsed-intent-{session}.md
模板捕获:
- 原始用户语句
- 提取的功能性需求
- 提取的非功能性需求
- 做出的假设(带理由)
- 需要澄清的模糊之处
- 草拟接受标准
置信度级别
为每个提取的需求分配置信度:
| 级别 | 含义 | 行动 |
|---|---|---|
| 高 | 用户直接陈述 | 进行 |
| 中 | 强烈暗示 | 确认 |
| 低 | 推断/假定 | 必须澄清 |
常见模式
功能请求
用户:“我需要用户能够导出他们的数据”
解析:
- 动作:导出
- 对象:用户数据
- 参与者:用户(已认证)
- 隐式:格式未指定,假定权限
- 模糊性:哪些数据?什么格式?
错误报告作为功能
用户:“搜索太慢了”
解析:
- 动作:提高搜索性能
- 隐式:当前性能不可接受
- 模糊性:多慢?目标速度?
模糊请求
用户:“让仪表板更好”
解析:
- 动作:改进仪表板
- 模糊性:哪些方面?视觉?功能?性能?
- 置信度:低(需要大量澄清)
集成点
- 研究结果告知隐式需求
- 生成的模糊性输入问题生成
- 结构化输出成为需求验证的输入
存储位置
保存到:docs/specs/parsed-intent-{session}.md
质量检查清单
完成解析前:
- [ ] 所有明确动作已识别
- [ ] 所有对象/实体已命名
- [ ] 隐式需求已记录
- [ ] 模糊之处已清晰标记
- [ ] 置信度级别已分配
- [ ] 草拟接受标准已创建