novelws 4.0.0 → 5.1.0

package/templates/commands/analyze.md

@@ -1,290 +1,90 @@
 ---
-description: 智能分析：自动选择框架分析（write前）或内容分析（write后），支持 --type 手动指定
-argument-hint: [--type=framework|content] [--range ch-XXX-YYY | --volume vol-XX | --volume-report vol-XX]
-recommended-model: claude-sonnet-4-5-20250929 # 分析任务，质量与速度平衡；深度分析可用 opus
-allowed-tools: Bash(find:*), Bash(wc:*), Bash(grep:*), Read(//**), Read(//plugins/**), Read(//plugins/**), Write(//stories/**/analysis-report.md), Bash(*)
-scripts:
-  sh: resources/scripts/bash/check-analyze-stage.sh --json
-  ps: resources/scripts/powershell/check-analyze-stage.ps1 -Json
+description: 质量检查：对比概要与正文，检测一致性和AI味
+argument-hint: [章节号] [--range start-end]
+recommended-model: claude-sonnet-4-5-20250929
+allowed-tools: Read(//stories/**), Read(//tracking/**), Bash(ls:*)
 ---
 
-对小说项目进行智能化综合分析。根据当前创作阶段，自动选择执行**框架一致性分析**（write 之前）或**内容质量分析**（write 之后）。
+用户输入：$ARGUMENTS
 
----
-
-## 执行流程
-
-### 1. 智能阶段检测
-
-运行 `{SCRIPT}` 获取当前创作状态（返回 `analyze_type`, `chapter_count`, `has_spec/plan/tasks`, `story_dir`, `reason`）。
-
-### 2. 决策逻辑
-
-解析用户参数 `$ARGUMENTS`，按优先级：
-
-1. **手动指定**：`--type=framework` 或 `--type=content`
-2. **范围分析**：`--range ch-XX-YY` / `--range vol-XX[-YY]` / `--volume vol-XX` / `--volume-report vol-XX`
-3. **专项分析 `--focus=`**：`opening`(前3章) | `pacing`(爽点/冲突) | `character`(人物弧光) | `foreshadow`(伏笔) | `logic`(逻辑漏洞) | `style`(文笔一致性) | `reader`(读者体验) | `hook`(钩子强度) | `power`(力量体系) | `voice`(对话一致性)
-4. **自动判断**：章节数 < 3 → 框架分析，≥ 3 → 内容分析
-
-### 4. 数据加载策略（三层 Fallback）
-
-`--range` / `--volume` 分析时，按优先级加载：
-
-1. **Layer 1: MCP 查询**：`query_characters`、`query_plot`、`query_timeline`、`stats_volume`（均传 `--volume=vol-XX`）
-2. **Layer 2: 分片 JSON**：`tracking/volumes/vol-XX/` 下 4 个分片 + `summary/volume-summaries.json`
-3. **Layer 3: 单文件 JSON**：`tracking/` 下单文件，按章节范围手动过滤
-
-### 5. --volume-report 综合报告
-
-`--volume-report vol-XX` 生成该卷完整分析报告，包含：卷概览、情节分析、角色发展、节奏评估、一致性检查、跨卷对比、改进建议（P0/P1/P2）。
-
-数据来源：MCP `stats_volume` → 章节文件（`stories/[current]/content/chapter-XXX.md`）→ tracking 数据（分片或单文件）。
-
-### 6. 资源加载
-
-**基准文档**（参考 CLAUDE.md 资源加载规则）：`resources/memory/constitution.md`、`stories/*/specification.md`、`stories/*/creative-plan.md`、`stories/*/tasks.md`
-
-**分析专用**：`resources/craft/` 全部 + `templates/skills/quality-assurance/` QA skills
-
-**覆盖与触发**：`specification.md` 的 `resource-loading.analysis` 配置覆盖默认加载；`keyword-triggers.enabled` 扫描 `--check` 参数动态加载 skills。会话级资源复用，不重复读取。
-
----
-
-## 模式A：框架一致性分析
-
-**目标**：在写作前验证准备工作是否充分，确保规格、计划、任务之间无矛盾。
-
-### A1. 覆盖率分析
-
-检查所有规格需求是否都有对应的计划和任务：
-- P0/P1/P2 需求覆盖率
-- 任务完整性（所有计划章节是否有对应任务）
-
-### A2. 一致性检查
-
-验证文档之间是否存在矛盾：
-- **规格 ↔ 计划**：主题一致性、节奏设定、约束遵守
-- **计划 ↔ 任务**：章节对应、字数预估、优先级匹配
-- **宪法合规**：价值观、质量标准
-
-### A3. 逻辑问题预警
-
-分析故事线设计中的潜在逻辑漏洞：
-- 时间线冲突
-- 角色能力矛盾
-- 伏笔未规划
-
-### A4. 准备就绪评估
-
-输出总体评分 [X]/10，包含：
-- **P0 必要条件**：规格完整、计划覆盖 P0 需求、任务分解完整、无致命逻辑矛盾
-- **P1 建议条件**：角色档案完善、世界观设定详细、时间线规划清晰
-- **建议**：🔴 必须修复(P0) / 🟡 建议优化(P1) / 🟢 可选(P2)
-
----
-
-## 模式B：内容质量分析
-
-**目标**：对已完成的内容进行综合质量验证，确保符合规格并提供改进建议。
-
-### B1. 加载验证基准
-
-- 基准文档（同资源加载部分）
-- **已完成内容**：`stories/*/content/*.md` 或 `stories/*/chapters/*.md`
-
-### B2. 宪法合规性检查
-
-- 核心价值观检查
-- 质量标准验证（逻辑一致性、人物饱满度、文字水准）
-- 风格一致性
-
-### B3. 规格符合度分析
-
-- P0/P1/P2 核心需求覆盖率
-- 目标达成度（读者适配、市场定位、成功标准）
-- 约束条件遵守
-
-### B4. 计划执行分析
-
-- 章节架构对比（计划 vs 实际）
-- 人物发展轨迹符合度
-- 世界观展开进度
+## 目标
 
-### B5. 内容质量分析
+对已扩写的章节进行质量检查，输出分析报告到终端。
 
-- 文本统计（总字数、章节长度、完成进度）
-- 结构分析（情节密度、冲突频率、节奏变化）
-- 技术问题（逻辑问题、连贯性问题、人物一致性）
-- 亮点识别
+## 参数解析
 
-### B5.1 专项分析（可选）
+- 章节号：分析单章
+- `--range start-end`：批量分析章节范围（如 `--range 1-20`）
 
-**如果用户指定了 `--focus` 参数，读取对应的分析 Skill 文件并执行**：
+## 资源加载
 
-| 参数 | 分析类型 | Skill 文件 |
-|------|---------|-----------|
-| `--focus=opening` | 开篇分析 | `.claude/skills/analysis/opening-analysis/SKILL.md` |
-| `--focus=pacing` | 节奏分析 | `.claude/skills/analysis/pacing-analysis/SKILL.md` |
-| `--focus=character` | 人物分析 | `.claude/skills/analysis/character-analysis/SKILL.md` |
-| `--focus=foreshadow` | 伏笔分析 | `.claude/skills/analysis/foreshadow-analysis/SKILL.md` |
-| `--focus=logic` | 逻辑分析 | `.claude/skills/analysis/logic-analysis/SKILL.md` |
-| `--focus=style` | 风格分析 | `.claude/skills/analysis/style-analysis/SKILL.md` |
-| `--focus=reader` | 读者体验 | `.claude/skills/analysis/reader-analysis/SKILL.md` |
-| `--focus=hook` | 钩子分析 | `.claude/skills/analysis/hook-analysis/SKILL.md` |
-| `--focus=power` | 力量体系 | `.claude/skills/analysis/power-analysis/SKILL.md` |
-| `--focus=voice` | 对话一致性分析 | `.claude/skills/analysis/voice-analysis/SKILL.md` |
+- 目标章节正文：`stories/<story>/content/chapter-XXX.md`
+- 对应概要：`stories/<story>/content/chapter-XXX-synopsis.md`
+- tracking 数据：`tracking/character-state.json`、`tracking/plot-tracker.json`
 
-**执行流程**：读取对应 Skill 文件 → 按文件中的指令执行分析 → 输出报告
+## 检查项（5项）
 
-**voice 分析说明**：调用 `voice-consistency-checker` Skill 执行批量对话一致性检查，检测各角色对话是否符合语言指纹设定。
+### 1. 概要符合度
+对比正文与概要，检查：
+- 概要中的核心事件是否都在正文中体现
+- 出场角色是否一致
+- 情感走向是否一致
+- 章末钩子是否落地
 
-### B6. 任务完成度审计
+评分：✅ 完全符合 / ⚠️ 部分偏离 / ❌ 严重偏离
 
-- 总体进度（已完成/进行中/未开始）
-- 关键里程碑达成情况
-- 阻塞和风险
+### 2. 角色一致性
+对比正文中角色行为与 tracking 中的角色状态：
+- 角色性格是否一致（有无 OOC）
+- 角色位置是否合理
+- 角色关系互动是否符合 tracking 记录
 
-### B7. 生成改进建议
+评分：✅ / ⚠️ / ❌
 
-基于分析结果提供分级建议：
-- **P0 紧急修复**：逻辑矛盾、角色能力矛盾
-- **P1 优化建议**：悬念不足、配角功能未体现
-- **P2 长期改进**：世界观展开节奏、深层设定
+### 3. 伏笔完整性
+对比 plot-tracker 中标记的伏笔：
+- 本章应埋设的伏笔是否在正文中体现
+- 本章应回收的伏笔是否已回收
+- 是否有遗漏
 
-### B8. 生成验证报告
+评分：✅ / ⚠️ / ❌
 
-创建 `stories/*/analysis-report.md`，包含：
+### 4. 连贯性
+检查与前后章的衔接：
+- 开头是否与前一章结尾自然衔接
+- 时间线是否连续
+- 场景转换是否合理
 
-```markdown
-# 作品分析报告
+评分：✅ / ⚠️ / ❌
 
-## 摘要
-- 分析日期 / 范围 / 字数 / 总体评分
+### 5. AI味检测
+检查常见AI写作痕迹：
+- AI高频词使用（然而、殊不知、缓缓、深邃等）
+- 句式重复度
+- 空洞描写比例
+- 段落结构单一性
 
-## 核心指标
-| 维度 | 得分 | 说明 |
-|------|------|------|
-| 宪法合规 | [X]/10 | ... |
-| 规格符合 | [X]/10 | ... |
-| 计划执行 | [X]/10 | ... |
-| 内容质量 | [X]/10 | ... |
-| 读者体验 | [X]/10 | ... |
-| 期待管理 | [X]/10 | ... |
-| 线程平衡 | [X]/10 | ... |
-
-## 关键发现
-[✅ 优点 / ⚠️ 警告 / ❌ 问题]
-
-## 下一步行动
-[分级行动建议]
-```
-
----
-
-## 后置处理：询问式 Tracking 更新
-
-**执行时机**: 内容分析完成后，发现可更新的 tracking 信息
-
-**更新策略**: 辅助命令（/analyze）生成建议，**需用户确认后**才更新
-
-**从分析结果中提取更新建议**:
-1. **角色状态变化**（→ character-state.json）
-2. **关系网络变化**（→ relationships.json）
-3. **情节推进**（→ plot-tracker.json）
-4. **时间线补充**（→ timeline.json）
-
-**用户确认选项**:
-- **[Y]** 全部应用
-- **[N]** 跳过更新
-- **[S]** 选择性应用（逐项确认）
-
-应用后追加更新记录到 `tracking-log.md`。
-
-**分片模式写入协议**：
-- 如果检测到 `tracking/volumes/` 存在，确定章节所属卷
-- 更新该卷的分片文件（如 `tracking/volumes/vol-03/character-state.json`）
-- 同步更新全局摘要文件（如 `tracking/summary/characters-summary.json`）
-- 如果 MCP 可用，调用 `sync_from_json` 同步到 SQLite
-
-**错误处理**：
-- tracking 文件不存在 → 建议运行 `/track --init`
-- JSON 格式错误 → 提示手动修复
-- tracking 目录不存在 → 建议创建 `tracking/`
-
----
-
-## 🔄 反馈建议
-
-在分析报告的最后，根据发现的问题生成反馈建议，指向需要修改的上游文档：
-
-### 反馈分类
-
-| 问题类型 | 反馈目标 | 操作建议 |
-|---------|---------|---------|
-| 角色设定与实际描写不符 | `specification.md` | `/specify --feedback` 更新角色设定 |
-| 情节走向偏离计划 | `creative-plan.md` | `/plan --feedback` 调整计划 |
-| 任务粒度不合理 | `tasks.md` | `/tasks` 重新拆分 |
-| 力量体系不一致 | `specification.md` | `/specify --feedback` 修正力量体系 |
-| 世界观设定冲突 | `specification.md` | `/specify --feedback` 修正世界观 |
-| 节奏问题 | `creative-plan.md` | `/plan --feedback` 调整章节规划 |
-
-### 输出格式
-
-```
-🔄 反馈建议
-━━━━━━━━━━━━━━━━━━━━
-
-本次分析发现以下问题需要回溯修改上游文档：
-
-📋 规格书反馈（/specify --feedback）：
-1. [具体问题描述] → 选择：修改设定 or 修改章节内容
-
-📋 计划反馈（/plan --feedback）：
-2. [具体问题描述] → 建议运行 /plan --detail 重新规划
-
-⚠️ 未处理的反馈会在下次 /guide 中提醒
-```
-
----
-
-## 🔧 修改引导
-
-**内容分析完成后，自动提示修改选项**：
-
-```markdown
-📋 分析完成。发现 [X] 个问题。
-
-如需系统性修改，可执行：
-  /revise                         完整四层修改（结构→节奏→一致性→文字）
-  /revise --layer polish          仅文字润色
-  /revise --layer consistency     仅一致性修复
-  /revise --quick                 快速修改（一致性+文字）
-  /revise --chapters 1-10         指定范围修改
-```
-
-**问题到修改层的映射**：
-
-| /analyze 发现的问题类型 | 对应 /revise 层 |
-|----------------------|----------------|
-| 结构问题、章节缺失、高潮位置 | `--layer=structure` |
-| 节奏偏慢/偏快、缺少钩子 | `--layer=pacing` |
-| 角色矛盾、时间线错误、伏笔遗漏 | `--layer=consistency` |
-| 重复用词、AI痕迹、风格不一致 | `--layer=polish` |
-
----
-
-**记住**：**一个命令，三种模式（框架/内容/专项），智能而精准。** 分析发现问题后，使用 `/revise` 进行系统性修改。
-
----
+评分：✅ 自然 / ⚠️ 轻微AI味 / ❌ 明显AI味
 
-## 🔗 命令链式提示
+## 输出格式
 
-**命令执行完成后，自动附加下一步建议**：
+直接输出到终端，不生成文件：
 
 ```
-💡 下一步建议：
-1️⃣ `/revise` — 基于分析结果进行系统性修改润色
-2️⃣ `/write [下一章节号]` — 继续写作（如无严重问题）
-3️⃣ `/analyze --focus=[维度]` — 针对特定维度深入分析（opening/pacing/logic/style/reader/hook/power/voice）
+## 第X章 质量分析报告
+
+| 检查项 | 评分 | 说明 |
+|--------|------|------|
+| 概要符合度 | ✅ | ... |
+| 角色一致性 | ⚠️ | ... |
+| 伏笔完整性 | ✅ | ... |
+| 连贯性 | ✅ | ... |
+| AI味检测 | ⚠️ | ... |
+
+### 需要关注的问题
+1. [具体问题和建议]
+
+### 后续建议
+- 如有 ⚠️ 或 ❌：建议手动修改正文后重新 /analyze
+- 全部 ✅：可以继续扩写下一章
 ```

package/templates/commands/expand.md

@@ -0,0 +1,103 @@
+---
+description: 将章节概要扩写为 3000-5000 字正文
+argument-hint: [章节号] [--batch N]
+recommended-model: claude-opus-4-6
+allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//tracking/**), Write(//tracking/**), Read(//resources/style-reference.md), Read(//resources/anti-ai.md), Read(//resources/constitution.md), Bash(ls:*)
+---
+
+用户输入：$ARGUMENTS
+
+## 上下文隔离（强制）
+
+本命令的所有创作资源必须从文件系统重新加载，禁止依赖本对话中之前任何 /write 或其他命令的生成过程和中间记忆。
+
+具体规则：
+- 忽略对话历史中所有 /write 生成的概要内容，以文件系统中的 synopsis.md 为唯一真实来源
+- 忽略对话历史中所有 tracking 文件的中间状态，重新从文件读取最新版本
+- 不复用对话中已加载的 style-reference.md 或 anti-ai.md，重新读取
+
+## 目标
+
+将已生成的章节概要扩写为 3000-5000 字的完整正文。
+
+## 参数解析
+
+- 章节号：从 $ARGUMENTS 提取
+- `--batch N`：批量扩写 N 章（最大 10），从指定章节号开始
+
+## 资源加载（3 层结构，从文件系统重新加载）
+
+所有资源必须从文件系统读取，不复用对话中的缓存。总上下文控制在 3500 字以内。
+
+### 第 1 层 — 全局视角
+
+1. **specification.md 摘要**：读取 `stories/<story>/specification.md`，提取 100 字核心摘要（类型 + 主角 + 核心冲突）
+2. **当前卷大纲**：读取 `stories/<story>/creative-plan.md`，只提取当前章节所属卷的段落
+
+### 第 2 层 — 章节核心
+
+3. **当前章概要**：读取 `stories/<story>/content/chapter-XXX-synopsis.md`（200-500字）
+4. **前一章正文末尾**：读取前一章 `chapter-XXX.md` 的最后 500-800 字（衔接用）。如果前一章尚未扩写，读取前一章概要代替
+
+### 第 3 层 — 细节支撑
+
+5. **本章出场角色状态**：从概要中提取出场角色列表，然后从 `tracking/character-state.json` 只提取这些角色的条目
+6. **本章活跃伏笔**：从 `tracking/plot-tracker.json` 提取 status=planted 或 status=hinted 且 keyChapters 包含当前章或相邻章（±3章）的伏笔
+7. **本章相关角色关系**：从 `tracking/relationships.json` 提取本章出场角色之间的关系条目（最多 5 条，超出则取最近更新的）
+8. **风格参考**：读取 `resources/style-reference.md`
+9. **反AI规范**：读取 `resources/anti-ai.md`
+
+**上下文预算**：
+
+| 层级 | 预估字数 |
+|------|---------|
+| 第 1 层 全局 | 200-400 字 |
+| 第 2 层 章节 | 700-1300 字 |
+| 第 3 层 细节 | 800-1500 字 |
+| **总计** | **1700-3200 字** |
+
+每层加载完后检查上下文预算，超出则截断（如角色关系条目过多时只取最核心的 5 条）。
+
+## 执行步骤
+
+### 1. 前置检查
+
+- 确认目标章节的 synopsis.md 存在，否则提示先运行 /write
+- 确认目标章节的正文 chapter-XXX.md 不存在（避免覆盖），如已存在则询问是否覆盖
+
+### 2. 加载上下文
+
+按上述「资源加载」规则加载精准最小集。
+
+### 3. 扩写正文
+
+基于概要，扩写为 3000-5000 字正文。遵循以下原则：
+
+- **忠实于概要**：核心事件、出场角色、情感走向必须与概要一致
+- **全局一致性**：正文必须与 specification.md 的类型定位和 creative-plan.md 的卷级设计保持一致
+- **角色关系驱动**：对话和互动必须体现 relationships.json 中的关系动态
+- **文学表达**：专注于场景描写、对话、心理活动、动作细节
+- **风格一致**：遵循 style-reference.md 的风格设定
+- **反AI规范**：遵循 anti-ai.md 的写作规范
+- **衔接自然**：与前一章末尾自然衔接
+- **伏笔落地**：概要中标记的伏笔必须在正文中体现
+
+写入 `stories/<story>/content/chapter-XXX.md`。
+
+### 4. 补充 tracking 细节
+
+扩写完成后，检查正文中是否产生了概要中没有的新细节：
+- 对话中透露的新信息 → 更新 character-state 或 relationships
+- 新的场景细节 → 如有重要设定变化，更新相关 tracking
+
+### 5. 批量模式
+
+如果指定了 `--batch N`，重复步骤 2-4 共 N 次。每章完成后输出进度和字数。
+
+**批量模式资源隔离**：每章都必须重新从文件系统加载所有资源（前一章扩写可能更新了 tracking）。批量模式中每章视为独立的扩写任务，不复用前一章扩写过程中的中间状态。
+
+### 6. 后续建议
+
+单章完成：「第X章扩写完成（XXXX字）。继续 /expand [X+1] 或使用 /analyze X 检查质量。」
+
+批量完成：「第X-Y章扩写完成（共Z章，平均XXXX字/章）。使用 /analyze --range X-Y 批量检查质量。」