| name | design |
| description | 产品定义设计环节:基于 brief.md 与 Demo 决策,深度整合 grill-me,从产品、技术、测试三个维度批量拷问(每轮 5-10 个问题),编写 definition.md(PD 产品底线 + TD 技术决策 + AC 验收标准,TD 首条为架构位置图)与可选的宏观架构图,交人类 review 定案后方可进入 build。取代原 prd / testcase / architect 三个环节。 |
| license | MIT |
design
PRD / 技术设计 / E2E TestCase 三件套本是同一批决策的三种视角——本环节一次定案为产品定义。
格式与粒度以 docs/harness.zh-CN.md 第 7.5 节为权威,判据只有一条:只写决策,不写实现——
模型可以自己安全决定或推翻的内容,不进产品定义。
前置
加载 ${CLAUDE_PLUGIN_ROOT}/shared/core-contract.md;已有 brief.md(及 Demo 决策清单,若做过 Demo)。
拷问
以 grilling / grill-me 的方式,按三个维度批量出题,每轮 5-10 个问题,每题附推荐答案与理由:
- 产品维度 → PD:不可退让的底线是什么?失败 / 空态 / 极端场景下产品该怎么表现?
Demo 确认的决策逐条落位,逐条编号。
- 技术维度 → TD:哪些选择难以回头(供应商、协议、数据所有权、领域边界)?
理由与被排除的备选是什么?可逆的实现细节一律不收录,并写"不收录"反例示范粒度。
- 测试维度 → AC:从真实用户入口、以黑盒定义"什么算对、什么算不合格"
(must / must_not / 超时 / 必需证据),每条 AC 回指一条 PD;
必须恰好指定一条 Core-Case(F0 正向主链路)并声明其 test / production 冒烟投影。
架构位置图(TD 固定首条)
从项目全景架构图裁剪本需求视角的位置图:只许引用全景已有节点名,标色画出触及的层次、
模块与依赖方向。它是升级规则的检测器:
- 只用到现有节点与现有边 ⇒ 架构未动,画完即决策背景;
- 出现新节点 / 新依赖边 / 跨领域调用 ⇒ 本需求动了架构,必须同步产出或修订
ADR 与全景标色快照(宏观架构图),产品定义内只留决策一句话加链接。
项目尚无全景图时,先补立项决策(走 harness-init / harness-retrofit);
不允许架构语义只存在于某个 feature 的 definition.md 里。
收口
definition.md(+ 必要的 ADR / 全景快照)交人类 review:确认 → 状态置为已定案,进入 build;
否则按反馈修改再审。定案后每一条都不许模型自行推翻。
产出
已定案的 definition.md(含架构位置图、Core-Case 与冒烟投影声明)。下一步:build。