# long_task_protocol.md — 长线任务协作协议

本协议定义了小编与编剧在发起、执行、完成长线写作任务时的规范化协作流程。
每次会话启动时加载本文件，确保行为一致性。

---

## 一、触发条件

当编剧表现出**发起全新写作任务**的意图时触发。识别信号包括但不限于：

- "开始写Uxx"、"新Unit"、"新Lesson"
- "我要写一个新的…"、"开始一个新的剧本"
- "准备启动S2的…"

**注意：** 继续已有任务（"继续U23"、"接着写L3"等）不触发，直接进入执行流程。

---

## 二、两问流程

确认是新任务后，按序询问编剧两个问题：

### Q1：这次任务的目标是什么？

提供预设选项，供编剧快速选择：

| 选项 | 任务类型 | 典型场景 |
|------|----------|----------|
| A | 撰写完整Unit的长线任务 | 多个Lesson（起承转合），约2周 |
| B | 单个Lesson的独立任务 | 单次写作，成果独立 |
| C | 润色/修改已有剧本 | 在已有内容上修订 |
| D | 其他 | 编剧自定义描述 |

### Q2：是否需要为这次任务新建一个日志？

日志用于记录已完成的内容及进度。

- **是** → 进入「三、日志创建」流程
- **否** → 不创建日志。此后**不再追问 Q2**，直到编剧发起另一个**全新的**写作任务

---

## 三、日志创建

### 3.1 命名

编剧确认"是"后：

1. 请编剧给任务一个**简单易称呼的名称**（如 `U23完整剧本`、`L5润色`）
2. 日志文件创建在：`business_knowledge/task_log/{任务名称}.md`

### 3.2 日志模板

```markdown
# 任务日志：{任务名称}

- **创建时间：** YYYY-MM-DD HH:MM
- **创建者：** {编剧姓名}（{飞书user_id}）
- **任务目标：** {Q1的答案，如"撰写U23完整剧本（起承转合4个Lesson）"}
- **当前状态：** 进行中

---

## 进度记录

（按时间倒序，每次阶段性通过后追加一条）

### {日期} — {阶段性内容简述}

- **通过内容：** {通过的具体段落/步骤名称}
- **有效反馈：** {编剧给出的可复用指导意见}
```

### 3.3 注册到活跃任务索引

同步更新 `business_knowledge/active_tasks.md`，添加新任务条目。

---

## 四、进度更新规则

### 何时更新

每次取得**阶段性进展**后更新日志。阶段性进展的判定：

- 优先级最高：编剧明确说"通过"、"定稿"、"没问题了"
- 一个Lesson/Section通过 → 记录
- 一个关键决策达成 → 记录

### 更新内容（只记有效的）

| ✅ 记录 | ❌ 不记录 |
|---------|-----------|
| 已通过的段落名称/编号 + 通过时间 | 被退回的版本 |
| 编剧的有效反馈（指导性意见） | 被修改/删除的内容 |
| 关键决策和共识 | 中间修订过程 |

### 更新后

同步更新 `active_tasks.md` 中的进度摘要。

---

## 五、会话重置后恢复

编剧只需说以下任一关键词即可恢复：

- "继续{任务名称}" 或 "查{任务名称}进度"
- "我目前有哪些活跃任务？"

小编执行：

1. 读取 `active_tasks.md` 定位任务日志路径
2. 读取日志文件恢复上下文
3. 继续工作

---

## 六、任务完成流程

当编剧确认长线任务完成后：

### 6.1 汇总反馈清单

小编从本次任务日志中提取所有**关于角色、设定、写作规范的反馈**，整理为清单，逐条询问编剧：

> "本次任务完成。以下是从任务过程中收集的反馈，请确认哪些需要更新到知识库："
> 1. {反馈条目1}
> 2. {反馈条目2}
> ...

### 6.2 沉淀到知识库

编剧确认后，将选中条目更新到对应文件：

- 角色相关 → `business_knowledge/characters/` 对应角色文件
- 写作规范相关 → `business_knowledge/script_feedback_log.md`
- 通用规则 → `MEMORY.md`

### 6.3 归档

1. 在日志末尾标注"已完成"及完成时间
2. 从 `active_tasks.md` 移除该任务条目
3. 日志文件保留在 `task_log/` 目录，作为历史记录

---

## 七、与现有协作Pipeline的关系

本协议是现有协作Pipeline（大纲→节奏表→剧本→审阅→定稿）的**外层框架**，不替代Pipeline。日志记录的是Pipeline中"通过"的节点，而非Pipeline本身。
