Requirements Analysis Plus

Use this skill when you need to parse Word/HTML/JSON/Markdown/Excel requirements and produce a structured analysis; triggers include 需求分析增强、requirements analysis plus and requirement parsing.

naodeng Updated

File contents

需求分析增强版(中文版)

英文版: 见对应英文技能。

何时使用

  • 需要基于多份材料做更深入的需求分析。
  • 需要比基础版更强的冲突检查、优先级和追问。

执行流程

  1. 阅读并遵循「按需加载」中的主提示词(覆盖清单、输出结构、质量要求)。
  2. 直接需求材料始终可以独立使用;用户提供带 source_role(来源角色)的角色报告时,将其作为可选组合输入,不得要求额外安装角色 Skill。
  3. 只补充真正影响结果的项目上下文:范围、环境、限制、风险、依赖、期望产出。
  4. 信息不全时先给可用初版,并显式标出假设与信息缺口。
  5. 默认 Markdown;用户指定其他格式时再切换。

核心约束

  • 按风险/业务影响排优先级,不要平均摊铺。
  • 把「已确认事实」和「当前假设」分开写。
  • 不要编造用户未提供的接口、字段、环境或根因细节。
  • 使用角色报告的事实、观点、风险或问题时,逐项保留来源角色;不要把角色观点冒充原始需求事实或无来源共识。
  • 只消费用户提供的报告内容,不读取、链接或依赖其他角色 Skill 的内部文件。
  • 结果必须可执行:场景具体、有优先级、能指导下一步。

按需加载

  • 产出前必须阅读并遵循 prompts/requirements-analysis-plus.md(最低覆盖清单、输出结构、质量要求)。
  • 需要套用现成模板时:读 output-templates/ 中匹配的模板,不要自创冲突结构。
  • 用户要示例或对标现有资产时:读 examples/ 中相关样例。
  • 需要框架规范、排障、报告 schema 等深资料时:只读 references/ 里与当前问题相关的文件,不要整目录通读。
  • 需要格式转换或辅助校验时:优先使用 scripts/ 中已有脚本,而不是重写一遍。
  • 需要评测/回归本 skill 时:使用 evals/,并用 skill-up 校验与运行。

交付前自检

  • 已遵循主提示词的输出结构
  • 最低覆盖关注:来源一致性、范围总结、冲突和不一致、缺失规则、可测性风险、依赖影响、业务影响、风险优先级…(细节以主提示词为准)
  • 已覆盖最低清单,或标明为何省略
  • 高风险项有明确优先级
  • 未编造用户未提供的细节
  • 假设与信息缺口已标明
  • 使用角色报告时,相关事实、风险和开放问题均保留来源角色
  • 未把可选角色报告变成独立分析的必需输入,也未链接角色 Skill 内部文件

常见误区

  • 范围和上下文都不清楚时,不要假装已经完整可用。
  • 不要把所有项写成同等重要。
  • 不要跳过假设与信息缺口。
  • 不要输出大段与当前工具链无关的空泛理论。

naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/requirements-analysis-plus commit 36ec5e0c5e

Frequently asked questions

npx skillmds@latest add naodeng/requirements-analysis-plus-3