mcpField
R
requirements-analysis-plus

requirements-analysis-plus

github.com/naodeng开发285106 次安装今天更新
代码仓库

关于 requirements-analysis-plus

requirements-analysis-plus 是用于跨文档分析需求的 skill,侧重按风险排序、检查冲突并提出后续问题。它指导 Agent 产出可执行草案,并标明假设与信息缺口。

主要功能

  1. 01跨文档需求分析
  2. 02按风险和业务影响排序
  3. 03检查冲突与不一致
  4. 04标明假设和信息缺口
  5. 05可选角色报告输入

适用场景

  1. 01分析多个来源文档中的需求
  2. 02确定高影响需求与风险的优先级
  3. 03信息不完整时起草需求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill requirements-analysis-plus

安装后在 Claude Code 中输入/requirements-analysis-plus确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-success.yaml
edge-incomplete-input.yaml
edge-risk-priority.yaml
edge-role-artifact-input.yaml
review-repair-regression.yaml
evals/graders/
review-repair-regression.py
examples/
requirements-sample.analysis.md
requirements-sample.json
requirements-sample.md
output-templates/
template-markdown.md
prompts/
requirements-analysis-plus.md
references/
script-contract.md
references/local/
requirements-analysis_EN.md
scripts/
common_parser.py
evidence_scaffold.py
parse_excel.py
parse_html.py
parse_json.py
parse_markdown.py
parse_word.py
run_analysis.py
xlsx_reader.py

详细介绍

requirements-analysis-plus(EN)

中文版: 请参阅对应的中文技能。

适用场景

  • 需要跨多个源文档进行更深入的需求分析。
  • 相比基础版本,需要更强的优先级排序、冲突检查和后续问题梳理。

脚本能力边界

可选的 scripts/run_*.py 会整理解析后的证据或来源候选项,并标记为 NOT_ASSESSED。它们不会调用模型、执行主提示词,也不会产出语义结论、风险优先级、完整案例或审批结果。主提示词由 Agent 执行。运行辅助脚本前,请阅读 references/script-contract.md。

工作流

  1. 阅读并遵循“渐进式披露”中列出的主提示词(覆盖范围、结构、质量标准)。
  2. 直接提供需求材料即可独立使用。如果用户提供了声明 source_role 的角色报告,则将其视为可选的组合输入,绝不要求安装角色技能。
  3. 仅补充会改变分析结果的项目背景:范围、环境、约束、风险、依赖项和预期交付物。
  4. 如果输入不完整,则提供可用的初稿,并明确标注假设和信息缺口。
  5. 默认使用 Markdown;仅在用户要求时切换格式。

核心约束

  • 根据风险/业务影响确定优先级,不要一视同仁。
  • 将已确认的事实与当前假设分开。
  • 不要编造用户未提供的端点、字段、环境或根因。
  • 使用角色报告中的事实、观点、风险或问题时,逐项保留其来源角色归属;绝不要将角色观点当作主要需求事实或匿名共识。
  • 仅使用用户提供的报告内容;不要读取、链接到或依赖其他角色技能的内部文件。
  • 保证输出可执行:场景具体、优先级明确、后续步骤清晰。

渐进式披露

  • 生成输出前,阅读并遵循 prompts/requirements-analysis-plus.md(最低覆盖要求、输出结构、质量标准)。
  • 如果有合适的现成模板:使用 output-templates/ 下对应的文件。
  • 如果用户需要示例或与现有资产保持一致:阅读相关的 examples/。
  • 对于深入的框架、故障排查或架构说明:仅阅读 references/ 下相关文件,不要加载整个目录。
  • 对于格式转换或辅助检查:优先使用现有的 scripts/,不要重复造轮子。
  • 对此技能进行评估或回归测试:结合 skill-up 使用 evals/。

交付前检查清单

  • 已遵循主提示词的输出结构
  • 最低覆盖重点:来源对齐、范围摘要、冲突与不一致、缺失规则、可测试性风险、依赖影响、业务影响、按风险排序优先级……(详情见主提示词)
  • 已覆盖最低检查清单,或说明了未覆盖项
  • 高风险项已明确标注优先级
  • 未编造用户未提供的细节
  • 已标注假设和信息缺口
  • 使用角色报告的发现、风险和待解决问题均保留了其来源角色
  • 可选的角色报告未变成前置条件,也未链接到任何角色技能的内部文件

常见误区

  • 范围/背景不完整时,不要假装内容完整。
  • 不要将所有事项视为同等重要。
  • 不要忽略假设和信息缺口。
  • 不要堆砌与当前工具链无关的通用理论。

评论

支持 Markdown