docs: clarify HTML previewer integration

This commit is contained in:
2026-10-13 00:21:22 +08:00
parent ab29598a9a
commit d3b6732d40
7 changed files with 40 additions and 16 deletions
+6 -3
View File
@@ -73,8 +73,10 @@ description: >-
6. 按可独立验证的垂直切片拆任务,写出依赖、关键路径、`expected` 和 `verification`,
但不要写入 `.pouch/ack/tasks.yaml`。
7. 按模板生成自包含 HTML PRD,并在回复中说明文件路径、版本、待确认问题和下一步。
8. 用户需要在其它设备查看 HTML 时,调用已安装的 `previewer` 能力传入该文件;不要在
`specifier` 内复制 Tailscale Serve 逻辑。previewer 返回 URL 后,把 URL 和对应 PRD 版本一起给出。
8. 用户需要在其它设备查看 HTML,或说“把这个 HTML 渲染出来”时,调用已安装的
`previewer` 能力传入该文件;不要在 `specifier` 内复制 Node/Tailscale Serve 逻辑。
previewer 返回结果后,必须把对应 PRD 版本、Tailscale IPv4、完整 HTTP URL、过期时间
和停止命令一起给出,并明确说明应使用返回的哪个 IP 访问。
如果调研发现需求边界、目标或关键依赖存在两种互相冲突的解释,停止在 `review`,明确列出
冲突,不能自行替用户拍板。
@@ -93,7 +95,8 @@ description: >-
按 [review-loop.md](references/review-loop.md) 记录状态和审计信息。
如果需要远程预览,读取 `previewer` 的调用契约并把 PRD 文件路径交给它;previewer 不改变
需求评审状态,HTML 被展示不等于用户批准。
需求评审状态,HTML 被展示不等于用户批准。回复中要同时给出 Tailscale IP 和 URL,不能只
说“已经渲染”或只返回本机 `127.0.0.1`。
## 批准和 ACK 交接