技能库同步：另一台机的 2026-10-16 包＋ element-picker 入包＋工具归拢到技能级 assets/

product-planning（同步 26 改 65 新） - 目录约定：docs/pm/<项目>/ ⇒ <工作区>/项目/<产品slug>/ 为产品根，下分产品规划/ 与产品原型/{designs,pages} - ④段骨架六节 ⇒ 七节（新增「原型地址」；后两节改「页面导航」「原型状态取值」） - ③段新增真机组件库；结案「源站只有暗色主题」，tokens.css（亮色）标为不可用于生产 - ③段改版规则反转为「一个产品只用一套原型、只留当前态」；②段新增产品规划模板.md（表头唯一定义处） - scripts：产品根定位重写（含 .registry/current-project 指针），新增 check_terms.py 与 selftest_product_root.py session-mechanism（同步 3 改 2 新） - references/06-技能优化规程.md 新增 §5「要求落在生成时看得见的面上」，总表 16 ⇒ 17 条；SKILL.md 同步 - scripts/collabctl.py 取回 _find_board() 候选定位（旧版写死 scripts/board.py，而看板已搬进 boards/会话看板/ ⇒ 旧版本就是坏的） element-picker（新装） - 按用户口径作「独立功能加入 product-planning」，非独立全局技能 - 修掉它自身三处路径漂移（技能根写法 ⇒ 同目录；README 两处旧落点；剪贴板示例文案与代码对齐）工具归拢到技能级 assets/ - diagram-design / design-capture / element-picker / video-capture 从各段 assets/ 移到技能包 assets/ - 新增红线：本包有两处 assets/（技能级工具箱 vs 段内资产），引工具一律写「技能级 assets/<工具名>/」 - 路径口径由两类改三类（技能级工具箱 / 本段自带资产 / 同根技能）不入库（磁盘保留） - design-system-tiaoyue 整个目录（用户 2026-10-16 令）：git rm -r --cached ＋ .gitignore，理由＝14 MB 且可 CDP 重采；已在 ③段 SKILL.md 注明「取仓后这一层是空的属正常，用自带套需另取或重采」 - element-picker 的运行期存档 marks/（服务自己会建目录）
2026-10-16 23:13:33 +08:00
1 parent 749c0e3d5d
commit 8160f91559
@@ -481,7 +481,7 @@ python .workbuddy/collab/collabd.py --set-life 进行中 --by "主会话"
 　· **D 表述层**（简洁·高效·实用·无歧义）—— #14 肯定表述（正本 ⇒ `references/rules.md §9`）#15 说人话 #16 一页纸。
 　🔴 **优先级**：B 结构 ＞ C 流程 ＞ D 表述 —— 前两层出毛病**机制失效或断链**，表述只是**效果差**。
 　🔴 **目标（用户 2026-10-15 原话）**：让技能描述**结构清晰·重点突出·简洁·高效·实用·无歧义·流程顺畅·功能正常·规则边界清晰·无冲突**。
-　🔴 **文末附「技能优化描述 · 总表」16 条三层**；**验法按层不同**：B ⇒ 同源比对 md5／C ⇒ 画数据流看断点／D ⇒ 人读（⛔ 别假装它有自动结论）。
+　🔴 **文末附「技能优化描述 · 总表」17 条三层**；**验法按层不同**：B ⇒ 同源比对 md5／C ⇒ 画数据流看断点／D ⇒ 人读（⛔ 别假装它有自动结论）。

 ---

@@ -40,6 +40,13 @@
 **4 正文不自相矛盾**
 同一件事在技能里出现两种写法（尤其"正文"与"规则段"之间）⇒ 逐条对，留一处。

+**5 要求落在生成时看得见的面上**
+凡**要求类内容**（术语／版式／判据／字段口径），落点要放在**生成那一刻就读得到**的面上 ——
+**每轮注入面** ／ **落笔时的判据** ／ **模板占位**，三处至少占一处。
+判据：**这条要求，落笔那一刻读得到吗** —— 读不到 ⇒ 换成读得到的那个面。
+⚠️ 只写进 `references/` 等着回头查 ⇒ 等于没立；机核脚本只作**兜底**，⛔ 不当主手段。
+（用户 2026-10-16 令：「要生成的时候 就按照要求，不是事后再修复」。）
+
 ### C 流程层（→ 流程顺畅 · 功能正常）

 > 来路：2026-08-10 另一工作区对创作流程做全量审计归纳的 13 项里，9 项属这一层；
