使用 hoq MCP 服务器构建质量屋
该服务器 (node mcp/server.js --file house.json, 来自 github.com/jerlandson-supernova/house-of-quality) 持有一个 House 实例,并在每次更改后保存。用户可以在网页中打开同一文件并继续编辑;你提出的提议会在那里等待用户确认。
会话步骤(按顺序)
- 谁是利益相关者? 询问。然后,对于每位利益相关者,用他们自己的话记录他们需要什么。使用
need_set设置need、source、short。将需求控制在约 16 条以内。不要根据产品描述自行编造需求。 - 重要性 为 1 到 5,属于利益相关者。询问后,使用
need_set设置importance和by(谁给出的)。永远不要猜测。 - 特性:针对每个需求,可以测量设计的哪些方面来表明该需求被满足?使用
characteristic_set设置unit(单位)、direction(方向 ↑ ↓ ◎)、target(目标值,陌生人可测试)、today(当前测量值)。无单位意味着这是一个愿望,而非特性。任何必须在发货前通过的内容(安全、法律)设置gate: true。 - 房间:对于每一对(需求-特性),如果该特性决定了需求是否被满足,则评分为 9;有明确影响则为 3;有部分影响则为 1;否则留空。大多数单元格保持空白。通过
relationships_set_many提议,每个单元格附带一行note以及你掌握的evidence(证据)。在用户确认之前这些评分不计入任何计算。用户确认时使用proposal_confirm并带上他们的名字,且仅在他们在页面上明确同意后才调用。house_next会找出值得关注但仍为空白的单元格:没有特性支持的需求、没有强驱动者的需求、没有驱动任何内容的特性。 - 屋顶:成对的特性之间互相帮助 (++, +) 或冲突 (−, −−)。通过
roof_set提议。每项权衡都是为某人做的决策;注明是谁的决策。 - 当前状态和目标(Today and goal):每个需求从 1 到 5 级,通过
need_set设置,并带有by字段。 - 查看结果:
house_validate(将空白行/列读回给用户),house_priorities(前五个优先级及门控项),house_diagonal(块状图为模块;耦合性判断是否存在构建顺序;需切断的耦合点表示需要重新设计),以及通过items_import从追踪器导出导入工单(或逐条使用item_set),然后使用house_items:查看哪些门控已清除,关键路径上的下一个开放步骤,看板与测试结果不一致之处,逾期项,以及每个工单对 House 的贡献度。 - 交接成果:
house_markdown是给人类阅读的报告;house_export为tsv格式并附上当前日期,是记录的权威版本;house_export为svg格式是图片;xlsx是包含实时公式的工作簿。
规则
- 你编造的需求比缺少一个需求更糟糕。你猜测的数字比留空更糟糕。
- 在提议单元格之前说明推理过程;将其放入
note字段中。 - 重要性、当前状态和目标:始终附带
by字段。来源是审计追踪。 - 门控项保留其权重,但永不参与功能排名。
- 看板状态是一个声明。状态来自追踪器 (
items_import);tested状态只能是 verified、partial、fails、not_built 之一,且仅基于你已看到的证据设置,并附带retested作为测试日期。导入操作永远不会改变已有的测试结论。 - 网页用于工作;带日期的 TSV 文件是大家引用的版本。网页上的编辑不会通知任何人。
如果服务器以 --assist 参数运行
assist_suggest 要求模型为结构空缺的单元格提供值;assist_members 从用户提供的文本中提取需求或特性。两者都仅返回提议,行为者属性为 assist:<model>。在用户确认之前,将模型的分析理由读给用户;永远不要自行确认模型的建议。
工具一览
house_new · house_open · house_save · house_summary · house_get · house_validate · house_log · need_set · need_remove · characteristic_set · characteristic_remove · relationship_set · relationships_set_many · roof_set · propose · proposals_list · proposal_confirm · proposal_reject · house_next · item_set · items_import · item_remove · status_scale_set · house_report · house_markdown · house_priorities · house_diagonal · house_items · house_draw · house_export
资源: hoq://house, hoq://report, hoq://report.md, hoq://drawing.svg。提示词: qfd_session。