docs: 修正外部技能依赖段(mcn-dou-analysis废弃D盘两步判定+可执行文件改envs自带venv)+全文件旧路径零残留

This commit is contained in:
maogeigei committed 2026-09-04 00:21:05 +08:00
1 parent 0810446a73
commit 809778a807
1 file changed
+8 -11
+8 -11
View File
@@ -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 入场)