Cappuccino

---
name: memory-manager-pro
description: Professional memory indexing and task management system for OpenClaw. Provides three-level indexing (core→project/type→detail), task tracking, keyword mapping, and tag-based retrieval. Use when managing multiple projects, organizing tasks, creating memory structures, or optimizing information retrieval. Triggers on phrases like "管理记忆", "创建索引", "规划任务", "memory management", "task planning", "组织项目".
---

# Memory Manager Pro

专业记忆索引与任务管理系统 Skill for OpenClaw。提供三级索引架构、任务追踪、关键词映射、标签检索等功能，支持多项目管理。

## 核心功能

1. **三级索引架构** - 核心索引→项目/类型索引→详细内容
2. **任务管理系统** - 创建、执行、追问、归档完整流程
3. **关键词映射** - 快速定位文件路径
4. **标签系统** - 多维度组合检索
5. **规划预生成** - 自动创建下一步规划
6. **智能去重** - 标题、任务ID等自动去重检查

## 快速开始

### 创建新项目结构

```bash
# 1. 创建项目目录
mkdir -p projects/{project_name}/{subdirs}
mkdir -p memory/项目索引 memory/类型索引 memory/快速检索 memory/任务流/任务详情

# 2. 创建核心文件
touch memory/核心索引.md
touch memory/项目索引/{类型}_项目索引.md
touch memory/类型索引/{category}.md
touch memory/快速检索/关键词映射.md

# 3. 初始化任务追踪
touch memory/任务流/活跃任务.md
```

### 创建新任务

```bash
# 1. 生成任务ID
TASK_ID="TASK_{TYPE}_{YYYYMMDD}_{SEQ}"

# 2. 创建任务详情文件
touch memory/任务流/任务详情/TASK_ID.md

# 3. 添加到活跃任务索引
edit memory/任务流/活跃任务.md

# 4. 关联到项目索引
edit memory/项目索引/{项目}_项目索引.md
```

## 目录结构标准

```
workspace/
├── projects/                    # 项目目录（按项目类型分类）
│   ├── novel/                   # 小说项目
│   │   └── {project_name}/
│   ├── code/                    # 编码项目
│   │   └── {project_name}/
│   ├── design/                  # 设计项目
│   │   └── {project_name}/
│   └── research/                # 研究项目
│       └── {project_name}/
│
├── memory/                      # 记忆索引系统
│   ├── 核心索引.md              # ⭐ 顶层入口（<500字）
│   ├── 系统说明.md              # 系统架构文档
│   │
│   ├── 项目索引/                # 按项目分类（纵向）
│   │   ├── 小说项目索引.md
│   │   ├── 编码项目索引.md
│   │   ├── 设计项目索引.md
│   │   └── 研究项目索引.md
│   │
│   ├── 类型索引/                # 按任务类型分类（横向）
│   │   ├── 创作类.md
│   │   ├── 编码类.md
│   │   ├── 设计类.md
│   │   └── 研究类.md
│   │
│   ├── 快速检索/                # 快速定位系统
│   │   ├── 关键词映射.md        # 关键词→路径映射
│   │   └── 标签系统.md          # 多维度标签检索
│   │
│   └── 任务流/                  # 任务管理
│       ├── 活跃任务.md          # 进行中任务
│       ├── 已完成任务.md        # 历史归档
│       ├── 任务模板/            # 标准化模板
│       └── 任务详情/            # 详细记录（支持追问）
│
└── MEMORY.md                    # 系统入口（极简）
```

## 三级索引架构

### 一级索引（MEMORY.md）
- **作用**: 极简入口，快速跳转
- **内容量**: <500字
- **包含**: 快速开始链接、主要入口、当前状态

```markdown
# MEMORY.md - 系统入口

## 快速开始
| 我需要... | 点击这里 |
|-----------|----------|
| 继续任务X | [活跃任务](memory/任务流/活跃任务.md) |
| 查找项目Y | [核心索引](memory/核心索引.md) |

## 当前状态
| 项目 | 任务 | 状态 |
```

### 二级索引（核心索引.md）
- **作用**: 分类导航，按需下钻
- **内容量**: <1000字
- **包含**: 按项目、按类型、任务状态、快速检索

```markdown
# 核心索引

## 活跃上下文
| 项目 | 当前任务 | 状态 |

## 按项目索引
- [小说项目](项目索引/小说项目索引.md)
- [编码项目](项目索引/编码项目索引.md)

## 按类型索引
- [创作类](类型索引/创作类.md)
- [编码类](类型索引/编码类.md)

## 任务状态
- [活跃任务](任务流/活跃任务.md)
- [已完成任务](任务流/已完成任务.md)
```

### 三级索引（项目/类型索引）
- **作用**: 具体内容，详细记录
- **内容量**: <2000字
- **包含**: 项目详情、任务列表、规范标准、资源链接

## 任务管理系统

### 任务ID格式
```
TASK_{TYPE}_{YYYYMMDD}_{SEQ}

TYPE:
- NOVEL: 小说创作
- CODE: 编码开发
- DESIGN: 设计任务
- RESEARCH: 研究分析
- SYSTEM: 系统优化

示例:
- TASK_NOVEL_20260426_001
- TASK_CODE_20260426_003
```

### 任务状态流转
```
待开始 → 进行中 → 待追问 → 已完成
            ↓
          已暂停
```

### 任务文件模板

**活跃任务索引.md**:
```markdown
# 活跃任务

## 按项目分组
| 任务ID | 内容 | 状态 | 优先级 | 详情 |

## 快速操作
- [任务详情](任务详情/TASK_XXX.md)
```

**任务详情/TASK_XXX.md**:
```markdown
# TASK_XXX

## 基本信息
- 标题：
- 类型：
- 状态：
- 优先级：

## 任务内容
...

## 执行记录
### 阶段1
- 时间：
- 操作：
- 结果：

## 追问记录
- 追问1：

## 下一步建议
...
```

## 关键词映射系统

### 映射表格式
```markdown
# 关键词映射表

## 项目关键词
| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 天道养殖场 | projects/novel/天道养殖场/ | 小说项目 |

## 任务关键词
| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 活跃任务 | memory/任务流/活跃任务.md | 当前任务 |
| 任务091 | memory/任务流/任务详情/TASK_XXX.md | 具体任务 |

## 索引关键词
| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 核心索引 | memory/核心索引.md | 顶层导航 |
```

### 使用场景

**场景1**: 用户说"继续创作天道养殖场"
```
1. 检索关键词"天道养殖场" → 定位项目目录
2. 检查活跃任务 → 获取当前任务ID
3. 读取任务详情 → 获取规划文件路径
4. 传递必要文件，执行任务
```

## 标签系统

### 标签分类

**项目标签**:
- `#天道养殖场` - 具体项目
- `#小说` - 项目类型

**类型标签**:
- `#创作` - 任务类型
- `#编码` - 任务类型
- `#设计` - 任务类型
- `#研究` - 任务类型

**状态标签**:
- `#活跃` - 进行中
- `#待开始` - 未开始
- `#已完成` - 已归档
- `#待追问` - 需追问

**优先级标签**:
- `#高优先级`
- `#中优先级`
- `#低优先级`

### 组合检索

**检索"活跃的小说创作任务"**:
- 标签: `#创作` + `#活跃` + `#小说`
- 结果: 过滤后的任务列表

## 索引更新服务（外部 Skill 调用接口）

Memory Manager Pro 提供标准化的索引更新服务，可被其他 Skill（如 Web Novel Creator）调用。

所有路径通过**语义推导自动生成**，无需调用方指定。

### 接口定义

**请求参数格式**：

```
Memory Manager Pro 索引更新请求
{
  "操作": "完成创作并更新索引",      // 必填
  "任务ID": "TASK_NOVEL_YYYYMMDD_XXX",  // 必填
  "章节": "第XXX章《标题名》",         // 可选
  "字数": "XXXX字",                   // 可选
  "项目": "天道养殖场",                // 必填，用于语义推导
  "创建下一章任务": true/false,         // 可选
  "下一章章节名": "第XXX+1章《标题》"  // 可选
}
```

**最简调用示例**（Web Novel Creator 创作完一章后）：
```
{
  "操作": "完成创作并更新索引",
  "任务ID": "TASK_NOVEL_20260426_004",
  "章节": "第094章《城中暗影》",
  "字数": "~2600字",
  "项目": "天道养殖场",
  "创建下一章任务": true,
  "下一章章节名": "第095章《残魂低语》"
}
```

---

