关于 requirements-analysis-plus
requirements-analysis-plus 是用于跨文档分析需求的 skill,侧重按风险排序、检查冲突并提出后续问题。它指导 Agent 产出可执行草案,并标明假设与信息缺口。
主要功能
- 01跨文档需求分析
- 02按风险和业务影响排序
- 03检查冲突与不一致
- 04标明假设和信息缺口
- 05可选角色报告输入
适用场景
- 01分析多个来源文档中的需求
- 02确定高影响需求与风险的优先级
- 03信息不完整时起草需求
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill requirements-analysis-plus安装后在 Claude Code 中输入/requirements-analysis-plus确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamledge-incomplete-input.yamledge-risk-priority.yamledge-role-artifact-input.yamlreview-repair-regression.yamlevals/graders/review-repair-regression.pyexamples/requirements-sample.analysis.mdrequirements-sample.jsonrequirements-sample.mdoutput-templates/template-markdown.mdprompts/requirements-analysis-plus.mdreferences/script-contract.mdreferences/local/requirements-analysis_EN.mdscripts/common_parser.pyevidence_scaffold.pyparse_excel.pyparse_html.pyparse_json.pyparse_markdown.pyparse_word.pyrun_analysis.pyxlsx_reader.py详细介绍
requirements-analysis-plus(EN)
中文版: 请参阅对应的中文技能。
适用场景
- 需要跨多个源文档进行更深入的需求分析。
- 相比基础版本,需要更强的优先级排序、冲突检查和后续问题梳理。
脚本能力边界
可选的 scripts/run_*.py 会整理解析后的证据或来源候选项,并标记为 NOT_ASSESSED。它们不会调用模型、执行主提示词,也不会产出语义结论、风险优先级、完整案例或审批结果。主提示词由 Agent 执行。运行辅助脚本前,请阅读 references/script-contract.md。
工作流
- 阅读并遵循“渐进式披露”中列出的主提示词(覆盖范围、结构、质量标准)。
- 直接提供需求材料即可独立使用。如果用户提供了声明
source_role的角色报告,则将其视为可选的组合输入,绝不要求安装角色技能。 - 仅补充会改变分析结果的项目背景:范围、环境、约束、风险、依赖项和预期交付物。
- 如果输入不完整,则提供可用的初稿,并明确标注假设和信息缺口。
- 默认使用 Markdown;仅在用户要求时切换格式。
核心约束
- 根据风险/业务影响确定优先级,不要一视同仁。
- 将已确认的事实与当前假设分开。
- 不要编造用户未提供的端点、字段、环境或根因。
- 使用角色报告中的事实、观点、风险或问题时,逐项保留其来源角色归属;绝不要将角色观点当作主要需求事实或匿名共识。
- 仅使用用户提供的报告内容;不要读取、链接到或依赖其他角色技能的内部文件。
- 保证输出可执行:场景具体、优先级明确、后续步骤清晰。
渐进式披露
- 生成输出前,阅读并遵循
prompts/requirements-analysis-plus.md(最低覆盖要求、输出结构、质量标准)。 - 如果有合适的现成模板:使用
output-templates/下对应的文件。 - 如果用户需要示例或与现有资产保持一致:阅读相关的
examples/。 - 对于深入的框架、故障排查或架构说明:仅阅读
references/下相关文件,不要加载整个目录。 - 对于格式转换或辅助检查:优先使用现有的
scripts/,不要重复造轮子。 - 对此技能进行评估或回归测试:结合 skill-up 使用
evals/。
交付前检查清单
- 已遵循主提示词的输出结构
- 最低覆盖重点:来源对齐、范围摘要、冲突与不一致、缺失规则、可测试性风险、依赖影响、业务影响、按风险排序优先级……(详情见主提示词)
- 已覆盖最低检查清单,或说明了未覆盖项
- 高风险项已明确标注优先级
- 未编造用户未提供的细节
- 已标注假设和信息缺口
- 使用角色报告的发现、风险和待解决问题均保留了其来源角色
- 可选的角色报告未变成前置条件,也未链接到任何角色技能的内部文件
常见误区
- 范围/背景不完整时,不要假装内容完整。
- 不要将所有事项视为同等重要。
- 不要忽略假设和信息缺口。
- 不要堆砌与当前工具链无关的通用理论。
评论
支持 Markdown