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,70 @@
|
||||
# references-add(增量库)—— 机制说明
|
||||
|
||||
> **三环境判定(两步判定,与 SKILL.md 一致)**:第一步查本机是否存在 `D:\AgentSkill`——**无 = ③ 用户环境**(技能无论装在哪、什么路径);有 → 第二步看技能路径——**在 `D:\AgentSkill\` 下 = ① 开发机(源技能)**、**含 `.dsh` = ② dsh 部署环境**(如 `{主目录}/.dsh/skills/`)。
|
||||
>
|
||||
> **references-add 机制只服务 ③ 用户环境**:① 开发机 / ② dsh 环境标准库 `references/` 可正常修改(新增内容直接并入标准库对应位置),本目录可仅保留本说明(机制文档);③ 用户环境部署后标准库 `references/` **永远不变**,新增/修改内容统一写入本目录。
|
||||
|
||||
## 用途
|
||||
|
||||
当本技能(MCNDouAnalysis)被部署到**③ 用户环境**(本机没有 `D:\AgentSkill`)时,本技能的标准库 `references/`(含自有知识库 `知识库/账号设定/` + `知识库/视频拆解/`)在部署后**永远不变**。用户在使用过程中新增/修改的流程、方法论、分析方式、铁律等内容,统一整理到本文件夹。
|
||||
|
||||
## 核心原则
|
||||
|
||||
| 目录 | 定位 | 内容来源 | 修改策略 |
|
||||
|:---:|------|------|------|
|
||||
| `references/` | 原始标准库(内置) | 开发时固化(含从源技能按两步法重组的账号设定知识库 + 视频拆解知识库) | **部署后永远不变** |
|
||||
| `references-add/` | 动态增量库 | ③ 用户环境中用户对话中积累 | 随使用持续增长 |
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
references-add/ ← 增量库(与标准库 references/ 结构镜像对齐)
|
||||
├── README.md ← 本说明(机制文档)
|
||||
├── 路径配置.md ← 🔴 产出路径唯一权威配置(用户自定义路径在此记录)
|
||||
├── feature/ ← 功能级增量(对应标准库 references/feature/,删除即禁用该功能)
|
||||
│ ├── 01_获取账号信息.md ← 功能一增量
|
||||
│ ├── 02_获取视频.md ← 功能二增量
|
||||
│ ├── 03_提炼账号设定.md ← 功能三增量
|
||||
│ └── 04_分析视频数据.md ← 功能四增量
|
||||
├── 知识库/ ← 方法论增量(对应标准库 references/知识库/,含「账号设定」「视频拆解」两个分类)
|
||||
│ ├── 账号设定/ ← 生成设定(功能三)方法论增量
|
||||
│ └── 视频拆解/ ← 账号数据分析(功能四)拆解知识库增量
|
||||
└── 铁律避坑规则/ ← 铁律和避坑(含 账号数据分析执行避坑.md)
|
||||
```
|
||||
|
||||
## 四大功能对应关系
|
||||
|
||||
| 功能 | 标准库(references/) | 增量库(references-add/) |
|
||||
|------|------|------|
|
||||
| 1. 获取账号信息 | `references/feature/01_获取账号信息.md` + `浏览器搜索抖音账号操作规范.md` | `feature/01_获取账号信息.md` |
|
||||
| 2. 获取视频列表 | `references/feature/02_获取视频.md` + `浏览器搜索抖音账号操作规范.md` | `feature/02_获取视频.md` |
|
||||
| 3. 提炼账号设定 | `references/feature/03_提炼账号设定.md` + `人设卡生成方法.md` + `知识库/账号设定/` + `解析结果格式规范.md`(功能四仍启用时需保留) | `feature/03_提炼账号设定.md` + `知识库/账号设定/` |
|
||||
| 4. 分析视频数据 | `references/feature/04_分析视频数据.md` + `账号数据分析方法.md` + `知识库/视频拆解/` | `feature/04_分析视频数据.md` + `知识库/视频拆解/` |
|
||||
|
||||
> **功能启用/禁用判定**:标准库与增量库中该功能的 `feature/*.md` **都不存在**时,该功能禁用(只删标准库、增量库仍存在时功能仍启用)。
|
||||
|
||||
## 引用优先级
|
||||
|
||||
运行时按以下顺序同时检索:
|
||||
|
||||
```
|
||||
references/(标准库) + references-add/(增量库) → 取并集
|
||||
```
|
||||
|
||||
1. 标准库内容优先,增量库作为补充
|
||||
2. 两处都存在时以 `references/` 为准(增量不覆盖标准)
|
||||
3. **唯一例外:路径配置**。`路径配置.md` 中用户自定义的产出路径**覆盖**标准库默认路径
|
||||
|
||||
## 修改规则(区分场景,判定标准与 SKILL.md 一致)
|
||||
|
||||
| 场景 | 判断依据(两步判定) | 生成设定调用的文件 | 修改方式 |
|
||||
|------|---------|------------------------|---------|
|
||||
| **① 开发机** | 本机有 `D:\AgentSkill` 且技能路径在 `D:\AgentSkill\` 下(源技能) | 调用源技能对应文件 | **源技能只读,禁止修改**;只能从源技能**单向同步**到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 `references/知识库/`;标准库 `references/` 可正常修改(开发机直接改标准库,不使用增量库机制) |
|
||||
| **② dsh 环境** | 本机有 `D:\AgentSkill` 且技能路径含 `.dsh`(如 `{主目录}/.dsh/skills/`) | 调用源技能对应文件 | **源技能只读,禁止修改**;只能从源技能**单向同步**到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 `references/知识库/`;标准库 `references/` 可正常修改,增量内容直接并入标准库对应位置 |
|
||||
| **③ 用户环境** | 本机**没有** `D:\AgentSkill`(技能装在哪、什么路径都是用户环境) | 调用本技能 `references/`(标准库,含账号设定 + 视频拆解自有知识库) | **不修改 `references/`**,新增/修改内容写入 `references-add/` 对应目录 |
|
||||
|
||||
## ③ 用户环境启用流程(如未来部署)
|
||||
|
||||
1. 把 `references/路径配置.md`、`references/铁律避坑规则/` 移回 `references-add/` 对应位置
|
||||
2. 删除标准库中③ 用户环境不需要的增量内容
|
||||
3. 按本文件「修改规则」维护增量库
|
||||
Reference in new issue
Block a user