背景:旧远端 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 个(⛔ 不是把几百个文件一起改掉)。
7.4 KiB
①段留痕 · 已删除的产出与方法论
本档不在技能上下文里 ——
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 行
|
| 已删(2026-10-06) | 用户故事归①段《使用场景》(prd/user-stories.md1e-使用场景.md) | || 已删(2026-10-06) | 状态机整合进 ②段功能清单 | |ux/state-machine.md| 已删(2026-10-06) | 图示改名「界面布局」并整合进 ②段(独立成ux/diagrams/*prd/2b-界面布局.md) | || 已废(2026-10-06) | 并入00-问题定义.md1a-需求文档.md| || 已废(2026-10-06) | 并入01-需求澄清.md1a-需求文档.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 若都追不到一句用户原话,那是自证不是用研
- 越界去写 ②段、出原型或写原型说明文档(那是第②③④段)