### 语义推导引擎

Memory Manager Pro 从 `任务ID` 和 `项目` 参数中自动推导所有路径，无需硬编码：

#### 路径推导规则

```
任务ID → 自动提取任务类型
  TASK_NOVEL_xxx → 类型 = 创作类，项目类型 = 小说
  TASK_CODE_xxx  → 类型 = 编码类，项目类型 = 编码
  TASK_DESIGN_xxx → 类型 = 设计类，项目类型 = 设计
  TASK_RESEARCH_xxx → 类型 = 研究类，项目类型 = 研究
  TASK_SYSTEM_xxx → 类型 = 系统类，项目类型 = 系统

项目名 → 自动定位项目目录（通过关键词映射）
  1. 查 memory/快速检索/关键词映射.md 中的「项目关键词」表
  2. 若存在：直接使用映射路径
  3. 若不存在：按默认路径规则生成
    novel/项目名/ → 小说项目
    code/项目名/  → 编码项目
    design/项目名/ → 设计项目
    research/项目名/ → 研究项目

推导出的文件路径：
  项目索引:   memory/项目索引/{项目类型}项目索引.md
  类型索引:   memory/类型索引/{任务类型}.md
  任务详情:   memory/任务流/任务详情/{任务ID}.md
  正文目录:   {项目目录}正文/
  规划目录:   {项目目录}规划/
  标题库:     {项目目录}规划/已用标题库.md
```

#### 推导示例

| 任务ID | 项目 | 推导出的项目索引 | 推导出的类型索引 | 推导出的项目目录 |
|--------|------|-----------------|-----------------|-----------------|
| TASK_NOVEL_... | 天道养殖场 | `小说项目索引.md` | `创作类.md` | `novel/天道养殖场：从盘古开天杀穿/` |
| TASK_CODE_... | 博客系统 | `编码项目索引.md` | `编码类.md` | `code/博客系统/` |
| TASK_DESIGN_... | UI重设计 | `设计项目索引.md` | `设计类.md` | `design/UI重设计/` |
| TASK_RESEARCH_... | AI调研 | `研究项目索引.md` | `研究类.md` | `research/AI调研/` |

---

### 执行步骤

收到请求后，Memory Manager Pro 按以下流程执行：

```
第一步：解析参数
  ├── 从任务ID提取类型前缀（NOVEL/CODE/DESIGN/RESEARCH/SYSTEM）
  ├── 从类型前缀推导项目索引文件路径
  ├── 从类型前缀推导类型索引文件路径
  ├── 从项目名称查关键词映射 → 项目目录
  └── 若关键词映射不存在，按规则生成默认路径

第二步：更新任务详情
  ├── 构造路径: memory/任务流/任务详情/{任务ID}.md
  ├── 检查文件是否存在
  ├── 存在 → 标记已完成，追加执行记录
  └── 不存在 → 创建新文件（含基本信息、执行记录）

第三步：更新已完成任务索引
  ├── edit memory/任务流/已完成任务.md
  ├── 追加当日的任务记录
  └── 更新统计信息

第四步：更新活跃任务索引
  ├── edit memory/任务流/活跃任务.md
  ├── 从活跃列表移除已完成的
  └── 如请求创建下一章任务，追加新任务到活跃列表

第五步：更新项目索引（路径由类型前缀自动推导）
  ├── 类型前缀 NOVEL
  │   └── edit memory/项目索引/小说项目索引.md
  ├── 类型前缀 CODE
  │   └── edit memory/项目索引/编码项目索引.md
  ├── 类型前缀 DESIGN
  │   └── edit memory/项目索引/设计项目索引.md
  ├── 类型前缀 RESEARCH
  │   └── edit memory/项目索引/研究项目索引.md
  └── (如文件不存在，自动创建)

第六步：更新类型索引（路径由任务类型名称自动推导）
  ├── 类型 = 创作类 → edit memory/类型索引/创作类.md
  ├── 类型 = 编码类 → edit memory/类型索引/编码类.md
  ├── 类型 = 设计类 → edit memory/类型索引/设计类.md
  ├── 类型 = 研究类 → edit memory/类型索引/研究类.md
  └── 类型 = 系统类 → edit memory/类型索引/系统类.md（如不存在自动创建）

第七步：更新核心索引
  └── edit memory/核心索引.md

第八步：更新MEMORY.md
  └── edit MEMORY.md
```

### 类型前缀 → 索引文件映射表（完整参考）

| 任务ID前缀 | 类型名称 | 项目索引 | 类型索引 | 默认项目目录 |
|-----------|----------|----------|----------|-------------|
| NOVEL | 创作类 | `小说项目索引.md` | `创作类.md` | `novel/` |
| CODE | 编码类 | `编码项目索引.md` | `编码类.md` | `code/` |
| DESIGN | 设计类 | `设计项目索引.md` | `设计类.md` | `design/` |
| RESEARCH | 研究类 | `研究项目索引.md` | `研究类.md` | `research/` |
| SYSTEM | 系统类 | （无项目索引） | `系统类.md` | （无项目目录） |

### 调用注意事项

1. **调用方只需要传递 4 个必填参数**（操作、任务ID、项目、章节），其余可省略
2. **所有路径由系统自动推导**，不依赖调用方传入任何路径
3. **支持批量操作**：传递多个任务ID可一次性批量更新
4. **调用方仍需自己更新**小说专属内容文件（正文、规划、标题库）
5. **关键词映射优先**：项目目录优先查关键词映射表，不存在才用默认规则
6. **处理完后**返回确认信息给调用方

## Token 优化策略

### 按需加载原则

| 场景 | 传递内容 | 避免传递 |
|------|----------|----------|
| 执行任务 | 规划文件+必要上下文 | 历史完整记录 |
| 任务追问 | 任务详情文件 | 其他任务记录 |
| 项目概览 | 项目索引文件 | 详细内容文件 |
| 全局导航 | 核心索引文件 | 所有详细内容 |

### 文件大小控制

- MEMORY.md: <500字
- 核心索引.md: <1000字
- 项目/类型索引: <2000字
- 任务详情: 按需，完整记录

## 使用流程

### 创建新项目

```bash
# 1. 创建目录结构
mkdir -p projects/{类型}/{项目名}/{子目录}

# 2. 创建项目索引
edit memory/项目索引/{类型}_项目索引.md

# 3. 更新核心索引
edit memory/核心索引.md

# 4. 创建初始任务
# 生成任务ID
# 创建任务详情文件
# 添加到活跃任务索引
```

### 执行日常任务

```bash
# 1. 检查活跃任务
read memory/任务流/活跃任务.md

# 2. 读取任务详情
read memory/任务流/任务详情/TASK_XXX.md

# 3. 根据任务类型读取规划
read {项目路径}/规划/第XXX章规划.md

# 4. 执行任务
# ...

# 5. 更新任务状态
edit memory/任务流/任务详情/TASK_XXX.md
edit memory/任务流/活跃任务.md

# 6. 生成下一步规划（可选）
write {项目路径}/规划/第XXX+1章规划.md
```

### 追问历史任务

```bash
# 1. 关键词检索
# "第091章" → TASK_NOVEL_20260426_001

# 2. 读取任务详情
read memory/任务流/任务详情/TASK_NOVEL_20260426_001.md

# 3. 展示结果
```

## 参考文件

- `references/目录结构标准.md` - 完整目录规范
- `references/任务模板.md` - 任务文件模板
- `references/索引模板.md` - 索引文件模板
- `references/关键词映射示例.md` - 映射表示例
- `references/标签系统指南.md` - 标签使用指南

## 使用示例

### 示例1: 创建小说创作任务
```
用户: "创建天道养殖场第092章创作任务"

系统:
1. 生成任务ID: TASK_NOVEL_20260426_002
2. 创建任务详情文件
3. 读取第092章规划文件
4. 添加到活跃任务索引
5. 更新项目索引
6. 返回: 任务已创建，等待执行
```

### 示例2: 查看当前活跃任务
```
用户: "查看当前有什么任务"

系统:
1. 读取 memory/任务流/活跃任务.md
2. 按项目/类型/优先级分组展示
3. 提供快速操作链接
```

### 示例3: 追问历史任务
```
用户: "第091章创作得怎么样"

系统:
1. 关键词检索 "第091章" → TASK_NOVEL_20260426_001
2. 读取任务详情
3. 展示: 字数、时间、成果、关键节点
```

## 扩展方式

