用途:在实现前澄清产品与技术预期,显式记录假设,并产出可引用真实代码库模式的需求规格。适合用户要求澄清新功能范围、编写或完善需求文档/规格,或需求命令工作流处于活动状态时使用。
主要能力:
- 5 阶段工作流:初始化会话 → 发现式提问(产品范围)→ 自主上下文收集 → 细节提问(行为与设计决策)→ 生成需求规格。
- 会话初始化时创建 requirements/[timestamp]-[slug]/ 目录,生成 00-initial-request.md 与 metadata.json,并更新 requirements/.current-requirement;同时扫描代码库识别相关模块、数据模型、路由和 API。
- 通过 01-discovery-questions.md、02-discovery-answers.md、03-context-findings.md、04-detail-questions.md、05-detail-answers.md、06-requirements-spec.md 等产物记录全过程。
- 提供命令行为:requirements-start、requirements-status、requirements-current、requirements-list、requirements-remind、requirements-end。
- 规格包含概述、功能需求与验收标准、技术需求、受影响的文件/系统、假设与未决问题;未决项标注 ASSUMED: 并说明理由。
使用方式与规则:每条消息只问一个问题,问题保持封闭式(是/否或带默认值的 2-5 项有限多选);每阶段先写完整问题再依次提问,阶段问题数目标为 5 个(可合理放宽至 4-7)。产品语言优先,仅在有助于决策时补充技术说明。收集需求期间不编写实现代码。路径在发现后使用真实仓库路径,模板中才用占位符。
限制:资料未提供安装命令、价格、支持平台或运行环境要求;该技能依赖当前 agent 运行时提供的搜索、读取与导航工具,附带技能仅视为可选加速项而非依赖。