@@ -79,10 +86,10 @@

 ---

-## 技能优化描述 · 总表（16 条，三层）
+## 技能优化描述 · 总表（17 条，三层）

 > **怎么来的**：① B／C／D 三层判据（＝本规程正文）；② 另一工作区的 `技能审计检查清单.md`（`E:/ProgramData/AIProject/mcn-short-video/技能审计检查清单.md`，2026-08-10 创作流程全量审计的 13 项；跨根引用，仅作来路说明）。
-> **用法**：按 **1 → 16** 逐条过。**分级**：**P0 ＝ 会让人出事或断链**（#13 产物链）／**P1 ＝ 不一致或冗余**（B 层 ＋ C 层其余）／**P2 ＝ 效果差**（D 层）。
+> **用法**：按 **1 → 17** 逐条过。**分级**：**P0 ＝ 会让人出事或断链**（#13 产物链）／**P1 ＝ 不一致或冗余**（B 层 ＋ C 层其余）／**P2 ＝ 效果差**（D 层）。
 > 🔴 **判据正本 ＝ 本规程正文的对应项**，表里只给锚点与反例；⛔ **本表只收通用要求** —— `env/` 怎么放、
 > 路径怎么写、什么不入仓这类**专有配置规则不在本表**，见 `01-文档索引.md` 的「技能环境配置规范」。

@@ -104,3 +111,4 @@
 | 14 | D 表述 | 肯定表述 | 见 §D #14 | 描述里写「不用于海报」⇒ 匹配面反而把"海报"拉高 |
 | 15 | D 表述 | 说人话 | 见 §D #15 | 四种 AI 味：三段式排比连用／"…着"结尾的肤浅分析／模糊归因／拆成加粗小标题＋竖排碎句 |
 | 16 | D 表述 | 一页纸 | 见 §D #16 | 一份 300 行的"速查" |