### 添加新项目类型
1. 创建 `memory/项目索引/新类型_项目索引.md`
2. 创建 `projects/新类型/` 目录
3. 更新 `memory/核心索引.md`
4. 更新关键词映射

### 添加新任务类型
1. 创建 `memory/类型索引/新类型.md`
2. 创建任务模板（可选）
3. 更新标签系统
4. 更新关键词映射

## 设计原则

1. **按需加载** - 只传递当前任务必需的上下文
2. **快速定位** - 通过索引3秒内找到目标文件
3. **最小上下文** - MEMORY.md < 500字，逐级下钻
4. **双向索引** - 纵向（项目）+ 横向（类型）交叉
5. **完整追溯** - 任务详情完整记录，支持追问

FILE:README.md
# Memory Manager Pro

专业记忆索引与任务管理系统 Skill for OpenClaw

## 简介

Memory Manager Pro 是一个通用的记忆索引与任务管理 Skill，适用于所有类型的项目管理。提供三级索引架构、任务追踪、关键词映射、标签检索等功能。

## 功能特性

- ✅ **三级索引架构** - 核心索引→项目/类型索引→详细内容
- ✅ **任务管理系统** - 创建、执行、追问、归档完整流程
- ✅ **关键词映射** - 快速定位文件路径
- ✅ **标签系统** - 多维度组合检索
- ✅ **规划预生成** - 自动创建下一步规划
- ✅ **智能去重** - 标题、任务ID等自动去重检查
- ✅ **多项目支持** - 同时管理多个项目
- ✅ **Token优化** - 按需加载，最小上下文
- ✅ **语义推导归档** - 通过任务ID前缀自动推导索引路径，无需硬编码
- ✅ **外部 Skill 调用接口** - 接受 Web Novel Creator 等外部 Skill 的索引更新请求

## 安装

### 本地安装
```bash
# 将 skill 复制到 workspace skills 目录
cp -r memory-manager-pro ~/.openclaw/workspace/skills/

# 验证安装
openclaw skills info memory-manager-pro
```

## 使用方法

### 触发方式

Skill 会自动识别以下关键词触发：
- "管理记忆"
- "创建索引"
- "规划任务"
- "memory management"
- "task planning"
- "组织项目"

### 快速开始

#### 1. 创建新项目结构
```
用户: "为我的小说项目创建记忆管理系统"

系统:
1. 创建目录结构
   - projects/novel/{项目名}/
   - memory/项目索引/
   - memory/类型索引/
   - memory/快速检索/
   - memory/任务流/

2. 创建核心文件
   - memory/核心索引.md
   - memory/项目索引/小说项目索引.md
   - memory/类型索引/创作类.md
   - memory/快速检索/关键词映射.md

3. 初始化任务追踪
   - memory/任务流/活跃任务.md
   - memory/任务流/已完成任务.md
```

#### 2. 创建新任务
```
用户: "创建第092章创作任务"

系统:
1. 生成任务ID: TASK_NOVEL_20260426_002
2. 创建任务详情文件
3. 添加到活跃任务索引
4. 关联到项目索引
5. 更新关键词映射
```

#### 3. 执行任务
```
用户: "执行第092章创作任务"

系统:
1. 读取活跃任务索引
2. 读取任务详情
3. 读取规划文件
4. 执行任务
5. 更新任务状态
6. 生成下一步规划
```

## 目录结构

```
workspace/
├── projects/                    # 项目存储
│   ├── novel/
│   ├── code/
│   ├── design/
│   └── research/
│
├── memory/                      # 记忆索引系统
│   ├── 核心索引.md              # 顶层入口
│   ├── 系统说明.md              # 系统架构
│   ├── 项目索引/                # 纵向索引
│   ├── 类型索引/                # 横向索引
│   ├── 快速检索/                # 快速定位
│   └── 任务流/                  # 任务管理
│
└── MEMORY.md                    # 系统入口
```

## 核心概念

### 三级索引架构

| 级别 | 文件 | 大小 | 作用 |
|------|------|------|------|
| 一级 | MEMORY.md | <500字 | 极简入口 |
| 二级 | 核心索引.md | <1000字 | 分类导航 |
| 三级 | 项目/类型索引 | <2000字 | 详细内容 |

### 任务ID格式
```
TASK_{TYPE}_{YYYYMMDD}_{SEQ}

示例：
- TASK_NOVEL_20260426_001
- TASK_CODE_20260426_003
- TASK_DESIGN_20260426_005
```

### 标签系统

**项目标签**: `#天道养殖场` `#项目A`
**类型标签**: `#创作` `#编码` `#设计` `#研究`
**状态标签**: `#活跃` `#待开始` `#已完成` `#待追问`
**优先级标签**: `#高优先级` `#中优先级` `#低优先级`

## 文件说明

- `SKILL.md` - Skill 主文件
- `references/目录结构标准.md` - 完整目录规范
- `references/任务模板.md` - 任务文件模板
- `references/索引模板.md` - 索引文件模板
- `references/关键词映射示例.md` - 映射表示例
- `references/标签系统指南.md` - 标签使用指南

## 使用示例

### 示例1：初始化新项目
```
用户: "为天道养殖场创建记忆管理系统"

系统执行：
1. mkdir -p projects/novel/天道养殖场/{正文,规划}
2. mkdir -p memory/{项目索引,类型索引,快速检索,任务流/任务详情}
3. 创建核心索引.md
4. 创建小说项目索引.md
5. 创建关键词映射.md
6. 初始化任务流

结果：记忆管理系统创建完成
```

### 示例2：创建并执行任务
```
用户: "创建并执行第092章创作任务"

系统执行：
1. 生成任务ID: TASK_NOVEL_20260426_002
2. 创建任务详情文件
3. 添加到活跃任务索引
4. 读取第092章规划
5. 检查标题库
6. 创作章节
7. 更新任务状态为已完成
8. 生成第093章规划
9. 更新所有索引
```

### 示例3：追问历史任务
```
用户: "查看第091章任务详情"

系统执行：
1. 关键词检索 "第091章" → TASK_NOVEL_20260426_001
2. 读取任务详情文件
3. 展示: 基本信息、执行记录、成果统计
```

## Token 优化

### 按需加载
| 场景 | 传递内容 |
|------|----------|
| 执行任务 | 规划文件+必要上下文 |
| 任务追问 | 任务详情文件 |
| 项目概览 | 项目索引文件 |
| 全局导航 | 核心索引文件 |

### 文件大小控制
- MEMORY.md: <500字
- 核心索引.md: <1000字
- 项目/类型索引: <2000字

## 扩展方式

### 添加新项目类型
1. 创建 `memory/项目索引/新类型_项目索引.md`
2. 创建 `projects/新类型/` 目录
3. 更新 `memory/核心索引.md`
4. 更新关键词映射

### 添加新任务类型
1. 创建 `memory/类型索引/新类型.md`
2. 创建任务模板
3. 更新标签系统
4. 更新关键词映射

## 贡献

欢迎提交 Issue 和 PR！

## 许可证

MIT License

## 作者

OpenClaw User

## 更新日志

### v1.1.0 (2026-04-26)
- 新增「索引更新服务」接口，接受外部 Skill 调用
- 语义推导引擎：通过任务ID类型前缀自动推导项目索引/类型索引路径
- 关键词映射优先：项目目录优先查关键词映射，不存在才用默认规则
- WEB Novel Creator 创作完成后委托 Memory Manager Pro 完成全量索引更新

### v1.0.0 (2026-04-26)
- 初始版本发布
- 三级索引架构
- 任务管理系统
- 关键词映射
- 标签检索系统
- 多项目支持

FILE:references/任务模板.md
# 任务文件模板

## 活跃任务索引模板

```markdown
# 活跃任务

> 当前进行中的任务列表

## 按项目分组

### {项目名称}
| 任务ID | 内容 | 状态 | 优先级 | 详情 |
|--------|------|------|--------|------|
| TASK_XXX | {任务简述} | {状态} | {优先级} | [详情](任务详情/TASK_XXX.md) |

## 按类型分组

### {类型}
- TASK_XXX: {任务简述}

## 按优先级分组

### 高优先级
- TASK_XXX: {任务简述}

### 中优先级
- 暂无

### 低优先级
- 暂无

## 快速操作

- [任务详情](任务详情/TASK_XXX.md)

---
*标签: #活跃 #项目名 #类型 #优先级*
```

## 任务详情模板

