SuperAPI AI 工具集

requirements-definition

写作与研究

查看项目

更新于 10-30 13:06

技能介绍

requirements-definition 是一个面向需求定义与规格编写的技能,来源于 takeokunn/nixos-configuration。它的目标是在进入实现之前,把模糊或零散的需求整理成清晰、可验证、可追溯的规格说明。

用途:当用户提出“定义需求”“创建规格”“澄清需求”“撰写需求文档”等任务时使用。技能的重点不是直接写代码,而是先把要达成的目标、约束和验收标准说清楚。

主要能力:

  • 在定义需求前先调查现有系统状态,尽量让需求建立在证据而非假设之上。
  • 使用四标准评分体系对澄清问题进行打分,优先处理高分问题(示例中给出 >= 15 的阈值)。
  • 明确区分强制性需求与可选需求,并说明理由。
  • 在需求不清晰或不完整时,记录所有假设。
  • 将每条需求映射到具体测试场景,便于后续验证。
  • 在技术规格中为主要设计决策给出理由。
  • 使用 Context7 核实最新库文档与最佳实践(资料提及该工具,但未提供具体用法)。
  • 创建依赖图,展示任务执行顺序。
  • 通过客观性评分(0-100)衡量需求是“基于证据”还是“基于假设”,并给出分档说明:90-100 表示所有需求均经调查验证;70-89 表示多数已验证、部分假设已记录;50-69 表示验证与假设混合;低于 50 表示以假设为主,需要更多调查。

使用方式:资料给出的是工作原则和流程要点,例如先调查再定义、对问题打分排序、区分强制与可选、记录假设、映射测试场景、编写理由、核实文档、绘制依赖图。资料未提供安装命令、代码示例或具体调用方式。

适用场景:需求澄清与规格编写、技术方案前的现状调查、验收标准与测试需求定义、需求文档评审中的完整性与一致性检查。资料还提到可与相关技能配合:在需求定义前了解系统现状,在需求批准后委派实现,以及定义测试需求与验收标准。

限制与注意事项:资料列举了应避免的反模式,包括需求不清晰或不可测量、用实现细节代替需求、未调查现有代码就写需求、未识别技术与运行约束、把所有需求视为同等重要。资料还列出错误升级情形:非关键细节的轻微歧义、影响范围的不明确需求、技术上不可行的需求、违反安全或伦理的需求。资料未提供具体产品界面、收费、平台支持或价格信息。