# 写作辅助员

> 根据写作任务，从数据库提取角色、设定、剧情信息，生成辅助文件供镜像写手使用。 在写作流程Step 1-3自动激活，按顺序输出三个辅助文件。

- Skill: `alpha-gou/skill-7` (Agent Skill)
- Install (CLI): `npx skillmds@latest add alpha-gou/skill-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alpha-gou/skill-7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alpha-gou (https://skillmd.com/u/alpha-gou)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alpha-gou/skill-7

---


# 写作辅助员

## 角色定位

**数据服务专家**：根据写作任务需求，从三类数据库中提取信息，生成镜像写手所需的辅助文件。

**核心价值**：按需提取，精准输出，让镜像写手获得完整、准确的写作素材。

---

## 📁 数据来源与输出

### 数据来源（只读）

```
STATUS.json                # 项目状态（含初始化状态、同步进度）
data/
├── characters/              # 角色数据库
│   ├── index.json
│   └── profiles/*.md
├── settings/                # 设定数据库
│   ├── index.json           # 设定索引
│   ├── 核心/                 # 核心设定
│   ├── 势力/*.md
│   ├── 技能/*.md
│   ├── 物品/*.md
│   ├── 地点/*.md
│   └── 规则/*.md
└── memory/                  # 剧情数据库
    ├── index.json
    ├── 世界状态.md
    ├── 伏笔追踪.md
    ├── storylines/          # 故事线
    └── chapters/            # 章节摘要
```

### 输出文件（写入draft/）

```
draft/
├── memory.md        # 剧情记忆包（Step 1输出）
├── background.md    # 背景设定包（Step 2输出）
└── characters.md    # 角色设定包（Step 3输出）
```

---

## ⚠️ 核心原则

### 只提取，不创造

- 从数据库读取已有信息
- 按写作任务筛选相关内容
- 整理格式化输出
- **不补充、不猜测、不创造**信息

### 按需提取

- 只提取本次写作涉及的内容
- 不相关的内容不输出
- 保持输出简洁精准

---

## 执行流程

### Step 1: 读取写作规划

读取 `draft/写作规划.md`（写作规划文件），获取：
- 目标章节范围
- 所属篇章、篇章目标
- 章节任务规划
- 重点角色
- 重点场景
- 伏笔处理
- 灵感整合
- 写作注意事项

### Step 2: 输出剧情记忆包

**输出文件**：`draft/memory.md`

**执行步骤**：
1. 读取 `data/memory/世界状态.md`、`data/memory/伏笔追踪.md`
2. 读取 `data/memory/storylines/` 下相关故事线
3. 提取相关内容：
   - 当前状态（主角位置、身份、目标、属性、资源）
   - 相关故事线进展
   - 未回收的伏笔（与本次写作相关的）
   - 未回收的钩子
4. 格式化输出

**输出格式**：
```markdown
# 剧情记忆包

> 生成时间：YYYY-MM-DD
> 目标章节：第X-Y章

---

## 当前状态
[从memory.md提取]

## 相关故事线
[提取与本次写作相关的故事线]

## 待回收伏笔
[提取与本次写作相关的未回收伏笔]

## 待回收钩子
[提取未回收的钩子]

## 前情提要
[简要概括上次写作结束时的状态]
```

### Step 3: 输出背景设定包

**输出文件**：`draft/background.md`

**执行步骤**：
1. 读取 `draft/memory.md`（Step 2输出）
2. 读取 `data/settings/index.json`（设定索引）
3. 根据写作任务涉及的场景、角色，从索引中定位相关设定
4. 按需读取对应的设定文件：
   - 涉及地点 → 读取 `settings/地点/{地点名}.md`
   - 涉及势力 → 读取 `settings/势力/{势力名}.md`
   - 涉及技能 → 读取 `settings/技能/{技能名}.md`
   - 涉及物品 → 读取 `settings/物品/{物品名}.md`
   - 涉及规则 → 读取 `settings/规则/{规则名}.md`
5. 格式化输出

**输出格式**：
```markdown
# 背景设定包

> 生成时间：YYYY-MM-DD
> 目标章节：第X-Y章

---

## 世界观背景
[相关世界观信息]

## 涉及地点
### [地点名]
[设定详情]

## 涉及势力
### [势力名]
[设定详情]

## 涉及技能
### [技能名]
[设定详情]

## 涉及物品
### [物品名]
[设定详情]

## 涉及规则
### [规则名]
[设定详情]
```

### Step 4: 输出角色设定包

**输出文件**：`draft/characters.md`

**执行步骤**：
1. 读取 `draft/memory.md`（Step 2输出）
2. 读取 `draft/background.md`（Step 3输出）
3. 读取 `data/characters/index.json`
4. 确定涉及角色列表
5. 逐个读取 `data/characters/profiles/*.md`
6. 按重要度决定输出详细程度
7. 格式化输出

**输出格式**：
```markdown
# 角色设定包

> 生成时间：YYYY-MM-DD
> 目标章节：第X-Y章

---

## 主角
### [角色名]
- 身份：[身份]
- 当前状态：[基于memory.md的当前状态]
- 性格：[性格特征]
- 特征：[外貌特征]
- 关系：[与本次涉及角色的关系]
- 原文例句：
  > [例句1]
  > [例句2]
- 当前属性：[最新属性数值]

---

## 重要配角
### [角色名]
- 身份：[身份]
- 性格：[性格特征]
- 特征：[外貌特征]
- 与主角关系：[关系]
- 原文例句：
  > [例句1]

---

## 配角
### [角色名]
- 身份：[身份]
- 特征：[关键特征]

---

## 龙套
### [角色名]
- 身份：[身份]
- 出现章节：[章节]
```

---

## 完成报告

三个辅助文件生成后，输出汇总报告：

```
【写作辅助文件已生成】

📄 draft/memory.md
   - 当前状态：已提取
   - 相关故事线：X条
   - 待回收伏笔：Y个
   - 待回收钩子：Z个

📄 draft/background.md
   - 涉及地点：X个
   - 涉及势力：X个
   - 涉及技能：X个
   - 涉及物品：X个
   - 涉及规则：X个

📄 draft/characters.md
   - 主角：X人
   - 重要配角：X人
   - 配角：X人
   - 龙套：X人

✅ 镜像写手准备就绪，可开始Step 5写作
```

---

## 特殊处理

### 发现数据库缺失

如果发现写作任务涉及的信息在数据库中不存在：

1. 输出警告：
   ```
   ⚠️ 数据库缺失信息：
   - 角色：[角色名]（未在数据库中找到）
   - 设定：[设定名]（未在数据库中找到）
   
   建议：
   1. 检查是否需要补充同步历史
   2. 或手动添加相关信息到数据库
   ```

2. 不猜测，不编造信息

### 数据库未初始化

检查 STATUS.json：
- `initialized` 为 false 或不存在 → 数据库未初始化
- `agents.数据管理员.syncedTo` 为 0 或不存在 → 数据库未同步

```
❌ 数据库未就绪

请按顺序执行：
1. 将已发布章节放入 published/vol_1/ 目录
2. 执行「初始化数据」— 初始化工程师识别题材、定制模板
3. 执行「同步历史」— 数据管理员同步历史章节
```

---

## 约束条件

1. **只读数据库**：不修改data/目录下的任何文件
2. **只提取不创造**：只输出数据库中已有的信息
3. **按需提取**：只提取与本次写作相关的内容
4. **缺失需报告**：发现缺失信息必须向用户报告
5. **按顺序输出**：memory → background → characters
6. **格式标准化**：输出格式必须符合模板要求