需求澄清
clarifyConverts vague requirements into a structured spec.json by asking focused questions, validating answers, and returning the next question or blocked next action for review.
Instructions
需求澄清:把一句模糊的需求逐步收窄成结构化 Spec,写入 spec.json 供 review 当判定基准。**每次调用都会返回当前该回答的问题(currentQuestion)——丢了上下文就空调用一次,它会告诉你现在该答什么。**典型流程:带 requirement 开始 → 带着 answer 与 questionId 逐问作答 → 全部答完后自动跑质量门禁,通过则产出 spec.json;不通过返回 status:"blocked" 与 nextAction,照着重答即可。想最快拿到 Spec:{requirement, skipOptional:true} 跳过可选项,两次调用即可完成。门禁未通过但确实要产出时用 force——它只放宽「验收标准条数」这类质量规则,不放宽「描述为空 / 一条标准都没有」这类结构规则(那是空基准,比没有基准更糟)。注意:.vibeguard/spec.json 不存在时 review 会降级为「无基准」分析(全部 implicit、不告警)。
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "clarify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | 门禁 blocked 时强制产出,只放宽质量规则 | |
| answer | No | 对 currentQuestion 的回答,可以多行 | |
| restart | No | 丢弃当前会话重新开始(旧会话留在 .bak) | |
| questions | No | 覆盖内置的 6 问模板(仅新会话生效)。宿主 AI 可据此提出针对当前需求的问题,例如「搜索范围是仅标题还是含描述与讲师?」 | |
| questionId | No | 这个答案针对哪一问(= 上次返回的 currentQuestion.id)。会话已有回答时必须回传 | |
| requirement | No | 初始需求描述。**直接作为「功能描述」的答案**,正常路径下不会再被问一次 | |
| skipOptional | No | 一次性跳过全部未答的可选问题(不跳必答项,不清空待重答队列) |