```markdown
# {任务ID}

## 基本信息
- **任务标题**: 
- **任务类型**: NOVEL/CODE/DESIGN/RESEARCH/SYSTEM
- **关联项目**: 
- **创建时间**: YYYY-MM-DD HH:MM
- **状态**: 待开始/进行中/待追问/已完成/已暂停
- **优先级**: 高/中/低

## 任务内容
{详细描述任务目标和要求}

## 输入资源
- {资源1}: {路径}
- {资源2}: {路径}

## 输出交付
- {交付物1}: {路径}
- {交付物2}: {路径}

## 执行记录

### 阶段1: {阶段名称}
- **时间**: YYYY-MM-DD HH:MM
- **操作**: {具体操作}
- **结果**: {执行结果}
- **问题**: {遇到的问题}

### 阶段2: {阶段名称}
- **时间**: 
- **操作**: 
- **结果**: 

## 追问记录

### 追问1: {追问主题}
- **时间**: 
- **问题**: 
- **回答**: 
- **链接**: [追问文件](追问记录/{任务ID}_追问1.md)

## 下一步建议
1. {建议1}
2. {建议2}

## 关联任务
- **前置任务**: TASK_XXX
- **后续任务**: TASK_XXX
- **相关任务**: TASK_XXX

## 统计信息
- **预估工时**: X小时
- **实际工时**: X小时
- **完成度**: X%

---
*最后更新: YYYY-MM-DD HH:MM*
*标签: #项目名 #类型 #状态 #优先级*
```

## 已完成任务索引模板

```markdown
# 已完成任务

> 已归档的历史任务

## {年月}

| 任务ID | 类型 | 内容 | 项目 | 完成时间 | 成果 | 详情 |
|--------|------|------|------|----------|------|------|
| TASK_XXX | {类型} | {内容} | {项目} | YYYY-MM-DD | {成果} | [详情](任务详情/TASK_XXX.md) |

## 统计

### 本月统计
- {类型}: X个
- 总计: X个

### 累计成果
- {成果类型}: X

---
*标签: #已完成 #历史归档*
```

## 使用说明

1. 创建新任务时，复制对应模板
2. 填充基本信息和任务内容
3. 执行过程中逐步完善执行记录
4. 完成后移动到已完成任务索引
5. 保留任务详情文件用于追问

FILE:references/关键词映射示例.md
# 关键词映射示例

## 项目关键词

| 关键词 | 映射路径 | 说明 | 标签 |
|--------|----------|------|------|
| 天道养殖场 | `projects/novel/天道养殖场/` | 小说项目 | #天道养殖场 #小说 |
| 项目A | `projects/code/项目A/` | 编码项目 | #项目A #编码 |
| 设计B | `projects/design/设计B/` | 设计项目 | #设计B #设计 |
| 研究C | `projects/research/研究C/` | 研究项目 | #研究C #研究 |

## 章节/阶段关键词

| 关键词 | 映射路径 | 说明 | 标签 |
|--------|----------|------|------|
| 第091章 | `projects/novel/天道养殖场/规划/第091章规划.md` | 章节规划 | #天道养殖场 #第091章 |
| 第092章 | `projects/novel/天道养殖场/规划/第092章规划.md` | 章节规划 | #天道养殖场 #第092章 |
| 阶段1 | `memory/任务流/任务详情/TASK_XXX.md#阶段1` | 任务阶段 | #TASK_XXX |

## 任务关键词

| 关键词 | 映射路径 | 说明 | 标签 |
|--------|----------|------|------|
| 活跃任务 | `memory/任务流/活跃任务.md` | 当前任务列表 | #活跃 #任务 |
| 已完成任务 | `memory/任务流/已完成任务.md` | 历史任务列表 | #已完成 #任务 |
| 任务091 | `memory/任务流/任务详情/TASK_NOVEL_20260426_001.md` | 具体任务 | #天道养殖场 #创作 |
| 任务092 | `memory/任务流/任务详情/TASK_NOVEL_20260426_002.md` | 具体任务 | #天道养殖场 #创作 |

## 索引关键词

| 关键词 | 映射路径 | 说明 | 标签 |
|--------|----------|------|------|
| 核心索引 | `memory/核心索引.md` | 顶层导航 | #索引 #核心 |
| 项目索引 | `memory/项目索引/` | 按项目分类 | #索引 #项目 |
| 类型索引 | `memory/类型索引/` | 按类型分类 | #索引 #类型 |
| 小说项目 | `memory/项目索引/小说项目索引.md` | 小说项目列表 | #索引 #小说 |
| 编码项目 | `memory/项目索引/编码项目索引.md` | 编码项目列表 | #索引 #编码 |
| 创作类 | `memory/类型索引/创作类.md` | 创作任务索引 | #索引 #创作 |
| 编码类 | `memory/类型索引/编码类.md` | 编码任务索引 | #索引 #编码 |

## 资源关键词

| 关键词 | 映射路径 | 说明 | 标签 |
|--------|----------|------|------|
| 标题库 | `projects/novel/天道养殖场/规划/已用标题库.md` | 已用标题列表 | #天道养殖场 #标题库 |
| 规划模板 | `memory/任务流/任务模板/小说创作.md` | 任务模板 | #模板 #创作 |
| 番茄规范 | `references/番茄小说规范.md` | 平台规范 | #规范 #番茄小说 |

## 检索示例

### 示例1：继续创作天道养殖场
```
输入: "继续创作天道养殖场"
关键词: "天道养殖场"
映射: projects/novel/天道养殖场/
操作:
1. 读取项目索引获取当前任务
2. 读取下一章规划文件
3. 读取标题库检查去重
4. 执行创作任务
```

### 示例2：查看当前任务
```
输入: "查看当前任务"
关键词: "活跃任务"
映射: memory/任务流/活跃任务.md
操作:
1. 读取活跃任务索引
2. 按项目/类型/优先级分组展示
3. 提供快速操作链接
```

### 示例3：追问历史任务
```
输入: "第091章创作得怎么样"
关键词: "第091章"
映射: memory/任务流/任务详情/TASK_NOVEL_20260426_001.md
操作:
1. 关键词检索定位任务详情文件
2. 读取任务执行记录和成果
3. 展示统计数据和关键节点
```

### 示例4：查找项目
```
输入: "查看小说项目"
关键词: "小说项目"
映射: memory/项目索引/小说项目索引.md
操作:
1. 读取小说项目索引
2. 展示所有活跃和已完成的小说项目
3. 提供项目入口链接
```

## 维护说明

1. **添加新项目**：在对应类别下添加关键词条目
2. **添加新任务**：创建任务时同步更新映射表
3. **定期清理**：移除不再使用的关键词
4. **标签同步**：确保关键词和标签一致

FILE:references/标签系统指南.md
# 标签系统指南

## 标签分类体系

### 1. 项目标签
用于标识所属项目

| 标签 | 说明 | 示例 |
|------|------|------|
| `#天道养殖场` | 具体项目名称 | 小说项目 |
| `#项目A` | 具体项目名称 | 编码项目 |
| `#设计B` | 具体项目名称 | 设计项目 |
| `#研究C` | 具体项目名称 | 研究项目 |

### 2. 类型标签
用于标识任务类型

| 标签 | 说明 | 适用场景 |
|------|------|----------|
| `#创作` | 创作类任务 | 小说、文案、策划 |
| `#编码` | 编码类任务 | 开发、调试、部署 |
| `#设计` | 设计类任务 | 视觉、交互、原型 |
| `#研究` | 研究类任务 | 调研、分析、总结 |
| `#系统` | 系统类任务 | 优化、配置、维护 |

### 3. 状态标签
用于标识任务状态

| 标签 | 说明 | 流转规则 |
|------|------|----------|
| `#活跃` | 进行中 | 待开始→进行中 |
| `#待开始` | 未开始 | 新建任务 |
| `#待追问` | 需追问 | 进行中→待追问 |
| `#已完成` | 已归档 | 进行中→已完成 |
| `#已暂停` | 暂停中 | 进行中→已暂停 |

### 4. 优先级标签
用于标识任务优先级

| 标签 | 说明 | 处理顺序 |
|------|------|----------|
| `#高优先级` | 紧急重要 | 优先处理 |
| `#中优先级` | 重要不紧急 | 其次处理 |
| `#低优先级` | 不紧急 | 延后处理 |

### 5. 索引标签
用于标识索引类型

| 标签 | 说明 | 使用场景 |
|------|------|----------|
| `#索引` | 索引文件 | 所有索引文件 |
| `#核心` | 核心索引 | MEMORY.md、核心索引.md |
| `#项目` | 项目索引 | 项目索引目录下 |
| `#类型` | 类型索引 | 类型索引目录下 |

