技能仓:技能根绝对路径清零(用户令:严格禁止技能中写这里绝对路径)

用户原话:「SKILL.md:189 判据源写 E:/ProgramData/.workbuddy/skills/
严格禁止技能中写这里绝对路径(除非跨根目录因引用),跨环境全部报错」

起因:product-planning/SKILL.md:189「判据来源」那句写了技能根绝对路径。
按同一判据全仓反查后清掉 10 个文件:

· product-planning:SKILL.md(判据来源 / video-capture 位置 / 本技能位置 + 新增「路径写相对或占位」规则)、
  references/_留痕/SKILL-总入口-20261007改说人话前.md、stage-delivery/assets/video-capture/SKILL.md、
  scripts/check_naming.py(注释)
· session-mechanism:SKILL.md(反例改占位 + 例外条款改写:由「文档/注释不在此列」改为「例外只有跨根引用」)、
  references/deploy.md(安装目录)、scripts/session-rules-check.py(docstring)、
  boards/会话看板/board-launch.py.tpl(模板占位符)
· video-capture:ATTRIBUTION.md(沿革)
· 改包纪律.md:3 条 cd 命令

判据(用户给的两分法):
· 技能根(本包自己 + 同根技能)⇒ 一律不写绝对路径,写 <技能根>/<技能名>/
· 跨根引用(工作区根 / 文档库根 / 本机软件安装位 / 宿主数据目录)⇒ 才落到具体位置,优先读环境变量

验收:
· product-planning 命名闸门:通过 2060 / 失败 0
· session-mechanism 全量自测:PASS 110 / FAIL 0
· 全仓 grep -r 反查该形态:清零(install.log 为运行时产物已 ignore;browser-harness/.venv 为 pip 元数据)
· 3 个被编辑器写成 CRLF 的文件已转回 LF,与 .gitattributes 的 eol=lf 对齐
This commit is contained in:
admin committed 2026-10-14 21:10:29 +08:00
1 parent 7a08cd3366
commit 2f656098de
10 files changed
+19 -18

No files matched your search

