novelws 3.1.0 → 5.0.0

package/templates/commands/tasks.md

@@ -1,396 +0,0 @@
----
-description: 将创作计划分解为可执行的任务清单
-allowed-tools: Read(//stories/**/creative-plan.md), Read(//stories/**/creative-plan.md), Read(//stories/**/specification.md), Read(//stories/**/specification.md), Write(//stories/**/tasks.md), Write(//stories/**/tasks.md), Bash(find:*), Bash(*)
-scripts:
-  sh: .specify/scripts/bash/tasks-story.sh
-  ps: .specify/scripts/powershell/generate-tasks.ps1
----
-
-基于创作计划生成具体的、可执行的任务列表。
-
-## 资源加载（可选）
-
-本命令用于管理创作任务，默认不加载额外资源。
-
-### 可选配置
-
-如果需要在任务规划时参考写作技巧：
-
-```yaml
-resource-loading:
-  tasks:
-    knowledge-base:
-      craft:
-        - scene-structure  # 场景结构规划
-        - pacing  # 节奏规划
-```
-
-**推荐资源**: scene-structure.md, pacing.md（辅助任务规划）
-
----
-
-## Tracking 数据加载策略
-
-在 `--from-plan` 模式下，需要读取 tracking 数据生成修复/维护任务，采用 **三层回退** 机制：
-
-### Layer 3: MCP 查询（优先）
-
-```typescript
-// 如果 MCP 已启用且数据已同步
-// 获取延迟伏笔
-const overduePlots = await mcp.call('novelws-mcp/query_plot', {
-  status: 'overdue',      // 紧急度 > 0.9 或已超期
-  volume: 'vol-03'        // 可选：仅查询指定卷
-});
-
-// 获取卷进度统计
-const volumeStats = await mcp.call('novelws-mcp/stats_volume', {
-  volume: 'vol-03'
-});
-
-// 获取角色缺席情况
-const characters = await mcp.call('novelws-mcp/query_characters', {
-  volume: 'vol-03',
-  absent: true            // 仅返回长期缺席的角色
-});
-```
-
-**优势**：
-- 高性能聚合查询（自动计算紧急度）
-- 跨卷数据对比
-- 自动过滤需要关注的项
-
-### Layer 2: 分片 JSON（次优）
-
-```bash
-# 当 spec/tracking/volumes/ 存在时
-# 读取摘要数据
-plot_summary=$(cat spec/tracking/summary/plot-summary.json)
-
-# 提取未解决伏笔和紧急伏笔
-unresolved_plots=$(echo "$plot_summary" | jq '.unresolved')
-urgent_plots=$(echo "$plot_summary" | jq '.urgent')
-
-# 读取角色摘要
-character_summary=$(cat spec/tracking/summary/characters-summary.json)
-absent_characters=$(echo "$character_summary" | jq '.absent')
-```
-
-**适用场景**：
-- MCP 未启用或同步延迟
-- 摘要数据已足够生成任务
-- 需要快速扫描全局状态
-
-### Layer 1: 单文件 JSON（兜底）
-
-```bash
-# 传统模式，加载完整文件并手动过滤
-plot_tracker=$(cat spec/tracking/plot-tracker.json)
-character_state=$(cat spec/tracking/character-state.json)
-
-# 手动计算紧急度、缺席章节等
-```
-
-**向下兼容**：小型项目（< 300 章）使用单文件模式
-
-### 从 Tracking 数据生成任务的规则
-
-| 数据来源 | 生成的任务类型 | 优先级 | 条件 |
-|---------|--------------|--------|------|
-| plot-tracker | 伏笔回收任务 | P0-P2 | 紧急度 > 0.5 |
-| character-state | 角色出场任务 | P1-P2 | 缺席章节数 > 阈值 |
-| /analyze 反馈 | 修复任务 | P0-P1 | 存在错误或冲突 |
-| tracking 落后 | 数据同步任务 | P1 | 落后章节数 > 2 |
-
-### 使用示例
-
-```bash
-# 从计划生成任务（包含 tracking 数据分析）
-/tasks --from-plan
-
-# 生成的任务示例：
-# [P0] 回收伏笔"身世之谜"（已延迟 5 章，紧急度 0.95）
-# [P1] 安排师姐出场（已缺席 8 章）
-# [P1] 同步 tracking 数据（落后 3 章）
-```
-
----
-
-## 目标
-
-将宏观计划转化为微观任务，让创作变得可管理、可追踪。
-
-## 执行步骤
-
-### 1. 加载计划文档
-
-运行 `{SCRIPT}` 加载：
-- 创作计划：`stories/*/creative-plan.md`
-- 章节架构信息
-- 时间线和依赖关系
-
-### 2. 生成任务列表
-
-创建 `stories/*/tasks.md`，包含：
-
-#### 核心写作任务
-
-**重要**：从specification.md第五章和creative-plan.md的线索分布，为每个写作任务标注涉及线索。
-
-```markdown
-## 写作任务
-
-### 高优先级 [必须首先完成]
-
-- [ ] [P0] **T001** - 第1章：[章节标题] (目标字数)
-  - **核心任务**：[本章的主要任务]
-  - **关键情节**：[具体情节点]
-  - **涉及线索**：
-    - PL-XX([线索名称]) ⭐⭐⭐ 主推进
-    - PL-YY([线索名称]) ⭐ 背景
-  - **交汇点**：[如适用] X-001([交汇点描述])
-  - **伏笔埋设/揭晓**：[如适用] F-001埋设 / F-002揭晓
-  - **必须包含**：[关键元素列表]
-  - **章末钩子**：[悬念设置]
-  - **依赖**：无
-  - **输出**：`content/volume1/chapter-001.md`
-
-- [ ] [P0] **T002** - 角色档案：主角详细设定
-  - **核心任务**：完善主角设定
-  - **必须包含**：性格、背景、能力、欲望、恐惧、成长弧线
-  - **依赖**：无
-  - **输出**：`characters/protagonist.md`
-
-### 中优先级 [正常推进]
-
-- [ ] [P1] **T005** - 第5章：[章节标题] (目标字数)
-  - **核心任务**：[本章主要任务]
-  - **关键情节**：[具体情节]
-  - **涉及线索**：
-    - PL-01([线索名]) ⭐⭐⭐ 主推进
-    - PL-02([线索名]) ⭐⭐ 辅助
-  - **交汇点**：无
-  - **伏笔埋设/揭晓**：F-001埋设([伏笔内容])
-  - **必须包含**：[关键元素]
-  - **章末钩子**：[悬念]
-  - **依赖**：T004(第4章)
-  - **输出**：`content/volume1/chapter-005.md`
-
-### 低优先级 [可选完善]
-
-- [ ] [P2] 番外：角色前传
-- [ ] [P2] 设定集：详细世界观
-```
-
-**任务字段说明**：
-- **涉及线索**：从creative-plan.md的"活跃线索"列读取，标明本章推进哪些线索
-- **交汇点**：从specification.md 5.3节读取，标明本章是否为交汇点
-- **伏笔埋设/揭晓**：从specification.md 5.4节读取，标明本章涉及的伏笔操作
-
-#### 任务标记说明
-- `[P]` - 可并行执行
-- `[依赖:X]` - 需要先完成任务X
-- `[P0/P1/P2]` - 优先级标记
-
-### 3. 任务排序和分组
-
-- 按优先级分组
-- 识别依赖关系
-- 标记可并行任务
-- 估算完成时间
-
-### 4. 生成执行计划
-
-```markdown
-## 执行计划
-
-### 第一阶段（第1周）
-并行任务组1：
-- 主角设定 [P]
-- 世界观基础 [P]
-- 第1章草稿 [P]
-
-### 第二阶段（第2-3周）
-串行任务：
-- 第2章 [依赖:第1章]
-- 第3章 [依赖:第2章]
-
-并行任务组2：
-- 配角设定 [P]
-- 场景设计 [P]
-```
-
-### 5. 输出任务统计
-
-- 总任务数
-- 预计总字数
-- 预计完成时间
-- 关键里程碑
-
-提示下一步：开始执行 `/write` 或查看特定任务详情。
-
----
-
-## 增强功能
-
-### 任务优先级
-
-每个任务可设置优先级，用于排序和筛选：
-
-| 优先级 | 标记 | 含义 |
-|--------|------|------|
-| P0 | 🔴 | 紧急：阻塞写作进度 |
-| P1 | 🟠 | 重要：影响质量但不阻塞 |
-| P2 | 🟡 | 普通：常规写作任务 |
-| P3 | 🟢 | 低优：优化/润色类 |
-
-#### 优先级排序视图
-
-**触发条件**：`$ARGUMENTS` 包含 `--by-priority`
-
-```
-📋 任务列表（按优先级）
-━━━━━━━━━━━━━━━━━━━━
-
-🔴 P0 紧急：
-  □ 回收「身世之谜」伏笔（已延迟 5 章）
-  □ 修复第 18 章时间线冲突
-
-🟠 P1 重要：
-  □ 写第 26 章（主线推进）
-  □ 安排师姐出场（已缺席 7 章）
-
-🟡 P2 普通：
-  □ 写第 27 章
-  □ 补充城主之女的背景设定
-
-🟢 P3 低优：
-  ☑ 润色第 20 章对话
-  □ 更新角色关系图
-```
-
-### 任务依赖关系
-
-任务之间可以设置依赖关系，支持显式依赖和自动检测：
-
-#### 依赖关系图
-
-```
-📋 任务依赖图
-━━━━━━━━━━━━━━━━━━━━
-
-[完善力量体系设定] ──→ [写第 26 章战斗场景]
-                          │
-                          ↓
-                    [写第 27 章战后处理] ──→ [写第 28 章新篇章]
-
-[安排师姐出场] ──→ [写第 26 章]（师姐在此章出场）
-
-⚠️ 阻塞任务：
-- 「完善力量体系设定」阻塞了 3 个下游任务
-  → 建议优先处理
-```
-
-#### 自动依赖检测
-
-自动检测以下隐含依赖：
-
-| 依赖类型 | 检测规则 |
-|---------|---------|
-| 章节顺序 | 第 N+1 章自动依赖第 N 章 |
-| 设定依赖 | 引用某设定的写作任务依赖该设定的完善任务 |
-| 伏笔依赖 | 伏笔回收任务依赖伏笔埋设任务 |
-| 角色依赖 | 角色出场任务依赖角色设定完善任务 |
-
-### 从计划自动生成任务
-
-**触发条件**：`$ARGUMENTS` 包含 `--from-plan`
-
-**执行流程**：
-1. 读取 `creative-plan.md`
-2. 提取每章的计划内容
-3. 为每章生成一个写作任务
-4. 自动设置依赖关系（顺序依赖）
-5. 按三层 Fallback 读取 tracking 数据生成修复/维护任务：
-   - **MCP 查询（优先）**：`query_plot --status=overdue` 获取延迟伏笔，`stats_volume` 获取进度
-   - **分片 JSON（次优）**：读取 `spec/tracking/summary/plot-summary.json` 获取未解决伏笔
-   - **单文件 JSON（兜底）**：读取 `spec/tracking/plot-tracker.json`
-6. 从 `/analyze` 反馈中提取修复任务
-7. 从 `/track --check` 中提取维护任务
-
-#### 生成规则
-
-| 来源 | 生成的任务类型 | 优先级 |
-|------|--------------|--------|
-| 章节计划 | 写作任务 | P2 |
-| 伏笔回收计划 | 伏笔任务 | 根据紧急度 P0-P2 |
-| 角色出场计划 | 角色任务 | P1-P2 |
-| 分析反馈 | 修复任务 | P0-P1 |
-| tracking 落后 | 维护任务 | P1 |
-
-#### 输出示例
-
-```
-📋 从计划生成任务
-━━━━━━━━━━━━━━━━━━━━
-
-已生成 8 个任务：
-
-🟡 P2 写作任务（5 个）：
-  □ 写第 26 章：师姐出场 + 主角突破
-  □ 写第 27 章：新敌人登场
-  □ 写第 28 章：情报收集
-  □ 写第 29 章：潜入敌营
-  □ 写第 30 章：卷末高潮
-
-🟠 P1 伏笔任务（2 个）：
-  □ 在第 26 章回收「身世之谜」伏笔
-  □ 在第 28 章埋设「远古秘密」伏笔
-
-🔴 P0 修复任务（1 个）：
-  □ 修复第 18 章时间线冲突
-
-是否确认生成？[Y/N]
-```
-
-### 任务完成度统计
-
-**触发条件**：`$ARGUMENTS` 包含 `--stats`
-
-```
-📊 任务统计
-━━━━━━━━━━━━━━━━━━━━
-
-总任务：[N] 个
-  ✅ 已完成：[A] 个（[X]%）
-  🔄 进行中：[B] 个
-  ⏳ 待办  ：[C] 个
-  ❌ 已取消：[D] 个
-
-按优先级：
-  🔴 P0：[完成]/[总数]
-  🟠 P1：[完成]/[总数]
-  🟡 P2：[完成]/[总数]
-  🟢 P3：[完成]/[总数]
-
-按类型：
-  写作任务：[完成]/[总数]
-  修复任务：[完成]/[总数]
-  维护任务：[完成]/[总数]
-
-进度条：▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░ [X]%
-```
-
----
-
-
-## 🔗 命令链式提示
-
-**命令执行完成后，自动附加下一步建议**：
-
-```
-💡 下一步建议：
-1️⃣ `/write [章节号]` — 开始执行第一个写作任务
-2️⃣ `/analyze --type=framework` — 写作前验证框架一致性
-3️⃣ `/track-init` — 初始化追踪系统（如尚未初始化）
-```

package/templates/commands/timeline.md

@@ -1,309 +0,0 @@
----
-name: timeline
-description: 管理和验证故事时间线
-argument-hint: [add | check | show | sync] [--volume vol-XX | --recent N]
-allowed-tools: Read(//spec/tracking/timeline.json), Read(//spec/tracking/timeline.json), Write(//spec/tracking/timeline.json), Write(//spec/tracking/timeline.json), Read(//stories/**/content/**), Read(//stories/**/content/**), Bash(find:*), Bash(*)
-scripts:
-  sh: .specify/scripts/bash/check-timeline.sh
-  ps: .specify/scripts/powershell/check-timeline.ps1
----
-
-# 时间线管理
-
-维护故事的时间轴，确保时间逻辑的一致性。
-
-## 资源加载（可选）
-
-本命令用于管理故事时间线，默认读取 `tracking/timeline.json`。
-
-### 可选配置
-
-```yaml
-resource-loading:
-  timeline:
-    knowledge-base:
-      craft:
-        - pacing  # 时间节奏控制
-    skills:
-      quality-assurance:
-        - consistency-checker  # 时间线一致性检查
-```
-
-**推荐资源**: pacing.md（时间节奏控制）
-
-## 数据加载策略
-
-本命令采用 **三层回退** 机制加载时间线数据：
-
-### Layer 3: MCP 查询（优先）
-
-```typescript
-// 如果 MCP 已启用且数据已同步
-const events = await mcp.call('novelws-mcp/query_timeline', {
-  volume: 'vol-03',     // --volume 参数
-  limit: 50             // --recent 参数
-});
-```
-
-**优势**：
-- 高性能范围查询（volume/时间范围过滤）
-- 支持 FTS5 全文搜索事件描述
-- 自动聚合统计（时间跨度、事件密度）
-
-### Layer 2: 分片 JSON（次优）
-
-```bash
-# 当 spec/tracking/volumes/ 存在时
-timeline_data=$(cat spec/tracking/volumes/vol-03/timeline.json)
-```
-
-**适用场景**：
-- MCP 未启用或同步延迟
-- 需要精确章节级别的时间戳
-- 手动编辑 JSON 后即时查看
-
-### Layer 1: 单文件 JSON（兜底）
-
-```bash
-# 传统模式，加载完整文件
-timeline_data=$(cat spec/tracking/timeline.json)
-```
-
-**向下兼容**：小型项目（< 300 章）继续使用单文件模式
-
-### 参数过滤行为
-
-- **`--volume vol-XX`**: 仅加载指定卷的时间线事件（Layer 3/2 生效，Layer 1 需手动过滤）
-- **`--recent N`**: 显示最近 N 个事件（Layer 3 直接限制，Layer 1/2 取最后 N 条）
-
-## 功能
-
-1. **时间记录** - 追踪每个章节的时间点
-2. **并行事件** - 管理同时发生的多线剧情
-3. **历史对照** - 与真实历史事件对比（历史小说）
-4. **逻辑验证** - 检查时间跨度的合理性
-
-## 使用方法
-
-执行脚本 {SCRIPT}，支持以下操作：
-
-### 子命令
-
-- **`add`** - 添加时间节点
-  - 在指定章节记录时间戳
-  - 支持 `--volume` 自动写入对应卷分片
-
-- **`check`** - 验证时间连续性
-  - 检测时间冲突（顺序、并行、持续、跳跃、年龄）
-  - `--volume vol-XX`: 仅检查指定卷
-  - `--recent N`: 仅检查最近 N 个事件
-
-- **`show`** - 显示时间线概览
-  - 生成单线或多线程时间轴可视化
-  - `--volume vol-XX`: 仅显示指定卷事件
-  - `--recent N`: 仅显示最近 N 个事件
-
-- **`sync`** - 同步并行事件
-  - 对齐多线程叙事的时间点
-  - 标记线程交汇点
-
-## 时间线数据
-
-时间线信息存储在 `spec/tracking/timeline.json` 中：
-- 故事内时间（年/月/日）
-- 章节对应关系
-- 重要事件标记
-- 时间跨度计算
-
-## 示例输出
-
-```
-📅 故事时间线
-━━━━━━━━━━━━━━━━━━━━
-当前时间：万历三十年春
-
-第1章  | 万历二十九年冬月 | 穿越事件
-第4章  | 万历三十年正月   | 北上赴考
-第6章  | 万历三十年二月   | 会试
-第8章  | 万历三十年三月   | 殿试
-第61章 | 万历三十年四月   | [待写]
-
-⏱️ 时间跨度：5个月
-🔄 并行事件：日本入侵朝鲜
-```
-
-## 数据写入协议
-
-时间线数据更新遵循以下协议：
-
-### 分片模式（spec/tracking/volumes/ 存在）
-
-1. **确定目标卷**：
-   - 如果命令指定 `--volume vol-XX`，写入对应卷
-   - 如果基于章节号（如 `add` 命令），根据章节号确定卷：
-     ```bash
-     # 示例：ch-042 属于 vol-02（假设每卷 50 章）
-     volume_num=$((chapter_num / 50 + 1))
-     target_volume="vol-$(printf '%02d' $volume_num)"
-     ```
-
-2. **写入分片文件**：
-   ```bash
-   # 写入指定卷的 timeline.json
-   Write(spec/tracking/volumes/${target_volume}/timeline.json)
-   ```
-
-3. **更新全局摘要**（如果事件跨度影响摘要统计）：
-   ```bash
-   # 更新 timeline-summary.json 的统计信息
-   Write(spec/tracking/summary/timeline-summary.json)
-   ```
-
-4. **触发 MCP 同步**（如果启用）：
-   ```bash
-   mcp-cli call novelws-mcp/sync_from_json '{
-     "mode": "incremental",
-     "tables": ["events"]
-   }'
-   ```
-
-### 单文件模式（传统）
-
-直接写入完整 `timeline.json`：
-```bash
-Write(spec/tracking/timeline.json)
-```
-
-### 写入示例
-
-```typescript
-// add 命令：添加时间节点到第 42 章
-const chapterNum = 42;
-const volumeNum = Math.floor((chapterNum - 1) / 50) + 1;
-const targetVolume = `vol-${String(volumeNum).padStart(2, '0')}`;
-
-// 读取目标卷的 timeline 分片
-const timelinePath = isSharded
-  ? `spec/tracking/volumes/${targetVolume}/timeline.json`
-  : 'spec/tracking/timeline.json';
-
-const timeline = JSON.parse(fs.readFileSync(timelinePath));
-
-// 添加新事件
-timeline.events.push({
-  chapter: 'ch-042',
-  date: '万历三十年四月十五',
-  description: '主角突破筑基期',
-  type: 'major'
-});
-
-// 写回分片
-fs.writeFileSync(timelinePath, JSON.stringify(timeline, null, 2));
-
-// 同步到 MCP（如果启用）
-if (mcpEnabled) {
-  await mcp.call('novelws-mcp/sync_from_json', {
-    mode: 'incremental',
-    tables: ['events']
-  });
-}
-```
-
----
-## 增强功能
-
-### 时间线可视化
-
-#### 单线时间线视图
-
-```
-📅 故事时间线
-━━━━━━━━━━━━━━━━━━━━
-
-[年份/日期]  [事件]                    [章节]
-─────────────────────────────────────────────
-第 1 天      主角入学                   第 1 章
-  │
-第 1 天      遇到师姐                   第 1 章
-  │
-第 3 天      第一次修炼                 第 2 章
-  │
-第 7 天      突破练气一层               第 3 章
-  ┊ (跳跃：20 天)
-第 27 天     参加门派考核               第 4 章
-  │
-第 27 天     与反派初次冲突             第 4 章
-  │
-第 30 天     外出历练                   第 5 章
-  ┊ (跳跃：60 天)
-第 90 天     历练归来                   第 8 章
-```
-
-#### 多线程时间对齐视图
-
-当故事有多条叙事线时，展示各线在同一时间轴上的对齐情况：
-
-```
-📅 多线程时间线
-━━━━━━━━━━━━━━━━━━━━
-
-时间        主线（主角）      支线1（角色B）    支线2（角色C）
-──────────────────────────────────────────────────────────
-第 1 天     入学 [ch1]        —                 —
-第 3 天     修炼 [ch2]        —                 —
-第 7 天     突破 [ch3]        出发 [ch4]        —
-第 15 天    —                 到达 [ch5]        接到任务 [ch6]
-第 20 天    考核 [ch7]        调查 [ch8]        出发 [ch9]
-第 27 天    冲突 [ch10]       发现线索 [ch11]   ★ 与主角相遇 [ch10]
-```
-
-**时间对齐规则**：
-- 同一天发生的事件对齐在同一行
-- `—` 表示该线在此时间点无活动
-- `★` 标记线程交汇点
-- 时间跳跃用 `┊` 表示
-
-### 时间冲突检测
-
-自动检测以下类型的时间冲突：
-
-| 冲突类型 | 描述 | 示例 |
-|---------|------|------|
-| 顺序冲突 | 事件 A 应在事件 B 之前，但章节顺序相反 | 第 5 章写「三天后」，第 6 章写「昨天」 |
-| 并行冲突 | 同一角色同一时间出现在两个地点 | 角色A 在第 10 章（第 5 天）在城东，第 11 章（第 5 天）在城西 |
-| 持续冲突 | 事件持续时间与描述不符 | 「三天的旅程」但只写了一个场景 |
-| 跳跃冲突 | 时间跳跃期间有未交代的事件 | 跳过 30 天，但期间应有门派考核 |
-| 年龄冲突 | 角色年龄与时间线不符 | 开篇 16 岁，一年后仍写 16 岁 |
-
-#### 冲突报告格式
-
-```
-⚠️ 时间冲突检测
-━━━━━━━━━━━━━━━━━━━━
-
-🔴 严重冲突：
-1. 并行冲突：角色A 在第 5 天同时出现在两个地点
-   - 第 10 章：角色A 在城东战斗
-   - 第 11 章：角色A 在城西购物（同一天）
-   → 建议：调整第 11 章时间为第 6 天
-
-⚠️ 轻微冲突：
-2. 持续冲突：第 5-8 章描述「三天旅程」，但内容只覆盖 1 天
-   → 建议：补充旅途中的场景，或缩短旅程时间
-
-💡 提示：
-3. 时间跳跃：第 8-9 章之间跳过 60 天
-   → 确认：这 60 天内是否有需要交代的事件？
-```
-
----
-## 🔗 命令链式提示
-
-**命令执行完成后，自动附加下一步建议**：
-
-```
-💡 下一步建议：
-1️⃣ `/write [章节号]` — 时间线确认无误，继续写作
-2️⃣ `/track --check` — 执行深度一致性检查（含时间线验证）
-3️⃣ `/analyze --focus=logic` — 深度查找时间线逻辑漏洞
-```