+| 17 | B 结构 | 要求落在生成时看得见的面上 | 见 §B #5 | 只写进 `references/` 等着回头查 ⇒ 等于没立 |
@@ -0,0 +1,106 @@
+# 06 · 技能优化规程
+
+> **什么时候用**（本规程**只收通用要求** —— 描述、结构、流程怎么写、怎么组织；**技能环境配置目录的专属规则不在本规程**）：用户说
+> 「**优化技能**」「**技能怎么改更好**」「**梳理技能**」「**梳理一下技能的要求和描述**」「**技能太长**」
+> 「**这条规则写在哪**」「**这个技能能不能拷到别的机器用**」—— 任一句即触发；点名某一层 ⇒ 只跑那一层。
+> **一句话判据**：**写技能时，假设读者是"另一台机器上的另一个会话"。**
+> 📌 姊妹篇：**盘点技能库**（有哪些技能、在用没用、该不该入仓）⇒ `references/05-技能库盘点规程.md`。
+
+## 本规程管什么（用户 2026-10-15 原话 ＋ 判据来源）
+
+> 技能优化是为了让技能相关描述 —— **结构清晰 · 重点突出 · 描述简洁 · 高效 · 实用 · 无歧义 ·
+> 流程顺畅 · 功能正常 · 规则边界清晰 · 无冲突**。
+
+这十项就是 B／C／D 三层的靶子。🔴 **本规程只收通用要求**：`env/` 怎么放、路径怎么写、什么不入仓
+这类**某个技能包专有的配置规则**，归 `01-文档索引.md` 的「技能环境配置规范」一行所指的那份规范。
+判据来源：近 10 天「技能怎么改」被反复提过，表面是六件不相关的事，**根因是同一个** —— 技能是「跨机器、跨会话共享的文本」，作者却按「本机、本会话」的假设写它。
+⚠️ **拿"另一台机器 ＋ 另一个会话"回放一遍，毛病自己就浮出来**。
+
+---
+
+## 三层（🔴 就按 B → C → D 这个顺序做）
+
+优先级：**B 结构 > C 流程 > D 表述** —— 结构与流程出毛病会让**机制失效或断链**（别人照它做会做错事）；
+表述出毛病**只是效果差**。
+
+### B 结构层（→ 结构清晰 · 重点突出 · 规则边界清晰 · 无冲突）
+
+**1 单一真源**
+同一件事**只留一处定义**，其余位置写指针。判据：**改它的时候，我需不需要改第二个地方** —— 需要 ⇒ 那是两处真源。
+
+**2 注入面与真源同源**
+每轮注入的那份与包内那份**逐字一致**（防漂移判据：`scripts/selftest.py::t_reply_core_same_source`）。
+🔴 配套：**凡"每轮注入 / 有长度上限"的面，改文字必须量长度** ——"改完自测全绿"不等于"改的内容真进了上下文"。
+⚠️ 同源判据自己也要做**变异对照**（改一处应报红、复原应回绿）—— 判据只认一种文本形态就会**恒绿**。
+
+**3 命名一致**
+同一概念在全包用同一个叫法；改名前先列**伴随物清单**（只改主体必留隐患）。
+📌 术语正式名与旧称映射的**唯一天条真源** ⇒ `references/architecture.md §7 术语`（⛔ 别另抄一张表）。
+
+**4 正文不自相矛盾**
+同一件事在技能里出现两种写法（尤其"正文"与"规则段"之间）⇒ 逐条对，留一处。
+
+### C 流程层（→ 流程顺畅 · 功能正常）
+
+> 来路：2026-08-10 另一工作区对创作流程做全量审计归纳的 13 项里，9 项属这一层；
+> **多步流水线型技能**（如 `product-planning` 的四段）逐条对着查，单文件技能跳过本层。
+
+**5 步骤顺序正确** —— 全流程步骤顺序无错乱（反例：步骤排反）
+**6 编号连续** —— 步骤内部编号不跳号（反例：第一步 → 第三步，缺第二步）
+**7 无跳步** —— 不跳过中间步骤（反例：产物链 5→6→7 跳了一步）
+**8 步骤间职责不越界** —— 各步骤各管一段（反例：后一棒把前一棒的场次表＋情绪卡全塞进去）
+**9 字段归属正确** —— 字段由哪个步骤产出就标哪个（反例：情绪设计卡标成后一棒，实际是前一棒）
+**10 上下游不断裂** —— 上游输出的字段，下游输入列表要引用（反例：「目标体感」字段后两棒都没引用）
+**11 引用路径正确** —— 引用走对层级（流程 → 知识库 → 素材库）
+**12 字段不缺失** —— 每步的输入列表字段完整（反例：某步输入缺「框架方案」）
+**13 产物链完整** —— 中间产物必须落盘；**P0：只出最终产物 ＝ 断链**
+
+### D 表述层（→ 描述简洁 · 高效 · 实用 · 无歧义）
+
+**14 肯定表述**
+写「要什么、怎么做」。⛔ 不写「不要 A／B／C」—— 负向词进匹配面/注入面，**反而把 X 拉高命中**。
+例外：**以「经验沉淀」或「红线／避坑」为目的**的文档可以写负向，写法＝**正向目标 ＋ 括号里的踩坑依据**。
+⚠️ 两条边界：「配置里不含本工作区」是**描述事实**；「三禁」这类**硬禁令**是约束本体，强度要留住。
+（正本 ⇒ `references/rules.md §9`）
+
+**15 说人话**
+落盘文字先过"像不像人写的"这一关（禁四种 AI 味：三段式排比连用 / "…着"结尾的肤浅分析 / 模糊归因 / 拆成加粗小标题 ＋ 竖排碎句）。
+
+**16 一页纸**
+单份产出默认 ≤120 行，超长就拆。
+
+---
+
+## 怎么验（验法按层不同，⛔ 别拿一种套三层）
+
+- **B 结构层** ⇒ 同源比对 / md5 / 判据（有机器可查的部分）。
+- **C 流程层** ⇒ 画数据流，看断点与跳号。
+- **D 表述层** ⇒ 人读；⛔ 这层**验不出自动结论**，别假装它通过了。
+
+---
+
+## 技能优化描述 · 总表（16 条，三层）
+
+> **怎么来的**：① B／C／D 三层判据（＝本规程正文）；② 另一工作区的 `技能审计检查清单.md`（`E:/ProgramData/AIProject/mcn-short-video/技能审计检查清单.md`，2026-08-10 创作流程全量审计的 13 项；跨根引用，仅作来路说明）。
+> **用法**：按 **1 → 16** 逐条过。**分级**：**P0 ＝ 会让人出事或断链**（#13 产物链）／**P1 ＝ 不一致或冗余**（B 层 ＋ C 层其余）／**P2 ＝ 效果差**（D 层）。
+> 🔴 **判据正本 ＝ 本规程正文的对应项**，表里只给锚点与反例；⛔ **本表只收通用要求** —— `env/` 怎么放、
+> 路径怎么写、什么不入仓这类**专有配置规则不在本表**，见 `01-文档索引.md` 的「技能环境配置规范」。
+
+| # | 层 | 检查点 | 判据 | 典型反例（实测过的） |
+|---|---|---|---|---|
+| 1 | B 结构 | 单一真源 | 见 §B #1 | 同一条判据散在 6 处，改一处漏一处 |
+| 2 | B 结构 | 注入面与真源同源 | 见 §B #2 | 加条文顶破上限 ⇒ 尾部规则静默消失，下游只看到"已截断" |
+| 3 | B 结构 | 命名一致 | 见 §B #3 | 「任务会话 31 处 / 执行会话 29 处」混用 |
+| 4 | B 结构 | 正文不自相矛盾 | 见 §B #4 | 技能正文缺起实例命令、与另一处说法冲突 |
+| 5 | C 流程 | 步骤顺序正确 | 见 §C #5 | 步骤排反 |
+| 6 | C 流程 | 编号连续 | 见 §C #6 | 第一步→第三步缺第二步 |
+| 7 | C 流程 | 无跳步 | 见 §C #7 | 产物链 5→6→7 跳了一步 |
+| 8 | C 流程 | 步骤间职责不越界 | 见 §C #8 | 后一棒把前一棒的场次表＋情绪卡全塞进去 |
+| 9 | C 流程 | 字段归属正确 | 见 §C #9 | 情绪设计卡标成后一棒，实际是前一棒 |
+| 10 | C 流程 | 上下游不断裂 | 见 §C #10 | 「目标体感」字段后两棒都没引用 |
+| 11 | C 流程 | 引用路径正确 | 见 §C #11 | 素材库误走直接路径，应走知识库间接引用 |
+| 12 | C 流程 | 字段不缺失 | 见 §C #12 | 某步输入缺「框架方案」 |
+| 13 | C 流程 | 产物链完整 | 见 §C #13（**P0**） | 只在对话里输出、没落盘 |
+| 14 | D 表述 | 肯定表述 | 见 §D #14 | 描述里写「不用于海报」⇒ 匹配面反而把"海报"拉高 |
+| 15 | D 表述 | 说人话 | 见 §D #15 | 四种 AI 味：三段式排比连用／"…着"结尾的肤浅分析／模糊归因／拆成加粗小标题＋竖排碎句 |
+| 16 | D 表述 | 一页纸 | 见 §D #16 | 一份 300 行的"速查" |
@@ -132,7 +132,23 @@ AIROOT = _resolve_airoot()
 WORKSPACES = _discover_workspaces(AIROOT)

 # 看板：全局只一条（⛔ 不是每区一条）；**技能包内相对定位** ⇒ 换机器不用改。
-BOARD_PY = os.path.join(os.path.dirname(os.path.abspath(__file__)), "board.py")
+# 🔴 2026-10-14 修：看板已从 `scripts/` 搬进 `boards/会话看板/` ⇒ 改为**候选表定位**，
+#   搬家或改名都不用再来改这里（与 board.py 自身的查找方式同口径）。
+def _find_board() -> str:
+    here = os.path.dirname(os.path.abspath(__file__))
+    pkg = os.path.dirname(here)
+    cands = (
+        os.path.join(pkg, "boards", "会话看板", "board.py"),
+        os.path.join(pkg, "boards", "board.py"),
+        os.path.join(here, "board.py"),
+    )
+    for c in cands:
+        if os.path.isfile(c):
+            return c
+    return cands[0]
+
+
+BOARD_PY = _find_board()
 BOARD_PORT = 20099

 # 🔴🔴 2026-10-05 改（用户定案：「**常驻崩了，拉起来这个事儿，你不能也用计划任务起个程序吗？**」）：