重开仓库内容:改推五个技能(browser-harness / humanizer / humanizer-zh / product-planning / session-mechanism)
按授权清空原有内容后重新提交(原 oil-ui-pro 一并移出,可从历史恢复)。 browser-harness 剔除 .venv 等运行环境;根 .gitignore 补记 .venv/ 与 node_modules/。
This commit is contained in:
1 parent
9a152a1952
commit
777f7fe5d0
240 files changed
+52518
-4409
No files matched your search
@@ -32,10 +32,10 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
|
||||
|
||||
> ⚠️ **2026-10-06 交接口口径反转**:②→③ 原写的是「⛔ 不许给页面结构」,**已废**。
|
||||
> **新口径:②段钉骨架,③段做皮肉。** 用户原话:「3 是负责设计和交互,**页面关系和布局必须在第二步确认清楚,不然第三步没有方向 一会一个样子**」。
|
||||
> ⇒ **②段必须给**:有哪几页、每页几个板块、板块怎么排、跨页关系。**③段⛔ 不许增删移动板块**,缺板块回②段改 PRD。
|
||||
> ⇒ **②段必须给**:有哪几页、每页几个板块、板块怎么排、跨页关系。**③段⛔ 不许增删移动板块**,缺板块回②段改 ②段。
|
||||
> ⛔ **仍归③段**:配色 / 字体 / 间距 / 组件样式 / 动效,以及每个板块的视觉与交互实现。
|
||||
|
||||
> ⚠️ **②→③ 仍是本流水线最容易被搞坏的一环**,但病灶换了位置:旧病灶是「PRD 说"必须能**读到**",③段读成"必须**常驻主屏**"」→ 五类信息全铺一屏 → 信息墙。
|
||||
> ⚠️ **②→③ 仍是本流水线最容易被搞坏的一环**,但病灶换了位置:旧病灶是「②段 说"必须能**读到**",③段读成"必须**常驻主屏**"」→ 五类信息全铺一屏 → 信息墙。
|
||||
> **分档表就是为这句歧义而生的**:它把"读到"明确成"一次点击内可达"这一档。**该纪律照旧有效**,只是现在**骨架不由③段独立推导,而是②段给定、③段在骨架内兑现分档**。
|
||||
|
||||
> 💡 **③段为什么在骨架给定后仍然不会"退化成照抄"**:它做的仍是**另一类工作** —— 骨架是灰块(有哪些块、什么顺序),③段要给的是**视觉与交互实现**(怎么排版好看、点哪有什么反馈、空态怎么呈现、响应式怎么变)。**两者不是同一样东西的粗细两版,是两个维度。**
|
||||
@@ -103,7 +103,7 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
|
||||
|---|---|---|
|
||||
| 页面设计全链(规范 → 原型 → 审查) | ③ 段 `stage-delivery` 自己的 D0→D5 流水线(判据与素材由两个页面设计技能供给) | 不要另找风格库、也不要自己手搓一套 token 与门禁 |
|
||||
| 评审用的可点原型 / 生产级前端页面 | ③ 段 3b(按 D2 构建,单文件 HTML 交付;**先判页型**:营销页取 `open-design` 技能的 `design-templates/web-prototype/`,**工具型页面取 ③段 `references/layouts-tooling.md`**) | ⛔ **不要不判页型就套 `web-prototype` 种子** —— 那是营销落地页骨架,会把后台做成营销页 |
|
||||
| 设计规范文件 | ③ 段 3a 生成 `DESIGN.md`(令牌表由 `open-design` 技能选定套的 `tokens.css` 产出 + 该项目 PRD 的界面需求) | 不要凭空编一套 token |
|
||||
| 设计规范文件 | ③ 段 3a 生成 `DESIGN.md`(令牌表由 `open-design` 技能选定套的 `tokens.css` 产出 + 该项目②段的界面需求) | 不要凭空编一套 token |
|
||||
| 架构图 / 流程图 / 时序图 | `diagram-design` | **不要手写 Mermaid** |
|
||||
| 状态迁移的守卫/副作用/并发 | `state-machine` | diagram-design 不覆盖这些,别指望它 |
|
||||
| 审美方向 / 风格定调 | `open-design` 技能里**选一套**(读候选套 `DESIGN.md` 第 1 章,按页面类型挑) | 不要用"米白+衬线+陶土色"这类默认审美,也不要凭感觉编 |
|
||||
@@ -120,6 +120,20 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
|
||||
|
||||
**DESIGN.md 说明**:`@google/design.md` 提供 `lint` / `diff` / `export` / `spec` 四个子命令,目前是 alpha(v0.4.0)。在非 TTY 的管道里可能不回显输出,需在真实终端里确认结果。**本机实测该命令完全不可用,不要拿它当校验关卡**;改由 D3 收口与 D5 终检**按真实像素人工复测**对比度(判据见 `open-design` 技能的 `craft/color.md`)。⚠️ 原两把门禁脚本(静态文案检查 / 渲染机检)**已随旧主干从磁盘移除**,当前**没有机器复现** ⇒ 结论只能记「人工判定」,不得写成「脚本已通过」。
|
||||
|
||||
## 可调用工具(自然语言触发)
|
||||
|
||||
> 两个「随段携带」的独立工具,装在 ③段 `references/stage-delivery/assets/` 下;按用户说法直接触发,产物落项目目录。它们**不是**新的段,只是叫得动的工具。
|
||||
|
||||
| 用户说 | 触发工具 | 做什么 | 产物 |
|
||||
|---|---|---|---|
|
||||
| 「**分析 XXX 视频**」「把这个视频抽帧」「拆一下这条视频的画面」 | `stage-delivery/assets/video-capture/` | 取视频(本地文件 / 直链 URL)+ 抽帧(双因素 + 首尾 + 补帧) | 关键帧 `frames/` + `frame_times.json`(供 ①竞品分析 / ③视觉参考) |
|
||||
| 「**获取 XXX 网站的设计风格**」「抓这个网站的风格/组件/配色」 | `stage-delivery/assets/design-capture/` | 抓网页设计系统(色彩 / 排版 / 组件)→ 生成样式模板 | 一套 `design-system-<名>/`(与 `design-system-tiaoyue` 同构,可直接被 ③段 D1 选用) |
|
||||
|
||||
- 两者都**独立、可单跑**:`video-capture` 只依赖 `ffmpeg`;`design-capture` 只依赖本机 Chrome(CDP)+ `vendor/` 里搬运的抽取脚本,**⛔ 不依赖 open-design daemon**。
|
||||
- 用法与边界见各自 `SKILL.md`;来源与署名见各自 `ATTRIBUTION.md`。
|
||||
- 触发时机:①②段拆竞品视频 → `video-capture`;③段要新建样式或拆参考站 → `design-capture`。
|
||||
- ⛔ 两工具都**只做合规最小集**(不抓平台页内视频、⛔ 不调付费接口);抽取结果须先目视比对再采用。
|
||||
|
||||
## 进入方式
|
||||
|
||||
| 你说什么 | 模式 | 从哪开始 |
|
||||
@@ -127,7 +141,7 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
|
||||
| "规划 XX" / "从零做 XX" | **全流程(自动处理)** | `stage-discovery` → `stage-requirements` → `stage-delivery` → `stage-proto-doc`,**一路跑完,段间不停下来问**(含 ① 段末) |
|
||||
| "先确认方案" / "跑完方案停下等我" / "规划 XX,先给方案" | **方案确认** | 同全流程、同一套四段,**唯一差别是 ① 段末停下等你确认方案**,确认后才进 ②③④ |
|
||||
| "只做产品需求" / "只做产品功能" / "只做界面交互" / "只做原型说明文档" | **单段** | **只调对应那一个 stage skill**,不展开其他段,也不催促回补前段 |
|
||||
| 已有 PRD,要出原型 | 单段 | 直接调 `stage-delivery`,从它的 3a 起 |
|
||||
| 已有 ②段,要出原型 | 单段 | 直接调 `stage-delivery`,从它的 3a 起 |
|
||||
| 已有原型,要补说明 | 单段 | 直接调 `stage-proto-doc`,从它的 4a 起 |
|
||||
| 只问某个单点 | 单段 | 不跑任何段,在对应 stage skill 内点名子步,或直接说要看哪份方法论 |
|
||||
|
||||
@@ -196,7 +210,7 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
|
||||
- 把估算数据写成确凿事实
|
||||
- 跳过 ③ 段 D0 的 Gate-1(未定死令牌表与设计契约)就开写页面代码
|
||||
- 在 `grill-me` 提问模式下仍套用"提问上限 3 个",把提问做成走过场
|
||||
- **只跑一次 `grill-me`**:① 没定义需求就去取证,或 ② 拿①段的需求定义代替功能压测直接写 PRD
|
||||
- **只跑一次 `grill-me`**:① 没定义需求就去取证,或 ② 拿①段的需求定义代替功能压测直接写 ②段
|
||||
- **把自动补全当默认动作**:用户没说话就替用户拍板,还没标 `【假设】`、没进待复核清单
|
||||
- 把 ④ 的说明区写进产品功能范围,或让 ③ 顺手把说明文档一起写了(该调 `stage-proto-doc` 就调)
|
||||
- 手写 Mermaid 代替 diagram-design,手写 token 表代替 DESIGN.md
|
||||
@@ -231,7 +245,11 @@ python scripts/check_naming.py
|
||||
> 例如「②段到底该不该给页面结构」这种反转,**闸门一个字都报不出来**(两版写法都合法)。
|
||||
> ⇒ **口径类改动要靠人工回读**,且**必须把反转理由与用户原话写进文档留痕**。
|
||||
⚠️ 脚本输出里的 `[提示]` 项(旧名出现)**不计入失败**,但要人工看一眼是不是落在「废止理由块」里 —— 落在里面是正当留痕,散落在正文里就是真残留。
|
||||
⚠️ **副本要一起查**(主副本 `product-planning/` + 副副本 `pm-skills/skills/` + 装入副本 `.workbuddy/skills/product-planning/`),否则改主副本忘同步,脚本会直接把差异报出来。
|
||||
🔴 **2026-10-07 起本技能只在全局一份**:`E:/ProgramData/.workbuddy/skills/product-planning/` ——
|
||||
**它就是本体**,⛔ 不再有「主 / 副 / 装入」三副本,也⛔ 不再需要「三处 md5 复核」
|
||||
(那只在有副本时才有意义)。改完**只跑一次**:`check_naming.py --ws <工作区>`。
|
||||
> 用户原话:「**把产品规划复制到 workbuddy 全局skills中 后续维护和使用全局技能**」。
|
||||
> ⚠️ 工作区原先那三份已归档到 `归档/技能迁全局-20261007/`(未直删,可随时取回)。
|
||||
- **把两种模式混用**:在自动处理模式下自作主张停下问方案,或在"方案确认"模式下确认前就开跑 ②③④
|
||||
- **在"方案确认"模式下把 ① 段的方案当成已确认就往下跑**:该模式下 ① 段末必须停下等用户确认(含"不做什么")
|
||||
- **下游擅自裁剪上游已拍板项**:②③④ 发现要砍 ① 段或决策表里已拍板的东西时,不许自行裁掉或改口径,必须列成"与已定决策的差异"交用户显式确认
|
||||
|
||||
Reference in new issue
Block a user