## 组合检索

### 基础组合

**项目+类型**
```
#天道养殖场 + #创作
→ 天道养殖场项目的所有创作任务
```

**类型+状态**
```
#创作 + #活跃
→ 所有活跃的创作任务
```

**项目+状态**
```
#天道养殖场 + #活跃
→ 天道养殖场项目的活跃任务
```

### 复杂组合

**项目+类型+状态**
```
#天道养殖场 + #创作 + #活跃
→ 天道养殖场项目中活跃的创作任务
```

**类型+状态+优先级**
```
#创作 + #活跃 + #高优先级
→ 活跃的、高优先级的创作任务
```

**项目+类型+状态+优先级**
```
#天道养殖场 + #创作 + #活跃 + #高优先级
→ 天道养殖场项目中活跃的、高优先级的创作任务
```

## 使用场景

### 场景1：查看小说创作任务
```
检索: #创作 + #小说
结果: 
- TASK_NOVEL_20260426_001: 第091章创作
- TASK_NOVEL_20260426_002: 第092章创作
```

### 场景2：查看高优先级任务
```
检索: #活跃 + #高优先级
结果:
- TASK_NOVEL_20260426_001: 第091章创作（高）
- TASK_CODE_20260426_003: 紧急修复（高）
```

### 场景3：查看天道养殖场所有任务
```
检索: #天道养殖场
结果:
- 活跃: TASK_NOVEL_20260426_001
- 活跃: TASK_NOVEL_20260426_002
- 已完成: TASK_NOVEL_20260425_003
```

### 场景4：查看待追问任务
```
检索: #待追问
结果:
- TASK_XXX: 等待用户确认
```

## 标签使用规范

### 文件头部标签注释

```markdown
<!--
标签: #天道养殖场 #创作 #活跃 #高优先级
创建: 2026-04-26 00:00
更新: 2026-04-26 00:00
-->

# 文件内容...
```

### 索引文件标签

**活跃任务.md**
```markdown
---
*标签: #活跃 #任务 #索引*
```

**项目索引.md**
```markdown
---
*标签: #项目 #索引 #{项目名}*
```

**任务详情.md**
```markdown
---
*标签: #{项目名} #类型 #状态 #优先级*
```

## 标签管理

### 添加新标签

1. 确定标签分类（项目/类型/状态/优先级/索引）
2. 确保标签名称简洁明了
3. 在标签系统指南中登记
4. 更新相关文件的标签注释

### 标签命名规范

- 使用英文或中文
- 简洁明了，不超过10个字符
- 避免空格，使用连字符或驼峰
- 统一大小写（建议使用小写）

### 标签示例

```
✓ #天道养殖场
✓ #创作
✓ #活跃
✓ #高优先级
✓ #小说-创作

✗ #天道养殖场第91章（太长）
✗ #创 作（有空格）
✗ #ACTIVE（大小写不一致）
```

## 标签检索实现

### 方式1：全文搜索
```bash
# 搜索包含特定标签的文件
grep -r "#天道养殖场" memory/ --include="*.md"
```

### 方式2：索引文件
维护标签→文件列表的映射表

```markdown
# 标签索引

## #天道养殖场
- memory/任务流/任务详情/TASK_NOVEL_20260426_001.md
- memory/项目索引/小说项目索引.md

## #创作
- memory/类型索引/创作类.md
- memory/任务流/任务详情/TASK_NOVEL_20260426_001.md
```

### 方式3：动态检索
根据标签组合实时筛选

```
输入: #天道养殖场 + #活跃
步骤:
1. 找到所有含#天道养殖场的文件
2. 找到所有含#活跃的文件
3. 取交集
4. 返回结果列表
```

FILE:references/目录结构标准.md
# 目录结构标准

## 完整目录树

```
workspace/
├── projects/                    # 项目存储（按类型分类）
│   ├── novel/                   # 小说项目
│   │   └── {project_name}/
│   │       ├── 正文/
│   │       └── 规划/
│   ├── code/                    # 编码项目
│   │   └── {project_name}/
│   ├── design/                  # 设计项目
│   │   └── {project_name}/
│   └── research/                # 研究项目
│       └── {project_name}/
│
├── memory/                      # 记忆索引系统
│   ├── 核心索引.md              # ⭐ 顶层入口
│   ├── 系统说明.md              # 系统架构文档
│   │
│   ├── 项目索引/                # 纵向索引（按项目）
│   │   ├── 小说项目索引.md
│   │   ├── 编码项目索引.md
│   │   ├── 设计项目索引.md
│   │   └── 研究项目索引.md
│   │
│   ├── 类型索引/                # 横向索引（按类型）
│   │   ├── 创作类.md
│   │   ├── 编码类.md
│   │   ├── 设计类.md
│   │   └── 研究类.md
│   │
│   ├── 快速检索/                # 快速定位
│   │   ├── 关键词映射.md
│   │   └── 标签系统.md
│   │
│   └── 任务流/                  # 任务管理
│       ├── 活跃任务.md
│       ├── 已完成任务.md
│       ├── 任务模板/
│       │   ├── 小说创作.md
│       │   ├── 编码开发.md
│       │   ├── 设计任务.md
│       │   └── 研究分析.md
│       └── 任务详情/
│           └── TASK_XXX.md
│
└── MEMORY.md                    # 系统入口（极简）
```

## 文件大小标准

| 文件 | 建议大小 | 说明 |
|------|----------|------|
| MEMORY.md | < 500字 | 极简入口 |
| 核心索引.md | < 1000字 | 分类导航 |
| 项目/类型索引 | < 2000字 | 详细内容 |
| 任务详情 | 按需 | 完整记录 |
| 规划文件 | < 1500字 | 章节规划 |

## 命名规范

### 任务ID
```
TASK_{TYPE}_{YYYYMMDD}_{SEQ}

示例：
- TASK_NOVEL_20260426_001
- TASK_CODE_20260426_003
- TASK_DESIGN_20260426_005
```

### 章节标题
```
第XXX章《标题名》

示例：
- 第091章《第七层觉醒》
- 第092章《本源具现》
```

### 索引文件名
```
{分类}_索引.md
{分类}_项目索引.md
{分类}.md

示例：
- 核心索引.md
- 小说项目索引.md
- 创作类.md
```

## 创建新项目流程

```bash
# 1. 创建项目目录
mkdir -p projects/{类型}/{项目名}/{子目录}

# 2. 创建索引文件
touch memory/项目索引/{类型}_项目索引.md

# 3. 更新核心索引
edit memory/核心索引.md

# 4. 创建初始规划（可选）
touch projects/{类型}/{项目名}/规划/初始规划.md

# 5. 更新关键词映射
edit memory/快速检索/关键词映射.md
```

## 文件模板位置

- `references/索引模板.md` - 索引文件模板
- `references/任务模板.md` - 任务文件模板
- `references/规划模板.md` - 规划文件模板

FILE:references/索引模板.md
# 索引文件模板

## 核心索引模板

```markdown
# 核心索引

> 顶层快速入口，按需向下导航

## 活跃上下文

| 项目 | 当前任务 | 最后更新 | 快速入口 |
|------|----------|----------|----------|
| {项目名} | {当前任务} | YYYY-MM-DD | [规划]({规划路径}) |

## 按项目索引

- [{类型1}项目](项目索引/{类型1}_项目索引.md)
- [{类型2}项目](项目索引/{类型2}_项目索引.md)

## 按类型索引

- [{类型1}类](类型索引/{类型1}.md)
- [{类型2}类](类型索引/{类型2}.md)

## 任务状态

- [活跃任务](任务流/活跃任务.md)
- [已完成任务](任务流/已完成任务.md)

## 快速检索

- [关键词映射](快速检索/关键词映射.md)
- [标签系统](快速检索/标签系统.md)

---
*设计原则：本文件保持极简，所有详情通过链接按需加载*
```

## 项目索引模板

```markdown
# {类型}项目索引

## 活跃项目

### {项目名称}
| 属性 | 值 |
|------|-----|
| 项目ID | {ID} |
| 状态 | {状态} |
| 目录 | `projects/{类型}/{项目名}/` |
| 当前任务 | TASK_XXX |

**快速链接**
- [项目目录]({项目路径})
- [当前规划]({规划路径})
- [任务详情](../任务流/任务详情/TASK_XXX.md)

**关键信息**
- 

**规范标准**
- 

---

## 项目模板

```markdown
### {项目名称}
| 属性 | 值 |
|------|-----|
| 项目ID | {ID} |
| 状态 | {状态} |
| 目录 | `projects/{类型}/{项目名}/` |
| 当前任务 | TASK_XXX |

