product-planning:产物路径统一到 docs/pm/<项目>/ui/ + 划清「说人话」的适用面

一、路径统一(用户 2026-10-15 选 A)
- 活文件里 designs/<项目>/ 一律改 docs/pm/<项目>/ui/,共 22 处(SKILL.md 10、③段 SKILL.md 6、
  execution-runbook.md 4、④段 SKILL.md 2);_留痕 下两份历史存档不动。
- 「项目与路径约定」里那句重写:slug 就是 docs/pm/<项目>/ 这一层的目录名,各段产物挂在它下面
  (①research/ ②prd/ ③④ui/ 跨段 专题/)。
- 依据:技能里「文档的两态」早就写「方案文件夹=docs/pm/<项目>/,含①research/ ②prd/ ③ui/」,
  而「产物落哪」表与各段正文写的是 designs/<项目>/ ⇒ 技能内部两套口径打架;两个真实项目
  (contentm_agent / ai1net-dsh-server)的原型实际都在 docs/pm/<项目>/ui/,designs/ 目录并不存在。

二、划清「说人话」的适用面(用户要求排查后立的)
- 排查结论:两份技能都有「注入个性」那半 —— humanizer 的 Soul Injection Techniques(11 条,
  含「有观点/加感官细节/允许跑题/结尾不必收束」)、humanizer-zh 的「个性与灵魂」(含
  「有观点/适当使用我/允许一些混乱:跑题、题外话、半成型的想法是人性的体现」)。
  照它写会出乱比喻与口水话,与产品文档要的客观书面说明文相反。
- 改法:内容准则里加一条「适用面要划清」——只取「去 AI 味」那半(模式清单/五条核心原则/
  禁用清单/五维评分);⛔ 不取两节「注入个性」;口吻档固定 technical;五维里「真实性」按
  「不机械生硬」读。另加一条「同一件事更严的那份说了算」:④段 doc-language-spec.md 是本包最严的
  语体规范,冲突以它为准。反面清单加一条。
- 验收:check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 2063 / 失败 0 / 提示 27;
  工作区 CRLF 文件数 = 0。
This commit is contained in:
admin committed 2026-10-15 08:33:50 +08:00
1 parent d383876d89
commit f53d86dd4b
4 files changed
+26 -19

No files matched your search

