common-requirement-clarification - SKILL.md Agent Skill

name: "common-requirement-clarification" description: "需求澄清技能。帮助团队明确和细化业务需求，确保需求的完整性和可测试性。"

需求澄清技能

功能描述

提供需求分析和澄清能力，帮助团队明确业务需求的细节，确保需求的完整性、一致性和可测试性。

何时使用

在以下情况调用此技能：

需求文档模糊或不完整时
需要确认需求的业务背景和目标
需要细化需求的验收标准
需要识别需求的依赖关系和风险

核心功能

需求分解：将模糊需求分解为具体、可测试的用户故事
疑问收集：识别需求中的模糊点和待确认项
验收标准定义：帮助定义清晰的验收标准
依赖分析：识别需求之间的依赖关系
风险评估：评估需求实现的技术风险和业务风险

输入参数

参数	类型	必填	说明
requirementText	String	是	原始需求描述文本
businessContext	String	否	业务背景说明
stakeholders	List<String>	否	相关干系人列表
deadline	String	否	需求截止时间

输出格式

{
  "status": "SUCCESS",
  "originalRequirement": "原始需求文本",
  "clarifiedPoints": [
    {
      "question": "需要澄清的问题",
      "suggestion": "建议的澄清方向",
      "priority": "高/中/低"
    }
  ],
  "userStories": [
    {
      "id": "US-001",
      "title": "用户故事标题",
      "description": "作为角色，我希望功能，以便价值",
      "acceptanceCriteria": ["条件1", "条件2"]
    }
  ],
  "dependencies": ["依赖需求ID", "依赖系统"],
  "risks": [
    {
      "description": "风险描述",
      "level": "高/中/低",
      "mitigation": "缓解措施"
    }
  ]
}

需求澄清流程

原始需求 → 需求分析 → 疑问识别 → 验收标准定义 → 依赖分析 → 风险评估 → 输出澄清结果

详细步骤

需求分析：解析需求文本，提取关键信息
疑问识别：识别模糊、歧义或缺失的信息点
验收标准定义：帮助定义可测试的验收条件
依赖分析：识别与其他需求或系统的依赖关系
风险评估：评估技术和业务风险

需求质量检查清单

检查项	说明	状态
完整性	需求是否包含所有必要信息	✅/❌
清晰性	需求描述是否清晰无歧义	✅/❌
可测试性	是否有明确的验收标准	✅/❌
可行性	技术上是否可行	✅/❌
优先级	是否明确需求优先级	✅/❌

实践指南

用户故事模板

作为 <角色>，
我希望 <功能/行为>，
以便 <价值/收益>。

验收标准：
- 场景1：...
- 场景2：...

需求澄清提问清单

目标与价值：这个需求要解决什么问题？带来什么价值？
用户角色：谁会使用这个功能？用户场景是什么？
功能边界：这个功能包含什么？不包含什么？
业务规则：有哪些业务规则需要遵守？
异常处理：异常情况如何处理？
数据需求：需要哪些数据？数据来源在哪里？
性能要求：有没有性能指标要求？
安全合规：有没有安全或合规要求？

核心组件

组件	职责	描述
RequirementAnalyzer	需求分析器	解析和分析需求文本
QuestionExtractor	问题提取器	识别需求中的模糊点
StoryGenerator	用户故事生成器	生成结构化的用户故事
RiskAssessor	风险评估器	评估需求实现风险

配置要求

无需额外配置，基于规则引擎进行需求分析。

扩展指南

添加自定义检查规则

在规则引擎中添加新的检查规则
定义规则的触发条件和处理逻辑
更新需求质量检查清单

集成外部工具

可集成需求管理工具（如 Jira、Azure DevOps）实现需求的自动化同步。