**快速链接**
- [目录]()
- [规划]()
- [任务]()

**关键信息**
- 

**规范标准**
- 
```

## 类型索引模板

```markdown
# {类型}类任务索引

## 活跃任务

| 任务ID | 项目 | 内容 | 状态 | 规划文件 |
|--------|------|------|------|----------|
| TASK_XXX | {项目} | {内容} | {状态} | [规划]({规划路径}) |

## 规范库

### {子类型}规范
- 

## 资源

### {资源类型}
- 

## 历史任务

| 任务ID | 项目 | 内容 | 完成时间 | 成果 |
|--------|------|------|----------|------|
| TASK_XXX | {项目} | {内容} | YYYY-MM-DD | {成果} |

## 技巧库

- 

---
*标签: #{类型} #活跃 #历史归档*
```

## MEMORY.md 模板

```markdown
# MEMORY.md - 系统入口

> 极简入口，快速导航到详细内容

## 快速开始

| 我需要... | 点击这里 |
|-----------|----------|
| 继续{任务} | [{任务}]({任务路径}) |
| 查看当前任务 | [活跃任务](memory/任务流/活跃任务.md) |
| 查找项目 | [核心索引](memory/核心索引.md) |

## 主要入口

- **[核心索引](memory/核心索引.md)** - 系统主入口
- **[活跃任务](memory/任务流/活跃任务.md)** - 当前任务
- **[关键词检索](memory/快速检索/关键词映射.md)** - 快速定位

## 当前状态

| 项目 | 任务 | 状态 |
|------|------|------|
| {项目} | {任务} | {状态} |

## 任务索引系统

| 索引文件 | 路径 |
|----------|------|
| 活跃任务 | `memory/任务流/活跃任务.md` |
| 已完成任务 | `memory/任务流/已完成任务.md` |
| 任务详情 | `memory/任务流/任务详情/` |

---
*本文件保持极简，详细内容通过链接按需加载*
*最后更新: YYYY-MM-DD HH:MM*
```

---
name: web-novel-creator
description: |
  网文创作兼容协调层。
  定位：不做一个独立的创作引擎，而是让现有的优秀创作Skill（如 novel-generator、open-novel-writing、novel-orchestrator 等）能够无缝对接 Memory Manager Pro 的索引系统。
  核心价值：(1) 提供统一的项目目录规范，让各Skill共享同一个项目空间；(2) 作为创作结束后对接 Memory Manager Pro 索引更新的标准入口。
  Use when: 已有的独立创作Skill（如 novel-generator）已创作完章节，需要归档、更新索引、或继续统筹下一步创作。
  Not when: 用户要从零开始创作小说（用 novel-generator）、需要多角色协作（用 novel-orchestrator）、或需要全流程设定管理（用 open-novel-writing）。
---

# Web Novel Creator

网文创作兼容协调层。不取代 `novel-generator`、`open-novel-writing`、`novel-orchestrator` 等专项 Skill，而是让它们能共享统一的**项目目录规范**和**索引归档流程**。

## 核心定位

```
SkillHub 网文创作生态：

  novel-generator      open-novel-writing      novel-orchestrator
  （从零生成爽文）     （全流程设定管理）       （多角色协作）
        │                      │                       │
        └──────────────────────┼───────────────────────┘
                               ▼
                      web-novel-creator
                  （兼容协调层：统一目录规范 + 索引归档入口）
                               │
                               ▼
                      Memory Manager Pro
                  （语义推导 + 全量索引更新）
```

### 不做什么
- 不自建"从零到一章"的创作引擎 —— 用 `novel-generator`
- 不替代多角色协作 —— 用 `novel-orchestrator`
- 不管理世界观/人设 —— 用 `open-novel-writing`
- 不生成图片 —— 用 `nano-banana-pro`
- 不做索引管理 —— 和 `Memory Manager Pro` 配合，但由后者执行

### 做什么
- 统一项目目录规范（让各 Skill 产出都存到同一位置）
- 创作完成后对接 Memory Manager Pro 更新索引（统一入口）
- 当项目目录规范尚未建立时，初始化标准结构

## 统一目录规范

所有与本 Skill 兼容的创作 Skill 应遵循以下目录结构：

```
novel/{项目名}/
├── 正文/                    # 章节正文（各Skill共同读写）
│   ├── 第001章.md
│   └── 第XXX章.md
├── 规划/                    # 章节规划（兼容层统一管理）
│   ├── 已用标题库.md
│   ├── 第XXX章规划.md
│   └── 规划模板.md
├── 设定/                    # 世界观/人设（open-novel-writing 或其他 Skill 使用）
│   ├── 世界观.md
│   └── 人物/
├── 总纲/                    # 故事总纲（cq-novel-writer 或其他 Skill 使用）
│   └── 故事总纲.md
├── .learnings/              # 记忆系统（novel-generator 使用）
│   ├── CHARACTERS.md
│   ├── LOCATIONS.md
│   └── PLOT_POINTS.md
└── output/                  # 输出目录（novel-generator 使用）
```

> 各 Skill 可选择性地使用目录中的部分结构。例如 novel-generator 使用 `正文/`、`.learnings/`、`output/`；open-novel-writing 使用 `正文/`、`设定/`、`规划/`。

## 快速开始

### 场景A：兼容 Skill 完成创作后归档
```
1. 检测是哪类 Skill 完成了创作
   - novel-generator: 检查 .learnings/ 和 output/
   - open-novel-writing: 检查 设定/ 和 规划/
   - novel-orchestrator: 检查 规划/ 和 正文/

2. 将产出迁移到统一目录（如需要）
   - 正文 → novel/{项目名}/正文/
   - 规划 → novel/{项目名}/规划/

3. 调用 Memory Manager Pro 完成索引更新
   → 传递参数（路径由 Memory Manager Pro 自动推导）
```

### 场景B：初始化项目目录
```
1. 创建标准目录结构
   mkdir -p novel/{项目名}/{正文,规划,设定,总纲,.learnings,output}

2. 初始化标题库
   检查 novel/{项目名}/正文/ 中已存在的文件，生成已用标题库

3. 调用 Memory Manager Pro 初始化记忆索引
   → 传递参数：项目名、创建初始任务
```

## 兼容对接指南

### 对接 novel-generator

**novel-generator 的产出位置**：
- 正文：`output/第X章.md` → 迁移到 `正文/第XXX章.md`
- 记忆：`.learnings/` → 保留在原位（已兼容规范）
- 本 Skill 不干涉 novel-generator 的引导流程，只在其创作完成后接管归档

**对接流程**：
```
1. novel-generator 完成创作后
   → detect: 检测到 .learnings/ 目录和 output/ 文件

2. web-novel-creator 介入归档
   → 将 output/ 中的正文移动到 novel/{项目名}/正文/
   → 检查 规划/ 中是否有对应的规划文件
   → 如没有规划文件，只需要归档正文即可

3. 调用 Memory Manager Pro
   → 更新索引，记录章节完成
```

### 对接 open-novel-writing

**open-novel-writing 的产出位置**：
- 正文：`novel/{项目名}/正文/`（兼容规范）
- 设定：`novel/{项目名}/设定/`（兼容规范）
- 规划：`novel/{项目名}/规划/`（兼容规范）

**对接流程**：
```
1. open-novel-writing 完成创作后
   → detect: 检测到 设定/ 目录

2. web-novel-creator 确认目录规范一致，检查标题库是否更新
   → 如标题库未更新，进行补录

3. 调用 Memory Manager Pro
   → 更新索引，记录章节完成
```

### 对接 novel-orchestrator

**novel-orchestrator 的产出位置**：
- 正文：`novel/{项目名}/正文/`（兼容规范）
- 规划：`novel/{项目名}/规划/`（兼容规范）

**对接流程**：
```
1. novel-orchestrator 的 checker 通过审查后
   → detect: 检测到 writer 产出 + checker 通过记录

2. web-novel-creator 确认目录规范一致，检查标题库是否更新
   → 如标题库未更新，进行补录

3. 调用 Memory Manager Pro
   → 更新索引，记录章节完成
```

### 对接 cq-novel-writer

**cq-novel-writer 的产出位置**：
- 正文：`novel/`（根目录，需迁移）
- 故事总纲：`novel/故事总纲.md`（兼容规范）

**对接流程**：
```
1. cq-novel-writer 完成创作后
   → detect: 检测到 故事总纲.md

