From 809778a807e42a1a546615caf8782243a15e8d5b Mon Sep 17 00:00:00 2001 From: maogeigei Date: Fri, 4 Sep 2026 00:21:05 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=E5=A4=96=E9=83=A8?= =?UTF-8?q?=E6=8A=80=E8=83=BD=E4=BE=9D=E8=B5=96=E6=AE=B5(mcn-dou-analysis?= =?UTF-8?q?=E5=BA=9F=E5=BC=83D=E7=9B=98=E4=B8=A4=E6=AD=A5=E5=88=A4?= =?UTF-8?q?=E5=AE=9A+=E5=8F=AF=E6=89=A7=E8=A1=8C=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E6=94=B9envs=E8=87=AA=E5=B8=A6venv)+=E5=85=A8=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E6=97=A7=E8=B7=AF=E5=BE=84=E9=9B=B6=E6=AE=8B=E7=95=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- project/短视频脚本创作/V1.0/SKILL.md | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/project/短视频脚本创作/V1.0/SKILL.md b/project/短视频脚本创作/V1.0/SKILL.md index bbee505..aa44d36 100644 --- a/project/短视频脚本创作/V1.0/SKILL.md +++ b/project/短视频脚本创作/V1.0/SKILL.md @@ -9,7 +9,7 @@ description: > 诊断脚本质量、设计账号人设、选题策划、生成分镜、广告植入设计、生成创作回顾。 version: "1.0" updated_at: "2026-09-04" -last_change: "新增「子技能索引（subskills/）」章节（09-04）：subskills 下 6 个子技能全部登记入主 SKILL.md（browser-harness/lieflat-charts/mcn-data-insight/mcn-dou-analysis/mcn-script-review/mcn-video-prompt），引用一律用相对路径 subskills/<目录>/SKILL.md；目录树补 subskills/ 行；技能更名：短视频脚本创作→短视频工作台（09-03 用户定，对外统一名称；触发方式与引用结构不变）；触发条件新增🧹后台任务清理场景：用户问后台任务/清理过期失败任务时按 references/接口调用/自动化任务清理规范.md 执行（09-03 新增，全环境通用：只清过期或错误失败的一次性任务，禁清未来/周期/运行中任务，删除走宿主工具禁直改库）；09-02 前：工作台新增第7条「AI 任务入口技能契约(P0)」：所有 AI 会话任务入口须遵守功能入口×技能调用契约（prompt=技能前缀常量+业务正文+skills 参数级挂载），新增/修改入口前先读 mcn-work-shop/docs/AI会话任务输入输出对照.md（含新增入口检查清单7项）——防裸 prompt 跳步/技能声明混入业务串/BROWSER_HINT 误注入（09-02 提炼/分镜/复盘三入口缺约束修复后固化，data-pages.js 四前缀常量）；原第7/8条顺延为8/9；09-02 前：工作台任务执行方式铁律固化（创作/改写/复盘必须走 POST /api/run+skills 参数，禁会话内手写草稿）+09-01 调度机制实测定稿+端口 8899→8900" +last_change: "新增「子技能索引（subskills/）」章节（09-04）：subskills 下 6 个子技能全部登记入主 SKILL.md（browser-harness/lieflat-charts/mcn-data-insight/mcn-dou-analysis/mcn-script-review/mcn-video-prompt），引用一律用相对路径 subskills/<目录>/SKILL.md；目录树补 subskills/ 行；修正外部技能依赖段落（09-04）：mcn-dou-analysis 原「D:\AgentSkill 两步判定」规则废弃（独立仓库不存在，改 subskills/ + dsh 平级 ~/.dsh/skills 双描述）；browser-harness 可执行文件改技能自带 venv 相对路径（原 uv 工具安装已废弃）、lieflat-charts 路径改相对；全文件旧绝对路径引用零残留；技能更名：短视频脚本创作→短视频工作台（09-03 用户定，对外统一名称；触发方式与引用结构不变）；触发条件新增🧹后台任务清理场景：用户问后台任务/清理过期失败任务时按 references/接口调用/自动化任务清理规范.md 执行（09-03 新增，全环境通用：只清过期或错误失败的一次性任务，禁清未来/周期/运行中任务，删除走宿主工具禁直改库）；09-02 前：工作台新增第7条「AI 任务入口技能契约(P0)」：所有 AI 会话任务入口须遵守功能入口×技能调用契约（prompt=技能前缀常量+业务正文+skills 参数级挂载），新增/修改入口前先读 mcn-work-shop/docs/AI会话任务输入输出对照.md（含新增入口检查清单7项）——防裸 prompt 跳步/技能声明混入业务串/BROWSER_HINT 误注入（09-02 提炼/分镜/复盘三入口缺约束修复后固化，data-pages.js 四前缀常量）；原第7/8条顺延为8/9；09-02 前：工作台任务执行方式铁律固化（创作/改写/复盘必须走 POST /api/run+skills 参数，禁会话内手写草稿）+09-01 调度机制实测定稿+端口 8899→8900" deployment: "source" agent_created: true --- @@ -110,29 +110,26 @@ agent_created: true ## 外部技能依赖：账号解析（mcn-dou-analysis） -账号解析功能（达人账号信息获取与登记、视频列表抓取、爆款视频拆解分析、人设卡生成、账号数据分析）由独立技能 **mcn-dou-analysis** 提供，按三环境两步判定解析路径： +账号解析功能（达人账号信息获取与登记、视频列表抓取、爆款视频拆解分析、人设卡生成、账号数据分析）由独立技能 **mcn-dou-analysis** 提供（09-04 修正：原「D:\AgentSkill 两步判定」规则已废弃——独立仓库不存在，该技能 09-02 起挂在本技能 subskills/ 下随源仓库分发）： -- **第一步：查本机是否存在 `D:\AgentSkill`** - - **不存在 → 用户环境**（技能装在用户机器上，路径不限、不一定含 `.dsh`）→ 在本技能 `subskills/` 目录中寻找 `mcn-dou-analysis` - - **存在 → 第二步：看本技能自身路径** - - 不含 `.dsh`（源技能在 `D:\AgentSkill` 下）→ **开发机** → 使用 `D:\AgentSkill\mcn-dou-analysis` - - 含 `.dsh`（如 `C:\Users\{用户名}\.dsh\skills\…`）→ **dsh 部署环境** → 使用 `D:\AgentSkill\mcn-dou-analysis` +- **技能本体**：`subskills/mcn-dou-analysis/`（相对本文件；WorkBuddy 用户技能经软链自动同步） +- **dsh 部署环境**：`~/.dsh/skills/mcn-dou-analysis/`（dsh 部署为平级独立技能目录，随 dsh_MCNProject 仓库分发） ## 外部技能依赖：浏览器工具（browser-harness） 浏览器操作（账号搜索、视频列表抓取等）统一使用 **browser-harness**（2026-09-02 起挂在本技能下，不再挂在 mcn-dou-analysis 下）： -- **技能本体**：`project/短视频脚本创作/V1.0/subskills/browser-harness/`（含 `envs/browser-harness/` 环境与 `src/`，随源仓库分发） +- **技能本体**：`subskills/browser-harness/`（相对本文件；含 `envs/browser-harness/` 自带环境与 `src/` 源码，随源仓库分发） - **dsh 部署环境**：`~/.dsh/skills/browser-harness/`（随 dsh_MCNProject 仓库分发，换机器自带） -- **可执行文件**：uv 工具安装，`~/.local/bin/browser-harness.exe`（Windows）/ `~/.local/bin/browser-harness`（macOS/Linux） +- **可执行文件**：`subskills/browser-harness/envs/browser-harness/Scripts/browser-harness.exe`（Windows；macOS/Linux 为 `envs/browser-harness/bin/browser-harness`）——**技能自带 venv**（09-04 修复重建，含 python.exe/pyvenv.cfg/全部依赖），随源仓库分发、无需 PATH/uv 工具安装；原「uv 工具安装 ~/.local/bin/browser-harness.exe」已废弃（uv 工具残留 09-04 已清理） - **进程生命周期（红线，09-02 用户明确）**：已开启的 Chrome（9223 调试实例/用户手动开启的 Chrome）一律不主动关闭，除非用户明确要求；任务结束/失败都保留，承载登录态与标签页复用 -- 调用前必做环境检查（三要素：工具/daemon/Chrome），详见 mcn-dou-analysis `references/浏览器搜索抖音账号操作规范.md` +- 调用前必做环境检查（三要素：工具/daemon/Chrome），详见 `subskills/mcn-dou-analysis/references/浏览器搜索抖音账号操作规范.md` ## 外部技能依赖：图表生成（lieflat-charts，09-02 引入） 工作台/数据页需要生成图表时，使用 **lieflat-charts**（第三方 Agent 图表技能，PolyForm Noncommercial 许可）： -- **技能本体**：`project/短视频脚本创作/V1.0/subskills/lieflat-charts/`（含 SKILL.md + catalog.md + templates/ 各 gallery，随源仓库分发） +- **技能本体**：`subskills/lieflat-charts/`（相对本文件；含 SKILL.md + catalog.md + templates/ 各 gallery，随源仓库分发） - **选型规则**：先读 `catalog.md` 按数据形状锁定图型编号，再打开 `templates/` 对应 gallery 的真实实现复制骨架；默认顺序 Lupi Editorial → Lupi Basics → Glance（工作台场景数据量小/需快读时可直用 Glance） - **视觉 token**：`mono-tokens.js`（纸 #F0EFEB / 墨 #1C1C1A / 灰 #8F8E88 / 网格 #DEDDD6），同一交付只锁一种色系 - **ECharts 依赖**：已本地化至工作台 `mcn-work-shop/public/vendor/echarts.min.js`（零 CDN 依赖，离线可用）；引用样例见工作台账号详情页视频列表上方「点赞/评论趋势折线图」（G8 Rainfall 骨架：双 grid、双序列随时间、tipLight tooltip、quarticOut 入场）