@@ -5,7 +5,7 @@ description: 产品规划第③段,界面交互。设计工程供给默认来
# ③ 界面交互
回答两个问题:长什么样、怎么操作。产出 `docs/pm/<项目>/DESIGN.md` 与 `designs/<项目>/*.html`。
回答两个问题:长什么样、怎么操作。产出 `docs/pm/<项目>/DESIGN.md` 与 `docs/pm/<项目>/ui/*.html`。
> 段名为什么是「界面交互」(2026-10-02 定):
> 删「交付」:①②③都产出落盘文件,「交付」是三段共有的属性,不是③的专属;④段也在交付(说明区与独立产品文档),留着会让人以为③管完就结束了。
@@ -88,7 +88,7 @@ description: 产品规划第③段,界面交互。设计工程供给默认来
| ③段子步 | 做什么 | 产物 | 闸 |
|---|---|---|---|
| 3a 视觉规范 | 定契约(减法 + 加法)→ 定调(选定设计系统)→ 落令牌表〔方法主线按 `oil-ui-pro` 的方向探索走;要拉开方向让用户挑时用它的对比页〕 | 设计契约 + 令牌表 → `DESIGN.md` | Gate-1 方向门 |
| 3b 原型 | 按模板种子 + 版式骨架构建 | `designs/<项目>/<原型>.html` | — |
| 3b 原型 | 按模板种子 + 版式骨架构建 | `docs/pm/<项目>/ui/<原型>.html` | — |
| 3c GPT 参考版 | 让 GPT 按需求+风格**独立生成一版当参照物**(本段特有,两个设计技能都不覆盖) | `3c-GPT参考版.md` | — |
| 3d 审查与打磨 | 收口 → 动效 → 终检〔按 `oil-ui-pro` 的评审协议做一轮独立评审打分〕 | file:line 清单 + `3d-审查报告.md` | Gate-2 / Gate-3 |
@@ -232,7 +232,7 @@ Gate-1 方向门(硬闸,不可跳)——按本表逐项自检(字段定
```
4. 等回答出完再取(停止生成按钮消失或出现复制按钮),把 HTML 与那三句话原文取回,不要读一半就走;回答被截断就先让它分页给全再取。
5. 落盘 `designs/<项目>/3c-GPT参考版.md`,三段式:提问原文(含贴进去的需求与风格)→ 模型回答原文(含三句话说明 + 完整 HTML,HTML 放代码块)→ **对照表**。
5. 落盘 `docs/pm/<项目>/ui/3c-GPT参考版.md`,三段式:提问原文(含贴进去的需求与风格)→ 模型回答原文(含三句话说明 + 完整 HTML,HTML 放代码块)→ **对照表**。
对照表固定四列:
@@ -302,7 +302,7 @@ Gate-1 方向门(硬闸,不可跳)——按本表逐项自检(字段定
### 审计报告落盘
`designs/<项目>/3d-审查报告.md`,固定七节:范围 + 挡位 + 阻断项表 + 建议项表 + 状态覆盖核对表 + 结构核对表 + Gate 结论(含「本轮是否跑了脚本」一句)。
`docs/pm/<项目>/ui/3d-审查报告.md`,固定七节:范围 + 挡位 + 阻断项表 + 建议项表 + 状态覆盖核对表 + 结构核对表 + Gate 结论(含「本轮是否跑了脚本」一句)。
## 硬约束
@@ -346,8 +346,8 @@ Gate-1 方向门(硬闸,不可跳)——按本表逐项自检(字段定
- 渲染终检已过(溢出 0 / 对比度按真实像素达标 / 结构与排版量测无阻断且无「无法判定」项 / 两个视口的截图都存进 `_gate_shots/`),或已写明为何不适用。量测数字以 DOM 取值与脚本输出为准,不得用「目测」代替
- 每个浮层都手工打开数过可见关闭出口(`== 1`),`Esc`/点遮罩能关、焦点锁在层内且关闭后回到触发按钮,结论连同触发路径写进 `3d-审查报告.md`。「代码里看着只有一个」不算
- 对外提交/交付留档的截图只用视口帧(`_gate_shots/<视口>.png`);`_full/` 下的长图不得作为评审输入
- `designs/<项目>/3c-GPT参考版.md` 存在,含提问原文、参考版原文(三句话 + 完整 HTML)与四列对照表(采纳项已改完并复测);未取到参考版的已明示
- `designs/<项目>/3d-审查报告.md` 存在,含阻断/建议两张表 + 状态覆盖核对 + Gate-2/3 结论
- `docs/pm/<项目>/ui/3c-GPT参考版.md` 存在,含提问原文、参考版原文(三句话 + 完整 HTML)与四列对照表(采纳项已改完并复测);未取到参考版的已明示
- `docs/pm/<项目>/ui/3d-审查报告.md` 存在,含阻断/建议两张表 + 状态覆盖核对 + Gate-2/3 结论
- Gate-2 与 Gate-3 均已通过(书面结论,非口头)
- 重大改版:旧版文件仍在磁盘上,且收尾给出新旧差异(改了什么 / 为什么 / 代价)
@@ -254,7 +254,7 @@
- 防溢出三件套:grid 写 `minmax(0,1fr)`(不是 `1fr`)、flex 子项加 `min-width:0`、表格 / 代码块外层 `overflow-x:auto`
- 交互态齐全:`hover` / `active` / `focus-visible` 三态都要写,焦点环不许被 `outline:none` 抹掉(`craft/accessibility-baseline.md`)
- 规范 HTML:非空元素显式闭合、属性双引号
- 文件名要有描述性;集中放 `designs/<项目>/`,不散落仓库根
- 文件名要有描述性;集中放 `docs/pm/<项目>/ui/`,不散落仓库根
### 3.4 本项目附加纪律(`open-design` 未涉及)
@@ -387,7 +387,7 @@
> 这一格是**假的**(那五条当时零覆盖),而它正是「全绿却难看」的开关。
无头截图已代劳其中的溢出与响应式破损,其余仍需人眼(截图查不出「点了没反应」,那靠 3b 的 `browser-harness` 实测)。
落盘 `designs/<项目>/3d-审查报告.md`,按 `05` §五的模板:范围 + 挡位 + 阻断项表 + 建议项表 + 状态覆盖核对表 + Gate 结论。
落盘 `docs/pm/<项目>/ui/3d-审查报告.md`,按 `05` §五的模板:范围 + 挡位 + 阻断项表 + 建议项表 + 状态覆盖核对表 + Gate 结论。
---
@@ -464,13 +464,13 @@
- [ ] 原型 HTML 单文件自包含、双击可开,内联自检三条通过(无 unpkg / 无外部 jsx 引用 / 挂载点在)
- [ ] 状态穷举六项逐条有结论(`05` §三第 1 项)
- [ ] 每个按钮、每个跳转都用 `browser-harness` 真点过,含空 / 加载 / 错误 / 失败重试四态,并回报控制台报错原文与「点了没反应」清单
- [ ] `designs/<项目>/3c-GPT参考版.md` 存在,含提问原文、参考版原文、四列对照表;未取到已明示
- [ ] `docs/pm/<项目>/ui/3c-GPT参考版.md` 存在,含提问原文、参考版原文、四列对照表;未取到已明示
- [ ] D3 收口已按 5.1 三处判据人工过完:Gate-1 自检表 + `craft/` 四份规约 + 本项目追加判据,阻断项清零(取值结果已抄进报告)
- [ ] D5 终检已真渲染:`1440x900` 与 `390x844` 两个视口各截一张,视口帧已留档;横向溢出 0 / 对比度不达标 0 / 结构与排版阻断 0,且无「无法判定」项(DOM 取值已抄进报告)
- [ ] 每个浮层都手工打开数过可见关闭出口(`== 1`)+ `Esc` / 点遮罩能关、焦点锁在层内且关闭后回到触发按钮;结论与触发路径已写进 `3d-审查报告.md`
- [ ] 对外提交 / 交付留档的截图只用视口帧;`_full/` 长图未作为评审输入
- [ ] 契约里每个写出来的数字都已实测回填(首屏条数 / 行高 / 承载占比 / 面积占比 / 对比度比值),「契约值 / 实测值」并排列出;未回填即阻断;契约未声明判据的档位已记为证据缺口
- [ ] `designs/<项目>/3d-审查报告.md` 存在,含阻断 / 建议两张表 + 状态覆盖核对 + 结构核对(数字抄自脚本输出,非「目测」)+ Gate-2/3 结论
- [ ] `docs/pm/<项目>/ui/3d-审查报告.md` 存在,含阻断 / 建议两张表 + 状态覆盖核对 + 结构核对(数字抄自脚本输出,非「目测」)+ Gate-2/3 结论
- [ ] Gate-2 与 Gate-3 均已通过(书面结论,非口头)
- [ ] 重大改版:旧版文件仍在磁盘上,且收尾给出新旧差异(改了什么 / 为什么 / 代价)
- [ ] 偏离单已附,且无静默偏离
@@ -17,7 +17,7 @@ description: 产品规划第④段,原型说明文档。在③段已跑通的
| 来自 | 读什么 | 用来定什么 |
|---|---|---|
| ③ | `designs/<项目>/*.html` | 界面事实的唯一依据:页面、模块、控件、状态、交互、跳转、反馈 |
| ③ | `docs/pm/<项目>/ui/*.html` | 界面事实的唯一依据:页面、模块、控件、状态、交互、跳转、反馈 |
| ② | `docs/pm/<项目>/prd/2a-产品功能.md` · `prd/2b-界面布局.md` | 术语口径、优先级、功能条目编号 |
| ① | `docs/pm/<项目>/research/1a-需求文档.md` | 需求来源与「不做什么」的边界 |
@@ -44,7 +44,7 @@ description: 产品规划第④段,原型说明文档。在③段已跑通的
**产物 B · 独立产品文档**
- 单独一个 HTML 文件,落 `designs/<项目>/产品文档.html`,双击能开,能单独发给不看原型的人。
- 单独一个 HTML 文件,落 `docs/pm/<项目>/ui/产品文档.html`,双击能开,能单独发给不看原型的人。
- 四块顺序固定,另加附录「原型页面地址」。
## 4c 演示引导(可选)