2. web-novel-creator 将正文从根目录迁移到 novel/{项目名}/正文/
   → 如正文文件需要重命名，统一为 第XXX章.md 格式

3. 调用 Memory Manager Pro
   → 更新索引，记录章节完成
```

## 创作流程规则

### 规则1：依赖外部创作 Skill

本 Skill **不直接创作正文**（除了在规划不存在时根据上一章生成后续规划）。

**创作正文的触发流程**：
```
用户请求"继续写第X章"
  ↓
检查是否有现成规划
  ↓
有规划 → 判断适合用哪个 Skill 创作
  ├── 从零开始的创作 → 委托 novel-generator
  ├── 需要设定管理 → 委托 open-novel-writing
  ├── 需要审核流程 → 委托 novel-orchestrator
  └── 简单的续写 → 直接创作（fallback）
  ↓
无规划 → 读取上一章末段生成规划
      → 然后按上述流程创作
```

### 规则2：规划预生成
创作完成后，如当前 Skill 没有生成下一章规划，由兼容层补充：
- 存储位置：`novel/{项目名}/规划/第XXX章规划.md`
- 内容：核心冲突、剧情要点、字数目标、伏笔设置

### 规则3：标题去重检验
无论使用哪个外部 Skill 创作，最终都必须通过标题库去重检验：
- 标题库：`novel/{项目名}/规划/已用标题库.md`
- 外部 Skill 创作后，由兼容层检查标题是否已录入
- 未录入时由兼容层补充

### 规则4：索引更新 → 委托给 Memory Manager Pro

创作完成后，**不要自己编辑索引文件**。将索引更新任务交给 **Memory Manager Pro Skill** 完成。

**传递参数格式**（路径由 Memory Manager Pro 自动推导）：
```
Memory Manager Pro 索引更新请求
{
  "操作": "完成创作并更新索引",
  "任务ID": "TASK_NOVEL_YYYYMMDD_XXX",
  "章节": "第XXX章《标题名》",
  "字数": "XXXX字",
  "项目": "天道养殖场",          // 用于语义推导项目目录
  "来源Skill": "novel-generator",  // 标记哪类Skill完成的创作
  "创建下一章任务": true,
  "下一章章节名": "第XXX+1章《标题》"
}
```

**Memory Manager Pro 会负责以下完整流程**：
1. 创建/更新任务详情文件（标记为已完成）
2. 更新已完成任务索引（追加记录、更新统计）
3. 更新活跃任务索引（移除已完成、添加新任务）
4. 更新项目索引进度
5. 更新类型索引
6. 更新已用标题库
7. 更新MEMORY.md
8. 更新核心索引

## 兼容检测模板

用于识别当前使用了哪些外部 Skill：

```markdown
# .skill-detect

当 web-novel-creator 被调用时，检查以下标识文件/目录：

## 检测清单

| 标识文件/目录 | 对应的 Skill | 检测方式 |
|--------------|-------------|---------|
| .learnings/ | novel-generator | 目录是否存在 |
| output/ | novel-generator | 目录是否存在 |
| 设定/世界观.md | open-novel-writing | 文件是否存在 |
| 总纲/故事总纲.md | cq-novel-writer | 文件是否存在 |
| references/agent-setup.md | novel-orchestrator | 引用文件中是否有agent-setup |

## 优先级顺序

同时检测到多个 Skill 时：
1. novel-orchestrator（最复杂，优先尊重其协作流程）
2. novel-generator（有自建记忆系统）
3. open-novel-writing（有设定管理）
4. cq-novel-writer（最简单）
5. 无检测结果 → 使用内置 fallback 创作
```

## 参考文件

详细内容请参阅 references/ 目录：
- `references/规划模板.md` - 章节规划标准模板
- `references/关键词映射.md` - 快速定位关键词表
- `references/标签系统.md` - 多维度标签检索指南
- `references/番茄小说规范.md` - 平台规范详解
- `references/对接规范.md` - 各外部Skill的对接详细说明

FILE:README.md
# Web Novel Creator — 网文创作兼容协调层

不再是一个独立的创作引擎，而是让 SkillHub 上优秀的网文创作 Skill 都能无缝对接 **Memory Manager Pro** 的索引系统。

## 定位

```
      novel-generator     open-novel-writing     novel-orchestrator
      （从零生成爽文）    （全流程设定管理）      （多角色协作）
              │                    │                     │
              └────────────────────┼─────────────────────┘
                                   ▼
                          web-novel-creator
                    （兼容协调层 + 索引归档入口）
                                   │
                                   ▼
                          Memory Manager Pro
                      （语义推导 + 全量索引更新）
```

## 不做的事

- ❌ 不自建创作引擎（用 `novel-generator`）
- ❌ 不替代多角色协作（用 `novel-orchestrator`）
- ❌ 不管理世界观/人设（用 `open-novel-writing`）
- ❌ 不生成图片（用 `nano-banana-pro`）
- ❌ 不做索引管理（由 `Memory Manager Pro` 执行）

## 做的事

- ✅ **统一目录规范** — 让各 Skill 产出存到同一位置
- ✅ **兼容检测** — 自动识别当前使用了哪些外部 Skill
- ✅ **创作后归档** — 迁移正文、补充规划、更新标题库
- ✅ **对接 Memory Manager Pro** — 统一入口完成全量索引更新

## 兼容的 Skill

| Skill | 原生产出位置 | 兼容层介入 |
|-------|-------------|-----------|
| novel-generator | output/ + .learnings/ | 迁移正文+补充规划 |
| open-novel-writing | 正文/ + 设定/ + 规划/ | 命名微调+补录标题库 |
| novel-orchestrator | 正文/ + 规划/ | 补录标题库+索引归档 |
| cq-novel-writer | 根目录 | 迁移+重命名+归档 |
| 其他 | 待检测 | 通用对接流程 |

## 统一目录规范

```
novel/{项目名}/
├── 正文/             # 各Skill共同读写
├── 规划/             # 标题库+章节规划
├── 设定/             # 世界观/人设（open-novel-writing）
├── 总纲/             # 故事总纲（cq-novel-writer）
├── .learnings/       # 记忆系统（novel-generator）
└── output/           # 输出（novel-generator）
```

## 安装

```bash
# 本地安装
cp -r web-novel-creator ~/.openclaw/workspace/skills/