+4 -3
View File
@@ -127,7 +127,7 @@ DESIGN.md 说明:`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
## 可调用工具(自然语言触发)
> 两个独立工具,按用户说法直接触发,产物落项目目录。`design-capture` 随③段携带(装在③段 `references/stage-delivery/assets/` 下);`video-capture` 2026-10-11 已独立成全局技能(装在用户技能仓 `E:/ProgramData/.workbuddy/skills/video-capture/`),跨段复用。两者都不单独成段。
> 两个独立工具,按用户说法直接触发,产物落项目目录。`design-capture` 随③段携带(装在③段 `references/stage-delivery/assets/` 下);`video-capture` 2026-10-11 已独立成全局技能(装在**技能根**下的 `video-capture/`),跨段复用。两者都不单独成段。
| 用户说 | 触发工具 | 做什么 | 产物 |
|---|---|---|---|
@@ -186,7 +186,7 @@ DESIGN.md 说明:`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
- 不做八股:不介绍方法论来源,不列人名,不复述框架历史,直接给结论。
- ⭐ 内容准则:一切落盘文字都要先过「说人话」这一关(2026-10-07 用户定案,同日扩大到规则文件)。用户原话:「当作第一步 和 第二步 生成文档时 必须遵循的内容准则」「不管是写规则 还是 写文档 都要严格按照说人话的技能去执行」。
- 适用面两类都算,只改产出不改规则等于半改。一是产出文档:`research/1a-需求文档.md` 到 `1e-使用场景.md`(5 份)、`research/1b-独立分析/`(独立分析体)、`prd/2a-产品功能.md` 与 `prd/2b-界面布局.md`(2 份)。二是规则本身:本技能包内的一切落盘文字,`SKILL.md`、`references/**`、模板与清单。
- 判据来源(单一可信源,本文件不复述模式清单):`humanizer`(55 条模式、5 种口吻档 casual / professional / technical / warm / blunt),`humanizer-zh`(24 条模式、快速检查清单、50 分制评分)。两份技能都在 `E:/ProgramData/.workbuddy/skills/`,完整判据以源技能正文为准。
- 判据来源(单一可信源,本文件不复述模式清单):`humanizer`(55 条模式、5 种口吻档 casual / professional / technical / warm / blunt),`humanizer-zh`(24 条模式、快速检查清单、50 分制评分)。两份技能与本技能**同处一个技能根**(`<技能根>/humanizer/`、`<技能根>/humanizer-zh/`),完整判据以源技能正文为准。
- 取哪一份(2026-10-08 补):**模式清单取 `humanizer`**(它另有 `references/patterns.zh.md`,中文产出读那一份);**评分与门槛取 `humanizer-zh`** 的五维表。两份口径冲突时以 `humanizer-zh` 为准 —— 本项目产出是中文。
- 门槛:按 `humanizer-zh` 五维评分(直接性 / 节奏 / 信任度 / 真实性 / 精炼度)≥45 / 50 才准落盘;低于 45 回炉重写。
- ⛔ 取不到判据来源时(2026-10-08 补):两份技能都不在位或读不到 ⇒ **不许凭感觉判「这条够人话」**。在段末报告与 `3d-审查报告.md` 里明写「无判据来源,本项未判」,按与 §供给·工艺数值判据 的「证据缺口」同一口径处理。
@@ -200,6 +200,7 @@ DESIGN.md 说明:`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
- 必须落盘:产出写入文件,不要只在对话里输出。
- 无来源就标注:任何查不到来源的数据都标为「估算」并写明口径,不编造数字当事实。
- 禁止长文:单份产出物默认一页纸(≤120 行),超长必须拆分。
- 🔴 路径写相对或占位(2026-10-14 用户令):本包内一切文字(`SKILL.md`、`references/**`、脚本与注释、模板)引用**本技能自己或同根技能**的位置时,写相对形态 —— 同根技能写 `<技能根>/<技能名>/`,本包自己的文件写包内相对路径(如 `references/stage-delivery/`)。只有**跨根引用**(工作区根、文档库根、本机软件安装位这类从本包推不出来的别的根)才落到具体位置,且优先读环境变量(`DSH_WS_ROOT` / `DSH_DOCS_ROOT` / `WORKBUDDY_BIN_ROOT`)。原因:技能根的位置随环境变(全局技能根还是工作区技能根、用户名与盘符各不相同),写死了换台机器就是死路径,跨环境会整片报错。
## 每段的标准收尾格式
@@ -262,4 +263,4 @@ python scripts/check_naming.py --ws <工作区>
脚本输出里的 `[提示]` 项(旧名出现)不计入失败,但要人工看一眼是不是落在「废止理由块」里——落在里面是正当留痕,散落在正文里就是真残留。
2026-10-07 起本技能只在全局一份:`E:/ProgramData/.workbuddy/skills/product-planning/`。它就是本体,不再有「主 / 副 / 装入」三副本,也不再需要「三处 md5 复核」(那只在有副本时才有意义)。改完只跑一次 `check_naming.py --ws <工作区>`。用户原话:「把产品规划复制到 workbuddy 全局skills中 后续维护和使用全局技能」。工作区原先那三份已归档到 `归档/技能迁全局-20261007/`(未直删,可随时取回)。
2026-10-07 起本技能只在全局一份:技能根下的 `product-planning/`。它就是本体,不再有「主 / 副 / 装入」三副本,也不再需要「三处 md5 复核」(那只在有副本时才有意义)。改完只跑一次 `check_naming.py --ws <工作区>`。用户原话:「把产品规划复制到 workbuddy 全局skills中 后续维护和使用全局技能」。工作区原先那三份已归档到 `归档/技能迁全局-20261007/`(未直删,可随时取回)。
@@ -177,7 +177,7 @@ description: 产品规划总入口(唯一入口),四段式调度:① 产
- **不做八股**:不介绍方法论来源,不列人名,不复述框架历史。直接给结论。
- ⭐⭐ **内容准则:一切落盘文字都要先过「说人话」这一关(2026-10-07 用户定案;同日扩大到规则文件)**。用户原话:「**当作第一步 和 第二步 生成文档时 必须遵循的内容准则**」+「**不管是写规则 还是 写文档 都要严格按照说人话的技能去执行**」。
- **适用面(两类都算,⛔ 只改产出不改规则=半改)**:① **产出文档** —— `research/1a-需求文档.md` — `1e-使用场景.md`(5 份)+ `research/1b-独立分析/`(独立分析体)+ `prd/2a-产品功能.md` — `prd/2b-界面布局.md`(2 份);② **规则本身** —— 本技能包内的一切落盘文字:`SKILL.md`、`references/**`、模板与清单。
- **判据来源(单一可信源,本文件不复述模式清单)**:`humanizer`(55 条模式 · 5 种口吻档 casual / professional / technical / warm / blunt)+ `humanizer-zh`(24 条模式 · 快速检查清单 · 50 分制评分)。两份技能都在 `E:/ProgramData/.workbuddy/skills/`;完整判据以源技能正文为准。
- **判据来源(单一可信源,本文件不复述模式清单)**:`humanizer`(55 条模式 · 5 种口吻档 casual / professional / technical / warm / blunt)+ `humanizer-zh`(24 条模式 · 快速检查清单 · 50 分制评分)。两份技能与本技能**同处一个技能根**(`<技能根>/humanizer/`、`<技能根>/humanizer-zh/`);完整判据以源技能正文为准。
- **门槛**:按 `humanizer-zh` 五维评分(直接性 / 节奏 / 信任度 / 真实性 / 精炼度)**≥45 / 50** 才准落盘;低于 45 回炉重写,不给"差不多"放行。
- **五条核心原则**(源技能《核心规则速查》摘引):**删填充短语**(开场白、强调性拐杖词)|**打破公式结构**(二元对比、戏剧性分段、修辞性设置)|**变化节奏**(长短交错,两项优于三项,段尾多样)|**信任读者**(直接陈述事实,跳过软化、辩解、手把手引导)|**删金句**(读起来像可引用的话,就重写它)。
- **交付留证**:产出文档在段末报告里写明"已过内容准则,评分 X/50";改规则文件时,同样要在当日 memory 里记下这一关过了。⛔ 没写等于没做。
@@ -248,7 +248,7 @@ python scripts/check_naming.py
> 例如「②段到底该不该给页面结构」这种反转,**闸门一个字都报不出来**(两版写法都合法)。
> ⇒ **口径类改动要靠人工回读**,且**必须把反转理由与用户原话写进文档留痕**。
⚠️ 脚本输出里的 `[提示]` 项(旧名出现)**不计入失败**,但要人工看一眼是不是落在「废止理由块」里 —— 落在里面是正当留痕,散落在正文里就是真残留。
🔴 **2026-10-07 起本技能只在全局一份**:`E:/ProgramData/.workbuddy/skills/product-planning/` ——
🔴 **2026-10-07 起本技能只在全局一份**:技能根下的 `product-planning/` ——
**它就是本体**,⛔ 不再有「主 / 副 / 装入」三副本,也⛔ 不再需要「三处 md5 复核」
(那只在有副本时才有意义)。改完**只跑一次**:`check_naming.py --ws <工作区>`。
> 用户原话:「**把产品规划复制到 workbuddy 全局skills中 后续维护和使用全局技能**」。
@@ -4,7 +4,7 @@
## 新位置(权威件)
- 技能根:`E:/ProgramData/.workbuddy/skills/video-capture/`
- 技能根:`<技能根>/video-capture/`(技能根=与本技能同级的那个目录,位置随环境变)
- `SKILL.md` —— 触发词、两步用法、抽帧算法铁律、边界
- `scripts/fetch_video.py` —— 取视频(本地文件 / 直链 URL)
- `scripts/extract_frames.py` —— 抽帧(双因素 + 首尾 + 补帧),产 `c_<序号>_<真实秒数>s.jpg` + `frame_times.json`
+2 -2
View File
@@ -390,8 +390,8 @@ def main():
skill_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# 🔴🔴 2026-10-07 技能迁全局后的**必须修正**:
# 旧写法 `ws = os.path.dirname(skill_root)` 是按「技能包在工作区根」写的。
# 技能搬到 `E:/ProgramData/.workbuddy/skills/product-planning/` 之后,
# `ws` 会算成 `E:/ProgramData/.workbuddy/skills` ⇒ **`docs/pm/*` 一个都扫不到**
# 技能从工作区搬到技能根(`<技能根>/product-planning/`)之后,
# `ws` 会算成技能根 ⇒ **`docs/pm/*` 一个都扫不到**
# ⇒ `check_whitelist()` 静默扫零个目录、**恒绿通过**(假绿比报红更危险)。
# ⇒ 工作区一律**显式给**:`--ws <工作区>`;没给就向上找「含 docs/pm 的那一层」,
# 再找不到就**明确报 FAIL**,⛔ 绝不静默跳过。