Files
workbuddy_skills/product-planning/references/_留痕/①段-已删除产出与方法论.md
T
admin 61962f1726 补入本地今日改动:session-mechanism + product-planning(按用户令改推本仓库)
背景:旧远端 work.alotbuy.com 今天一直连不上(222/22 端口都不通)⇒ 今天本地累积多条提交推不上去;
用户令改推本仓库 [email protected]:admin/workbuddy_skills.git(只推这 5 个技能:
browser-harness / humanizer / humanizer-zh / product-planning / session-mechanism)。

本次改动(对照本机已安装的技能源逐文件 md5 比对得出,⛔ 是「补差异」不是「整体覆盖」):
· session-mechanism:含今天两条钩子改动(派活收工闸、点名加载收工闸)、
  rules.md §9「只写正向范围」、检查程序静默阈值 10→6、检查排期补 workspace_scope(修未分组)、
  以及今天修的三处陈旧指针(旧技能名 dsh-decision / agent-operating-rules 与旧路径编号)。
· product-planning:第③段「随段样式风格库」并入 design-system-tiaoyue、竞品分析方法论重写等。
· humanizer / humanizer-zh:已一致,零改动。
· browser-harness:比对出的 7 个「本地独有」全是**它自己 .gitignore 里就排除的**构建产物
  (src/*.egg-info/ 与 uv.lock)⇒ 按该技能自己的规矩不推(用户口径「不要环境」)。

仓库级配置(与旧仓一致):core.autocrlf=false;身份 maogeigei <[email protected]>。
⚠️ 克隆时仓库默认 autocrlf=true(会把行尾转成 CRLF)⇒ 已改回 false 并重新暂存,
   核对索引 blob 均为 LF、真实差异 23 个(⛔ 不是把几百个文件一起改掉)。
2026-10-07 20:33:49 +08:00

7.4 KiB
Raw Blame History

①段留痕 · 已删除的产出与方法论

本档不在技能上下文里 —— SKILL.md 只在需要溯源时指向它,⛔ 正文不展开这些内容。 为什么外置(2026-10-07 用户定案):「技能中不需要写不用于XXXX,会造成上下文污染,直接写用于什么,把不相干的内容都删除」。 性质:2026-10-07 从 ../SKILL.md 逐字搬出的原文,只增不删,作为「为什么删」的唯一可读留痕。 防复活不靠本档 —— 由 scripts/check_naming.py 的 DEAD_OUTPUTS / DEPRECATED / WHITELIST 机器判。 ⚠️ 原文里提到的路径(如 待清理/)是当时的记录,不代表现在存在。


一、1a 曾拆成两份(00-问题定义.md / 01-需求澄清.md)

🔴 本子步的产出是「一份」文档,不再拆成「一句话」和「决策表」两份(2026-10-06 用户定案)。 ⛔ 已废的两份:00-问题定义.md(一句话+范围表)、01-需求澄清.md(决策表)—— 它们说的本来就是同一件事,拆两份只会打架。内容合并进 1a-需求文档.md:开头写清"做什么 / 为谁 / 不做什么",往下摊开成决策表——目标、用户、范围与"明确不做什么"、手上已有的素材、约束、依赖、替代方案。

二、grill-me 曾有两份(①段一份 + ②段一份)

⭐ grill-me 全场只有本段这一份(2026-10-06 用户定案:「grill-me 也应该拿到第一步了,第二步就是细化功能」)。 原②段另有一份 grill-me.md(火力点是"做成什么样、状态怎么流转"),已删除并合并进本份。合并后本份按 A / B 两节提问。

三、子步从 6 个收成 5 个

⭐ 子步从 6 个收成 1 个(2026-10-02 用户定案「全部删除」)—— 市场分群、访谈准备、访谈整理、反馈分析四项方法论已删。删除理由不是"暂时没做",是结构性不可用:

  • ⛔ 市场分群:唯一使用者是用户本人,⛔ 不存在"要分群的多个市场"。
  • ⛔ 访谈三类:单机自用、没有外部用户可访谈;拿自己当访谈对象产出的就是自证材料(与机会树同病)。
  • ⛔ 反馈分析:需要真实反馈数据(评论/问卷/工单),⛔ 本项目一条都没有。

⭐ 同时把机会树也删了(用户原话:「完全没用,都是编的」)。

四、user-stories.md 曾独立成文

⛔ 不用另写一份"用户故事":原②段的 user-stories.md 已删除,其内容归入本份。

五、商业模式与变现(精益画布 / 变现策略)

⭐ 商业模式与变现已删(2026-10-02 用户定案)—— 精益画布与变现策略两份方法论一并移除。删除理由是结构性不可用:产出本产品不售卖、不融资、不面向付费用户(1b-竞品分析.md 开头自己写着「这不是要售卖的产品,所以不做市场规模、份额、定价、融资」)。⚠️ 若将来某个项目真的要做售卖,这两项要重新补回来 —— 方法论副本在 待清理/,可直接取回。

六、「需求文档」落点表里删掉的 5 行

| prd/user-stories.md | 已删(2026-10-06) | 用户故事归①段《使用场景》(1e-使用场景.md) | | ux/state-machine.md | 已删(2026-10-06) | 状态机整合进 ②段功能清单 | | ux/diagrams/* | 已删(2026-10-06) | 图示改名「界面布局」并整合进 ②段(独立成 prd/2b-界面布局.md) | | 00-问题定义.md | 已废(2026-10-06) | 并入 1a-需求文档.md | | 01-需求澄清.md | 已废(2026-10-06) | 并入 1a-需求文档.md |

七、原「已删除的产出」整节(原文)

⛔ 机会树(research/20-机会树.md + references/opportunity-solution-tree.md)

用户原话:「完全没用,都是编的,不如去掉」。

实测支撑(原 docs/pm/proto-versioning/ 七份取证产出里只有它零证据可查;⚠️ 该目录已于 2026-10-06 整体清除,备份在 归档/proto-versioning清除备份__20261006-051003/):

  • 全文零外链、零【事实】、仅 1 处【假设】。
  • 它的 Importance / Satisfaction 分数(0.90 / 0.10 / Score 0.81…)没有任何数据来源,是纯主观填数。
  • 它自己首段就写着「无真实数据,全部为用研判断」—— 诚实标注了,但标注不等于成立:一份自己都承认没数据的文档,占着「1b 取证」的名额产出。
  • 它的下游产物(strategy/31、strategy/30、②段的 priorities.md)大量引用这些分数 ⇒ 编的数会一路传到功能优先级。

替代:⛔ 不产出任何替代文档。它的真实内容("我改错了回不去""文档互相踩")已经由 1a-需求文档.md 的用户原话承载 —— 用户自己说的问题不需要打分。

⭐ 由此立的一条纪律:打分必须有数据源;没有数据源就不打分,写清"这是判断"即可。 ⛔ 凭空打分 进反面清单。

价值主张 → 使用场景 → 用户故事(strategy/31-价值主张.md → 31-使用场景.md)

用户原话(2026-10-02):「价值主张 不如改为使用场景」。 用户原话(2026-10-06):「1 中的 使用场景 就是 用户故事 按照用户如何使用解决什么问题来梳理」。

两次改的理由:

第一次(价值主张 → 使用场景):原文档是 Who / Why / What Before / How / What After / Alternatives 六段,其中 Who 与 What After 在旧稿(已废的 PRD.md)§7.1.1 的 S1–S5 场景表里已经写过一遍(谁、什么时候、要办成什么、落在主线哪一步)。⇒ 两份文档描述同一批人、同一条链,必然打架,而且价值主张里那套 What After 是"改成什么样"的想象,不是可核的交付。

第二次(三段式 → 用户故事格式,2026-10-06):改称使用场景后,文档写成了「处境 / 现在怎么凑合 / 不用会用什么」三段 —— 是分析者视角,不是用户视角,读起来像一份论证,不像用户的话。用户定案改成用户故事格式(作为…当…我要…这样…),并明确它就是用户故事。

改成什么:references/usage-scenario.md —— 唯一句式 作为【谁】,当【什么处境】,我要【办成什么】,这样【得到什么结果】,四槽位缺一不算完成。 旧三段式的残留价值不丢:处境 → 「当…」槽位;凑合与替代 → 「这样…」的反面与对照(映射表见该文件 §5)。 边界(2026-10-06 重划):场景的归口是①段本份(②段按它梳理功能,⛔ 不重写场景,重写必打架);⛔ 不许在①段写"每页放哪几块"那种界面话(那是②段《界面布局》与③段 D0 的活)。 与②段的接口:《使用场景》是②段功能清单的直接推导依据 —— ②段每列一项功能都要能追回某条场景;追不回的该砍。

反面清单里被删掉的一条

⛔ 重新产出机会树(已删除)

  • 把推演出来的用户画像当用研结论进 1c —— 三个 JTBD 若都追不到一句用户原话,那是自证不是用研
  • 越界去写 ②段、出原型或写原型说明文档(那是第②③④段)