# 从 SkillHub 安装
clawhub install web-novel-creator
```

## 更新日志

### v2.0.0 (2026-04-26)
- **重构为兼容协调层**：不再自己做创作引擎
- 兼容 novel-generator、open-novel-writing、novel-orchestrator、cq-novel-writer
- 统一目录规范，让各 Skill 共享项目空间
- 自动检测外部 Skill，自动迁移产出
- 对接规范文档（references/对接规范.md）
- 配套 Memory Manager Pro v1.1.0

### v1.1.1 (2026-04-26)
- 修复：创作时不再重复读取上一章正文

### v1.1.0 (2026-04-26)
- 索引更新委托给 Memory Manager Pro

### v1.0.0 (2026-04-26)
- 初始版本

FILE:references/关键词映射.md
# 关键词映射表

> 关键词 → 文件路径快速定位

## 项目关键词

| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 天道养殖场 | `novel/天道养殖场：从盘古开天杀穿/` | 小说项目主目录 |
| 第091章 | `novel/天道养殖场：从盘古开天杀穿/规划/第091章规划.md` | 下一章规划 |
| 标题库 | `novel/天道养殖场：从盘古开天杀穿/规划/已用标题库.md` | 已用标题列表 |

## 任务关键词

| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 活跃任务 | `memory/任务流/活跃任务.md` | 当前进行中任务 |
| 任务091 | `memory/任务流/任务详情/TASK_NOVEL_20260426_001.md` | 第091章创作任务 |
| 任务084-090 | `memory/任务流/任务详情/TASK_NOVEL_20260425_003.md` | 批量创作任务 |

## 类型关键词

| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 小说创作 | `memory/类型索引/创作类.md` | 创作类任务索引 |
| 编码开发 | `memory/类型索引/编码类.md` | 编码类任务索引 |
| 设计任务 | `memory/类型索引/设计类.md` | 设计类任务索引 |
| 研究分析 | `memory/类型索引/研究类.md` | 研究类任务索引 |

## 索引关键词

| 关键词 | 映射路径 | 说明 |
|--------|----------|------|
| 核心索引 | `memory/核心索引.md` | 顶层快速入口 |
| 项目索引 | `memory/项目索引/` | 按项目分类 |
| 类型索引 | `memory/类型索引/` | 按类型分类 |

## 使用示例

**场景1**：用户说"继续创作天道养殖场"
→ 检索关键词"天道养殖场" → 定位项目 → 检查活跃任务 → 获取第091章规划

**场景2**：用户说"查看当前任务"
→ 检索关键词"活跃任务" → 定位活跃任务列表

**场景3**：用户说"查一下之前的编码任务"
→ 检索关键词"编码开发" → 定位编码类索引

---

*维护说明：新增文件时同步更新此表*

FILE:references/对接规范.md
# 外部 Skill 对接规范

## 总则

web-novel-creator 作为兼容协调层，不干涉各 Skill 的内部工作流程。只在创作完成后介入归档和索引更新。

## 对接 novel-generator

### novel-generator 原生产出
- 正文：`output/第X章.md`
- 记忆：`.learnings/CHARACTERS.md`、`.learnings/LOCATIONS.md`、`.learnings/PLOT_POINTS.md`
- 图谱：`output/角色关系图.mermaid` 等

### 对接步骤
1. novel-generator 的创作流程完成（输出到 `output/`）
2. web-novel-creator 将 `output/` 中的正文移动到 `正文/第XXX章.md`
3. `.learnings/` 保留在原位（已符合统一规范）
4. 生成该章的规划文件（如 novel-generator 未生成）
5. 更新标题库
6. 调用 Memory Manager Pro

### 注意事项
- novel-generator 不生成 `规划/` 目录 —— 兼容层负责补充规划文件
- novel-generator 的自有记忆系统和兼容层的索引系统是互补关系
- novel-generator 的 output/ 中的图解文件（mermaid）可保留在 `output/` 下

## 对接 open-novel-writing

### open-novel-writing 原生产出
- 正文：`novel/{项目名}/正文/第X章.md`（兼容规范 ✅）
- 设定：`novel/{项目名}/设定/世界观.md`、`novel/{项目名}/设定/人物/`
- 规划：`novel/{项目名}/规划/第X章spec.md`
- 评审：`novel/{项目名}/审查反馈.md`

### 对接步骤
1. open-novel-writing 完成创作（正文已写入兼容位置）
2. 检查 `规划/` 中是否有 `.md` 文件（可能命名为 `第X章spec.md` 而非 `第X章规划.md`）
3. 如文件名不统一，可以重命名为 `第X章规划.md` 或保留原样（兼容）
4. 检查标题库是否更新，未更新则补录
5. 调用 Memory Manager Pro

### 注意事项
- open-novel-writing 的输出基本兼容统一规范，兼容层只需做命名微调
- open-novel-writing 生成的评审文件不归入索引，保留在原位供用户查看

## 对接 novel-orchestrator

### novel-orchestrator 原生产出
- 正文：`novel/{项目名}/正文/`（由 writer agent 写入）
- 规划：`novel/{项目名}/规划/`（由 planner agent 写入）
- 审查：通过 checker agent 的审查流程

### 对接步骤
1. novel-orchestrator 的 checker 通过审查后
2. 检查 `正文/` 中是否有新章节
3. 检查标题库是否更新
4. 调用 Memory Manager Pro

### 注意事项
- novel-orchestrator 有自己的审核循环，兼容层**不介入**审核流程
- 只在 checker 判定通过后才介入归档
- novel-orchestrator 不依赖标题库，兼容层需要确保标题库被更新

## 对接 cq-novel-writer

### cq-novel-writer 原生产出
- 正文：`novel/` 根目录（文件名可能不规范）
- 总纲：`novel/故事总纲.md`

### 对接步骤
1. cq-novel-writer 完成创作
2. 扫描 `novel/` 根目录，找到新增的正文文件
3. 将文件移动到 `novel/{项目名}/正文/第XXX章.md`（统一命名）
4. 更新故事总纲中的章节记录
5. 调用 Memory Manager Pro

### 注意事项
- cq-novel-writer 的目录规范最"原始"，兼容层需要做最多的迁移工作
- 需要手动识别新增的正文文件（可通过文件大小或修改时间判断）

## 对接其他 Skill

### 通用对接流程

```markdown
1. 识别 Skill
   → 通过检测标识文件/目录判断

2. 迁移产出
   → 确保正文在 novel/{项目名}/正文/ 下
   → 确保规划在 novel/{项目名}/规划/ 下（如存在）
   → 确保标题库已更新

3. 更新记忆系统
   → 调用 Memory Manager Pro 完成索引更新

4. 确认兼容
   → 修改 .skill-detect 文件，记录哪些 Skill 在本项目中被检测到过
```

FILE:references/番茄小说规范.md
# 番茄小说平台规范

## 基本规范

### 字数要求
- **单章字数**：2000-3000字（中文字符）
- **日更要求**：建议每日2-3章
- **总字数**：长篇建议100万字以上

### 格式要求

#### 章节结构
- ✅ 使用 `# 第XXX章 标题` 作为章节标题
- ❌ 不使用二级标题（##）
- ❌ 不使用三级标题（###）
- ❌ 不使用数字序号（1. 2. 3.）
- ✅ 自然段落过渡

#### 排版规范
- 段落长度适中，避免过长段落
- 对话单独成段
- 场景转换使用空行分隔

## 标题规范

### 格式
```
# 第XXX章《标题名》
```

### 命名规则
1. **不得重复**：同一本书内标题必须唯一
2. **爽点前置**：标题中包含冲突、悬念、反转
3. **简洁有力**：4-8个字为宜
4. **符合题材**：玄幻、修仙、都市等风格统一

### 好标题示例
- 《第七层觉醒》✓
- 《本源具现》✓
- 《真相浮现》✓
- 《一掌灭宗门》✓
- 《逆天改命》✓

### 差标题示例
- 《第一章》✗
- 《继续修炼》✗
- 《又过了一天》✗
- 《没什么事发生》✗

## 内容规范

### 爽点设置
- **每章必须有爽点**：打脸、突破、收获、反转
- **爽点密度**：2-3个/章
- **大高潮节奏**：每10章一个大高潮

### 节奏把控
- **开篇**：快速进入冲突，不要铺垫过长
- **中段**：保持紧张感，持续升级
- **结尾**：悬念收尾，引导阅读下一章

### 人设要求
- 主角：果断、护短、有情有义
- 反派：有智商、有背景、有威胁
- 配角：各有特色，不脸谱化

## 平台禁忌

### 禁止内容
- 色情低俗描写
- 血腥暴力过度渲染
- 政治敏感内容
- 抄袭剽窃
- 恶意攻击

### 敏感词规避
- 使用委婉表达
- 关键场景留白处理
- 敏感词替换为代号

## 签约标准

### 黄金三章
- 第1章：主角出场，金手指/困境
- 第2章：冲突升级，展示能力
- 第3章：首次打脸/收获，建立期待

### 签约要点
1. 开篇节奏快，不拖沓
2. 金手指清晰，有期待感
3. 主角性格讨喜，有代入感
4. 世界架构清晰，有扩展性
5. 持续更新，不断更

## 数据指标

### 关键指标
- **读完率**：前三章读完率>60%
- **留存率**：次日留存>30%
- **书架率**：加书架率>10%
- **评论率**：有效评论>1%

### 优化建议
- 根据数据调整节奏
- 关注读者反馈
- 保持更新稳定性
- 适时调整剧情走向

## 创作工具

### 章节规划
- 使用规划模板
- 预设剧情要点（8-10个）
- 设置伏笔和悬念

### 标题管理
- 建立标题库
- 定期检查重复
- 备选标题准备

### 记忆索引
- 使用三级索引架构
- 关键词快速定位
- 标签系统管理

FILE:references/规划模板.md
# 章节规划模板

## 基本信息
- **章节号**：第XXX章
- **建议标题**：（需检查与已用标题库无重复）
- **字数目标**：2200-2800字
- **格式要求**：无小标题，自然段落过渡

## 核心冲突
（简要描述本章的主要矛盾和冲突点）

## 剧情要点（8-10个）
1. 
2. 
3. 
4. 
5. 
6. 
7. 
8. 
9. 
10. 

## 伏笔设置
1. 
2. 
3. 
4. 
5. 

## 标题备选（需检查重复）
1. 《》
2. 《》
3. 《》
4. 《》
5. 《》

---
**规划生成时间**：
**规划状态**：待使用/已完成
**关联章节**：承接第XXX章，开启第XXX章伏笔