product-planning:新增「文档的两态:当前版与过期版」——方案文件夹放当前权威版、归档-过期版收过期文档,含收口四步与实测依据

This commit is contained in:
admin committed 2026-10-11 20:27:09 +08:00
1 parent fd9c902bcc
commit 90cc4315d5
2 files changed
+19 -4

No files matched your search

+19 -4
View File
@@ -78,6 +78,21 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
| ③ | `docs/pm/<项目>/DESIGN.md`、`designs/<项目>/*.html`、`designs/<项目>/3c-GPT参考版.md` |
| ④ | 写进原型 HTML 自身(`designs/<项目>/*.html`),不额外落 md |
### 文档的两态:当前版与过期版
用户令(2026-10-11 逐字):「**应该有文件夹 专门归档过期文档, 当前文档 统一放在方案文件夹中**」。
🔴 **方案文件夹** = `docs/pm/<项目>/` 这一层 —— 它下面放的全是**当前权威版**:①段 `research/`、②段 `prd/`、③段 `ui/`、跨段 `专题/`,另加一份 `索引-当前权威版.md` 当入口。
🔴 **归档文件夹** = `docs/pm/<项目>/归档-过期版/` —— 被顶替下来的旧版全放这里,命名 `<原名>__<来源目标短哈希>.<扩展名>`(例 `2b-界面布局-新版__fc471a.md`)。
**每个目标收口时做四步**:
1、本目标的权威文档**覆盖**方案文件夹里对应的那一份。
2、被顶替的旧版**移进** `归档-过期版/`,按上面的命名补上来源短哈希。
3、更新 `索引-当前权威版.md` 里对应行的大小与日期。
4、执行区(`执行会话/目标-*/` 这类过程目录)里的原件**保留** —— 它既是过程留痕,也是台账 `artifact` 指向的地方,搬空会让回查断链。
**为什么要有这条**(避坑依据 · 2026-10-11 实测):同一个 `2a-产品功能` 在 6 个目标目录里各有版本、`2b` 有 7 个,光看文件名与字节数分不出谁新;而 `docs/pm/` 下早先那次归档又停在旧版(`2b` 只 52 256 B,最新已是 52 643 B)⇒ 用户问「很多新老方案都在文件夹中,后续根据方案细化产品界面,如何找得到对应的方案」。判断某份文档的当前版,**只看方案文件夹**;问「当时为什么这么定」才去归档文件夹翻。
### DESIGN.md 为什么在项目目录、不在仓库根
`DESIGN.md` 是③段的绑定视觉规范,一个项目一份,③段按当前项目的 slug 去读它。仓库根只能放一份,多项目会互相覆盖,所以一律放 `docs/pm/<项目>/DESIGN.md`。
@@ -112,16 +127,16 @@ DESIGN.md 说明:`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
## 可调用工具(自然语言触发)
> 两个随段携带的独立工具,装在③段 `references/stage-delivery/assets/` 下,按用户说法直接触发,产物落项目目录。它们都挂在③段下,不单独成段。
> 两个独立工具,按用户说法直接触发,产物落项目目录。`design-capture` 随③段携带(装在③段 `references/stage-delivery/assets/` 下);`video-capture` 2026-10-11 已独立成全局技能(装在用户技能仓 `E:/ProgramData/.workbuddy/skills/video-capture/`),跨段复用。两者都不单独成段。
| 用户说 | 触发工具 | 做什么 | 产物 |
|---|---|---|---|
| 「分析 XXX 视频」「把这个视频抽帧」「拆一下这条视频的画面」 | `stage-delivery/assets/video-capture/` | 取视频(本地文件 / 直链 URL)+ 抽帧(双因素 + 首尾 + 补帧) | 关键帧 `frames/` + `frame_times.json`(供①竞品分析、③视觉参考) |
| 「分析 XXX 视频」「把这个视频抽帧」「拆一下这条视频的画面」 | 全局技能 `video-capture` | 取视频(本地文件 / 直链 URL / 平台页经浏览器下到本地)+ 抽帧(双因素 + 首尾 + 补帧) | 关键帧 `c_<序号>_<真实秒数>s.jpg` + `frame_times.json`(供①竞品分析、③视觉参考) |
| 「获取 XXX 网站的设计风格」「抓这个网站的风格/组件/配色」 | `stage-delivery/assets/design-capture/` | 抓网页设计系统(色彩 / 排版 / 组件),生成样式模板 | 一套 `design-system-<名>/`(与 `design-system-tiaoyue` 同构,可直接被③段 D1 选用) |
两者都独立可单跑:`video-capture` 只依赖 `ffmpeg`;`design-capture` 只依赖本机 Chrome(CDP)+ `vendor/` 里搬运的抽取脚本,不需要任何外部服务在场。用法与边界见各自 `SKILL.md`,来源与署名见各自 `ATTRIBUTION.md`。
两者都独立可单跑:`video-capture` 只依赖 `ffmpeg`(权威件=全局技能 `video-capture`;原 `stage-delivery/assets/video-capture/` 只留交接说明,脚本迁至 `references/_留痕/video-capture-已独立-20261011/` 留档);`design-capture` 只依赖本机 Chrome(CDP)+ `vendor/` 里搬运的抽取脚本,不需要任何外部服务在场。用法与边界见各自 `SKILL.md`,来源与署名见各自 `ATTRIBUTION.md`。
触发时机:①②段拆竞品视频用 `video-capture`;③段要新建样式或拆参考站用 `design-capture`。
触发时机:①②段拆竞品视频用全局技能 `video-capture`;③段要新建样式或拆参考站用 `design-capture`。
两个工具都只做合规最小集:不抓平台页内视频,不调付费接口;抽取结果须先目视比对再采用。
File renamed without changes.