@clawhub-guojiuben-817f19c816
Professional memory indexing and task management system for OpenClaw. Provides three-level indexing (core→project/type→detail), task tracking, keyword mappin...
---
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*
```
网文创作兼容协调层。 定位:不做一个独立的创作引擎,而是让现有的优秀创作Skill(如 novel-generator、open-novel-writing、novel-orchestrator 等)能够无缝对接 Memory Manager Pro 的索引系统。 核心价值:(1) 提供统一的项目目录规范,让各S...
---
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章伏笔