refactor(skill): 主技能 subskill 目录更名 subskills(09-02 用户要求)
- V1.0/subskill/ → V1.0/subskills/(browser-harness/mcn-dou-analysis/mcn-script-review/mcn-video-prompt,git 识别 R100 纯重命名保留历史) - 路径说明同步:V1.0/SKILL.md(96/105行)、Lite1.0/SKILL.md(66行)、mcn-dou-analysis/SKILL.md 红线行、操作规范.md 159/175行、mcn-work-shop app.js SKILL_HINT_ACCOUNT - 用户环境 ~/.workbuddy/skills/短视频脚本创作/ 与源仓库 V1.0 同 inode(junction),自动同步无需单独改 - mcn-dou-analysis 内部 subskills/nuwa-skill-main 为正常结构不受影响
This commit is contained in:
1 parent
dc21faf416
commit
11fe8d42e2
520 files changed
+14
-9
No files matched your search
@@ -0,0 +1,90 @@
|
||||
# references-add/ — 用户部署后新增沉淀地(增量库)
|
||||
|
||||
本目录是用户部署到电脑后,新增的流程、方法、知识库的沉淀地,作为对 `references/`(默认标准库)的补充和扩展。
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
references-add/
|
||||
├── README.md ← 本文件
|
||||
├── 路径配置.md ← 产出路径唯一权威(dsh 环境优先 `D:\dshworkspace\创作任务\`、无主工作区时桌面 DSHSkill项目/;开发机/用户环境 桌面 MCNSkill项目/{账号名}/提示词{编号}/ 账号层直挂,运行时必读)
|
||||
├── 制作流程/ ← 新增/变更的制作流程文件
|
||||
├── 接口调用/ ← 新增的 API 接口文档与平台规范
|
||||
└── 知识库/ ← 新增知识(15 维度,与 references/ 结构对应)
|
||||
├── 01_主体描述/ ← 人/物/场景,含外貌细节与微表情系统
|
||||
├── 02_动作行为/ ← 主体动作、姿势、互动、物理连贯性
|
||||
├── 03_场景描述/ ← 背景、环境、时间、天气、空间锚定
|
||||
├── 04_镜头类型/ ← 景别(特写→远景)+ 四维编码 Z 轴
|
||||
├── 05_运镜方式/ ← 摄像机运动方式与节奏 + 四维编码运动维度
|
||||
├── 06_焦距视角/ ← 镜头焦段、拍摄角度 + 四维编码 Y/X/F 轴 + 焦段心理学
|
||||
├── 07_光线时间/ ← 光源类型、方向、强弱 + 光影三层
|
||||
├── 08_氛围天气/ ← 情绪氛围、天气条件
|
||||
├── 09_色彩后期/ ← 调色、滤镜、电影质感 + 冷暖色调对比系统
|
||||
├── 10_后期细节/ ← 磨皮、锐化、运动模糊、胶片颗粒 + 有机瑕疵
|
||||
├── 11_特效渲染/ ← 光效、散景、粒子、GI/SSS/体积光 + 深度美学约束
|
||||
├── 12_画质分辨率/ ← 输出规格 + 反塑料感宣言
|
||||
├── 13_音效音频/ ← 空间声学、材质拟声、音色控制
|
||||
├── 14_构图布局/ ← 构图法则、版式、画面布局、极简先锋构图
|
||||
└── 15_视觉风格/ ← 导演风格参数化映射 + 艺术流派/渲染风格
|
||||
```
|
||||
|
||||
## 三层引用架构
|
||||
|
||||
| 层级 | 目录 | 定位 | 读写 |
|
||||
|:---:|:---|:---|:---|
|
||||
| 1 | `参考skills/` | 外部参考技能(方法论来源,三大技能) | 只读 |
|
||||
| 2 | `references/` | 默认引用文件地址(出厂自带标准库) | 开发环境可编辑;部署环境只读 |
|
||||
| 3 | `references-add/`(本目录) | 用户部署后新增沉淀地 | 可读写,持续增长 |
|
||||
|
||||
### 部署环境检测
|
||||
|
||||
根据**两步判定模型**判断当前环境(第一步查本机 `D:\AgentSkill` 是否存在;有 → 第二步看技能自身路径):
|
||||
|
||||
| 环境 | 判定条件 | 增量机制 | 新增内容写入位置 |
|
||||
|:---:|:---|:---|:---|
|
||||
| **①开发机** | 本机有 `D:\AgentSkill` 且技能路径在 `D:\AgentSkill\` 下 | 不启用 references-add/ | `references/` 对应子目录 |
|
||||
| **②dsh 部署环境** | 本机有 `D:\AgentSkill` 且技能路径含 `.dsh` | 启用 references-add/(本目录) | `references-add/` 对应子目录 |
|
||||
| **③用户环境** | 本机无 `D:\AgentSkill`(技能无论装在哪、什么路径) | 启用 references-add/(本目录) | `references-add/` 对应子目录 |
|
||||
|
||||
### 冲突检测与修复
|
||||
|
||||
用户在对话过程中新增方法、流程、知识库后:
|
||||
|
||||
1. **比对检测**:将新增内容与 `references/` 中同类内容逐一比对(同名文件、同主题内容)
|
||||
2. **无冲突**:直接写入 `references-add/` 对应子目录
|
||||
3. **有冲突**:以**新增内容为主**(写入 `references-add/`),同时在 `references/` 对应文件中加 ⚠️ 注释标注冲突点及正确规则,不删除或覆盖原始内容
|
||||
|
||||
### 运行时引用优先级
|
||||
|
||||
技能执行时同时加载 `references/` 和 `references-add/`,两者内容冲突**以 references-add/ 为主**:
|
||||
|
||||
```
|
||||
参考skills/(方法论源) → references/(默认标准库) → references-add/(用户增量,冲突时以此为准)
|
||||
```
|
||||
|
||||
> 完整规则详见 `SKILL.md`「动态增量管理」节。
|
||||
|
||||
## 文件命名规则
|
||||
|
||||
| 新增类型 | 归入目录 | 文件命名 | 示例 |
|
||||
|:---|:---|:---|:---|
|
||||
| 制作流程 | `制作流程/` | `{阶段号}_{制作环节}.md` | `3_素材审验标准.md` |
|
||||
| 接口/平台规范 | `接口调用/` | `{接口名称}.md` | `Seedance_平台限制.md` |
|
||||
| 提示词维度知识 | `知识库/{维度}/` | `{日期}_{知识主题}.md` | `20260820_景别选择指南.md` |
|
||||
|
||||
## 通用规则
|
||||
|
||||
- **防重复:** 写入前先搜索 `references/` 和 `references-add/` 中是否存在相似内容
|
||||
- **格式要求:** 每个文件包含知识来源(用户对话)和结构化提炼,非原始对话日志
|
||||
- **维度归档:** 知识库按 15 维度对号入座,非维度类内容归入 `制作流程/` 或 `接口调用/`
|
||||
- **词汇分布:** 各维度词汇表归入对应维度文件夹,不设独立词汇库
|
||||
|
||||
## 运行时加载规则
|
||||
|
||||
**仅非开发机环境生效**(②dsh 部署环境/③用户环境,即本机无 `D:\AgentSkill` 或技能路径含 `.dsh` 时)。同时加载 `references/` 和 `references-add/` 的内容,两者冲突时**以 references-add/ 为主**:
|
||||
|
||||
| 维度 | 加载规则 |
|
||||
|:---|:---|
|
||||
| **制作流程** | 先查 `references/制作流程/`,再查 `references-add/制作流程/`,同名文件以 references-add/ 为主 |
|
||||
| **知识库** | 先搜 `references/知识库/{维度}/`,再搜 `references-add/知识库/{维度}/`,两目录共同参与检索,冲突时以 references-add/ 为主 |
|
||||
| **接口调用** | 先查 `references/接口调用/`,再查 `references-add/接口调用/`,冲突时以 references-add/ 为主 |
|
||||
@@ -0,0 +1,75 @@
|
||||
# 路径配置(运行时优先)
|
||||
|
||||
> 本文件是**产出路径的唯一权威配置**,运行时优先于 `SKILL.md`「文件目录结构 - 过程产物目录」中的默认声明。
|
||||
> 只要本文件存在(含默认配置),AI 执行分镜创作前必须先读本文件;如有「用户自定义路径」记录,一律以用户指定为准。
|
||||
|
||||
## 一、默认路径(用户未自定义时生效)
|
||||
|
||||
**先判定运行环境(两步:第一步查本机 `D:\AgentSkill` 是否存在——无 = 用户环境;有 → 第二步看技能自身路径),再按运行系统解析桌面路径:**
|
||||
|
||||
| 判定步骤 | 条件 | 环境 | 默认产出根目录 |
|
||||
|:---|:---|:---|:---|
|
||||
| 第一步 | 本机**无** `D:\AgentSkill`(源技能仓库目录,只存在于开发机) | ③ 用户环境(技能无论装在哪、什么路径) | 用户桌面 `MCNSkill项目/`(**账号层直挂**:`{账号名}/提示词{编号}/`,与脚本创作「脚本{编号}」同构) |
|
||||
| 第二步 | 本机有 `D:\AgentSkill`,且技能路径在 `D:\AgentSkill\` 下 | ① 开发机(源技能) | 用户桌面 `MCNSkill项目/`(**账号层直挂**:`{账号名}/提示词{编号}/`,与脚本创作「脚本{编号}」同构) |
|
||||
| 第二步 | 本机有 `D:\AgentSkill`,且技能路径含 `.dsh`(如 `C:\Users\{用户名}\.dsh\skills\storyboard-prompt`) | ② dsh 部署环境 | **优先** `D:\dshworkspace\创作任务\`(主工作区「创作任务」目录);主工作区不存在时用用户桌面 `DSHSkill项目/` |
|
||||
|
||||
桌面路径按运行系统自动解析:
|
||||
|
||||
| 系统 | 桌面路径 |
|
||||
|:---|:---|
|
||||
| Windows | `C:\Users\{用户名}\Desktop\` |
|
||||
| macOS | `~/Desktop/`(即 `/Users/{用户名}/Desktop/`) |
|
||||
|
||||
**AI 执行规则:**
|
||||
1. 先按两步判定运行环境——第一步查本机 `D:\AgentSkill` 是否存在(**无 = ③用户环境**,技能无论装在哪、什么路径);有 → 第二步看技能自身路径(**在 `D:\AgentSkill\` 下 = ①开发机**;**含 `.dsh` = ②dsh 环境**)。再按上表确定产出根目录(dsh 环境 → **优先操作** `D:\dshworkspace\创作任务\`,主工作区 `D:\dshworkspace` 存在即用(「创作任务」子目录不存在则创建);主工作区不存在时用桌面 `DSHSkill项目/`;开发机/用户环境 → 桌面 `MCNSkill项目/`,**账号层直挂**(`{账号名}/提示词{编号}/`,与脚本创作同构))
|
||||
2. 再判断当前运行系统(Windows / macOS),拼接桌面路径
|
||||
3. 目录不存在则自动创建
|
||||
4. 产出结构:`{产出根目录}/{账号名}/提示词{编号}/…`(内部文件结构不变,仅根目录可变)
|
||||
5. **账号名判定**:取当前创作所属账号——从上游脚本创作上下文(人设卡片/账号名)继承;独立使用且上下文无账号信息时,询问用户确认账号名后再建目录
|
||||
6. **提示词编号判定**:默认从上游脚本编号继承(脚本01 → 提示词01,一一对应);独立使用(无上游脚本)时,按账号目录下已有「提示词{编号}」最大值递增
|
||||
|
||||
**产出结构示例(6步流程产物):**
|
||||
|
||||
```
|
||||
D:\dshworkspace\创作任务\ ← dsh 环境优先根目录(主工作区「创作任务」,与脚本创作同根;无主工作区时兜底桌面 DSHSkill项目/)
|
||||
└── {账号名}/ ← 对应账号(从上游脚本创作上下文继承,与脚本创作同口径)
|
||||
└── 提示词{编号}/ ← 与「脚本{编号}」平级(编号默认继承上游脚本编号;开发机/用户环境为 桌面 MCNSkill项目/{账号名}/提示词{编号}/,账号层直挂)
|
||||
├── 00_剧本分析.md ← Step 1 剧本分析(5维度)
|
||||
├── 01_需求分析与路径.md ← Step 2-3
|
||||
├── 02_段1提示词.md ← Step 4(多段时 02/03/04… 递增)
|
||||
├── …
|
||||
└── 分镜提示词_终版.md ← 最终交付物(命名可带模板版本,如 _11字段版)
|
||||
```
|
||||
|
||||
## 二、用户自定义路径(最高优先级)
|
||||
|
||||
**如果用户明确要求修改产出位置,一律以用户指定为准,不要沿用默认桌面路径,也不要自作主张改回桌面。**
|
||||
|
||||
出现自定义需求时,在此追加记录(保留用户原话,便于追溯):
|
||||
|
||||
```
|
||||
> 用户指定:{用户原话}
|
||||
> 解析后路径:{绝对路径}
|
||||
> 记录时间:{日期}
|
||||
```
|
||||
|
||||
记录后,AI 每次执行分镜创作都以「解析后路径」为产出根目录;用户再次修改时直接更新本记录即可(旧记录保留,标注新记录生效)。
|
||||
|
||||
## 三、解析规则(优先级从高到低)
|
||||
|
||||
1. 本文件「用户自定义路径」记录 → 用自定义路径(最新一条生效)
|
||||
2. 本文件默认路径 → 先按两步判定运行环境(第一步查本机 `D:\AgentSkill` 是否存在:无 = ③用户环境;有 → 第二步看技能路径:在 `D:\AgentSkill\` 下 = ①开发机、含 `.dsh` = ②dsh 环境),再按上表确定产出根目录(dsh 环境 → 优先 `D:\dshworkspace\创作任务\`、主工作区不存在时用桌面 `DSHSkill项目/`;开发机/用户环境 → 桌面 `MCNSkill项目/`,**账号层直挂** `{账号名}/提示词{编号}/`),再按系统拼接桌面路径
|
||||
3. 路径含 `~` 时自动展开为用户主目录
|
||||
4. 路径含 `{用户名}` 时替换为当前系统用户名
|
||||
5. 目录不存在时自动创建
|
||||
|
||||
## 变更记录
|
||||
|
||||
- 2026-08-20:初始创建。默认路径由技能目录内 `output/` 改为用户桌面 `分镜提示词/`(用户指定:"改为默认保存到用户 桌面 分镜提示词 文件夹")。
|
||||
- 2026-08-26:新增运行环境判断——技能不在 `.dsh` 路径下(本地/源技能环境)时,默认产出根目录改为用户桌面 `MCNSkill输出/`;dsh 部署环境维持桌面 `分镜提示词/` 不变(用户指定:"技能的输出不在dsh路径下时,默认放在桌面 MCNSkill输出 中")。
|
||||
- 2026-08-26(修订):非 dsh 环境默认产出根目录由桌面 `MCNSkill输出/` 调整为桌面 `MCNSkill项目/分镜提示词/`——统一项目文件夹中的本技能对应文件夹(用户指定:"改为默认放在 桌面 MCNSkill项目 中对应文件夹中")。
|
||||
- 2026-08-26(再修订):产出结构新增账号层——`{产出根目录}/{账号名}/{视频标题}/`,与脚本创作技能按账号归档同口径;dsh 与非 dsh 环境均在对应文件夹下按账号建子目录(用户指定:"分镜提示词 也应该放在对应账号下")。
|
||||
- 2026-08-26(第三次修订):dsh 部署环境默认产出根目录由桌面 `分镜提示词/` 改为桌面 `DSHSkill项目/`(用户指定:"在 dsh环境下 生成的文件放到 桌面DSHSkill项目 文件夹下"),账号层结构不变:`DSHSkill项目/{账号名}/{视频标题}/`。
|
||||
- 2026-08-26(第四次修订,与脚本创作两级规则对齐):dsh 部署环境改为**优先操作** `D:\dshworkspace\创作任务\`(主工作区「创作任务」目录,与脚本创作技能同根;用户指定:"dsh 环境下 分镜提示词也应该在 工作区 D:\dshworkspace\创作任务\{账号名}\提示词{编号}");主工作区不存在时兜底桌面 `DSHSkill项目/`。产出结构由 `{账号名}/{视频标题}/` 改为 `{账号名}/提示词{编号}/`——与脚本创作「脚本{编号}」平级,编号默认继承上游脚本编号,独立使用时按已有最大值递增。
|
||||
- 2026-08-26(第五次修订,环境判定模型修正):判定锚点由「技能路径是否含 `.dsh`」单一判断改为**两步判定**——第一步查本机 `D:\AgentSkill` 是否存在(**无 = ③用户环境**,技能无论装在哪、什么路径);有 → 第二步看技能路径(**在 `D:\AgentSkill\` 下 = ①开发机**;**含 `.dsh` = ②dsh 环境**)。修复用户环境技能装在非 `.dsh` 路径(如 `~/.workbuddy/skills/`)时被误判为开发机、可能错误直接编辑 `references/` 的漏洞(用户指定:用户环境判定锚点是「本机没有 D:\AgentSkill」,与技能装在什么路径无关)。
|
||||
- 2026-08-26(第六次修订,产出结构定稿):①开发机与③用户环境产出根目录由 `桌面 MCNSkill项目/分镜提示词/` 改为 `桌面 MCNSkill项目/`(**账号层直挂**:`{账号名}/提示词{编号}/`,去掉「分镜提示词」技能文件夹层,与脚本创作「脚本{编号}」同构;用户指定:"定稿产出结构:桌面\MCNSkill项目\{账号名}\{脚本文件夹}\(①开发机与③用户环境同构,账号层直挂);② dsh 部署环境不变 D:\dshworkspace\创作任务\{账号名}\脚本{编号}\")。dsh 环境产出不变。
|
||||
Reference in new issue
Block a user