novelws 1.2.0

package/templates/commands/checklist.md

@@ -0,0 +1,434 @@
+---
+name: checklist
+description: 生成或执行质量检查清单（规格验证 + 内容扫描）
+allowed-tools: Read, Bash, Write, Edit, Glob, Grep
+model: claude-sonnet-4-5-20250929
+scripts:
+  sh: scripts/bash/common.sh
+  ps: scripts/powershell/common.ps1
+---
+
+# 质量检查清单（Checklist）
+
+生成或执行质量检查清单，支持两种模式：
+
+## 🎯 支持的检查类型
+
+### 第一类：规格质量检查（问题生成式）
+验证规划文档本身的质量（类似"需求的单元测试"）：
+
+- `大纲质量` - 检查 outline.md 的完整性、清晰度、一致性
+- `角色设定` - 检查 spec/knowledge/characters.md
+- `世界观` - 检查 spec/knowledge/world-setting.md 及相关文档
+- `创作计划` - 检查 creative-plan.md / specification.md
+- `伏笔管理` - 检查 spec/tracking/plot-tracker.json 的伏笔定义
+
+### 第二类：内容验证检查（结果报告式）
+扫描已写章节，验证实际内容：
+
+- `世界观一致性` - 扫描章节内容，检查世界观描述矛盾
+- `情节对齐` - 对比进度与大纲，检查情节发展
+- `数据同步` - 验证所有 tracking JSON 文件的同步性
+- `时间线` - 检查时间事件的逻辑连续性
+- `写作状态` - 检查写作准备度和任务状态
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+## 🆕 前置资源加载
+
+**运行脚本** `{SCRIPT}` 检查创作状态（如果配置了 scripts）
+
+**加载检查清单辅助资源**：
+
+### 默认加载
+
+自动加载以下资源用于生成检查清单：
+- `memory/constitution.md`（创作宪法）
+- `stories/*/specification.md`（故事规格）
+- `stories/*/tasks.md`（当前任务）
+- `spec/tracking/plot-tracker.json`（情节追踪）
+- `spec/tracking/character-state.json`（角色状态）
+
+### 可选加载
+
+如果 `specification.md` 配置了 `resource-loading.checklist`：
+
+```yaml
+resource-loading:
+  checklist:  # /checklist 命令专用配置
+    knowledge-base:
+      craft:
+        - scene-structure  # 场景结构检查清单
+        - pacing           # 节奏检查清单
+    skills:
+      quality-assurance:
+        - consistency-checker  # 一致性检查项
+```
+
+**加载优先级**：
+- 检查清单辅助资源的优先级**低于**宪法和规格
+- 检查清单辅助资源用于**生成更全面的检查项**
+
+### 🆕 Layer 3: 关键词触发（可选）
+
+**触发时机**: 命令参数（如 `/checklist --focus 节奏`）
+
+**配置**: 读取 `specification.md` 的 `resource-loading.keyword-triggers.enabled`
+
+**如果 `enabled: true` 且参数包含关键词**:
+
+检测参数中的关键词，提示加载相关资源：
+
+```markdown
+💡 检测到 "--focus 节奏"，建议加载：
+- craft/pacing.md
+
+是否加载？ [Y/N]
+```
+
+**默认行为**: 如果未配置 keyword-triggers，此步骤不执行。
+
+## 执行流程
+
+### 1. 识别检查类型
+
+根据用户输入，确定检查类型（规格质量 vs 内容验证）：
+
+**关键词映射**：
+- "大纲"、"质量" → 规格质量类：大纲质量
+- "角色"、"设定" → 规格质量类：角色设定
+- "世界观" + "质量/完整性/规格" → 规格质量类：世界观
+- "世界观" + "一致性/检查/扫描" → 内容验证类：世界观一致性
+- "创作计划"、"规划" → 规格质量类：创作计划
+- "伏笔" → 规格质量类：伏笔管理
+- "情节"、"对齐"、"进度" → 内容验证类：情节对齐
+- "数据"、"同步"、"一致性" → 内容验证类：数据同步
+- "时间线"、"时间" → 内容验证类：时间线
+- "写作状态"、"准备" → 内容验证类：写作状态
+
+如果用户输入不明确，询问选择。
+
+### 2. 执行对应的检查逻辑
+
+#### 规格质量类检查（生成问题式 Checklist）
+
+执行类似 spec-kit 的需求质量验证逻辑：
+
+##### 2.1 大纲质量检查
+
+**目标**：验证 outline.md 是否具备良好的完整性、清晰度和一致性。
+
+**读取文件**：
+- `outline.md` 或 `stories/*/outline.md`
+- `spec/tracking/plot-tracker.json`（如果存在）
+
+**生成检查项维度**：
+
+**完整性 (Completeness)**：
+- 是否为每个主要情节节点定义了触发条件和结果？
+- 是否明确每个卷/章的故事目标？
+- 是否覆盖所有主要角色的成长弧？
+- 是否定义了主要冲突的升级路径？
+- 是否明确故事的高潮和结局？
+
+**清晰度 (Clarity)**：
+- 情节节点的触发条件是否具体可验证？
+- 章节分配是否有明确的依据（如字数、情节密度）？
+- 角色动机是否用具体事件量化？
+- 场景描述是否避免模糊词汇（"某个地方"、"一段时间"）？
+
+**一致性 (Consistency)**：
+- 情节线索前后是否矛盾？
+- 角色行为是否符合设定？
+- 时间跨度是否合理？
+- 世界观规则是否与大纲描述一致？
+
+**可测量性 (Measurability)**：
+- 章节分配是否合理可行（如每章2000-4000字）？
+- 伏笔回收时机是否明确（章节号或章节范围）？
+- 角色成长是否有明确的里程碑？
+
+**覆盖范围 (Coverage)**：
+- 是否考虑了所有主要场景类型（冲突、日常、转折）？
+- 是否覆盖了所有主要角色的戏份？
+- 是否包含必要的伏笔铺设和回收？
+
+**输出格式示例**：
+```markdown
+# 大纲质量检查清单
+**创建时间**: 2025-10-11
+**检查对象**: outline.md
+**检查维度**: 完整性、清晰度、一致性、可测量性、覆盖范围
+
+## 完整性 (Completeness)
+
+- [ ] CHK001 是否为每个主要情节节点定义了触发条件和结果？ [Spec §大纲3.2]
+- [ ] CHK002 是否明确每个卷/章的故事目标？ [Gap]
+- [ ] CHK003 是否覆盖所有主要角色的成长弧？ [Spec §大纲5.1]
+
+## 清晰度 (Clarity)
+
+- [ ] CHK004 情节节点的触发条件是否具体可验证？ [Ambiguity, Spec §大纲3.2]
+- [ ] CHK005 章节分配是否有明确的依据？ [Clarity]
+
+## 一致性 (Consistency)
+
+- [ ] CHK006 情节线索前后是否矛盾？ [Consistency]
+- [ ] CHK007 世界观规则是否与大纲描述一致？ [Consistency, vs §世界观]
+
+## 可测量性 (Measurability)
+
+- [ ] CHK008 章节分配是否合理可行（如每章2000-4000字）？ [Measurability]
+- [ ] CHK009 伏笔回收时机是否明确（章节号或范围）？ [Gap]
+
+## 覆盖范围 (Coverage)
+
+- [ ] CHK010 是否考虑了所有主要场景类型？ [Coverage]
+- [ ] CHK011 是否包含必要的伏笔铺设和回收？ [Coverage, Gap]
+
+## 使用说明
+
+勾选已验证项：`[x]`
+标记问题项：`[!]` 并在下方记录具体问题
+```
+
+##### 2.2 角色设定检查
+
+**读取文件**：
+- `spec/knowledge/characters.md`
+- `spec/tracking/character-state.json`
+- `spec/tracking/relationships.json`
+
+**生成检查项维度**：
+
+**完整性**：
+- 主要角色是否定义了基本信息（姓名、年龄、身份、外貌）？
+- 是否定义了角色的核心动机和目标？
+- 是否定义了角色的性格特征和行为模式？
+- 是否定义了角色的背景故事？
+- 是否定义了角色的能力和局限？
+
+**清晰度**：
+- 角色动机是否具体可验证（非"想要成功"而是"想通过科举改变家族命运"）？
+- 性格特征是否通过具体行为体现？
+- 角色目标是否可量化或有明确的达成标准？
+
+**一致性**：
+- 角色设定与大纲中的行为是否一致？
+- 不同文档中的角色描述是否一致？
+- 角色关系定义是否对称（A对B的关系 vs B对A的关系）？
+
+**可测量性**：
+- 角色成长是否有明确的阶段划分？
+- 角色能力变化是否可追踪？
+
+##### 2.3 世界观检查
+
+**读取文件**：
+- `spec/knowledge/world-setting.md`
+- `spec/knowledge/locations.md`
+- `spec/knowledge/culture.md`
+- `spec/knowledge/rules.md`
+
+**生成检查项维度**：
+
+**完整性**：
+- 是否定义了核心世界观规则（魔法体系、科技水平、社会结构）？
+- 是否定义了主要地点及其特征？
+- 是否定义了文化风俗、语言、传统？
+- 是否定义了时代背景和历史脉络？
+
+**清晰度**：
+- 世界观规则是否明确无歧义？
+- 地理位置、距离、方位是否清晰？
+- 特殊术语是否有明确定义？
+
+**一致性**：
+- 不同文档中的世界观设定是否一致？
+- 世界观规则是否存在内部矛盾？
+- 与大纲描述是否一致？
+
+**覆盖范围**：
+- 是否覆盖了故事涉及的所有地点？
+- 是否定义了所有出现的特殊规则或能力？
+
+##### 2.4 创作计划检查
+
+**读取文件**：
+- `creative-plan.md` 或 `specification.md`
+- `tasks.md`
+
+**生成检查项维度**：
+
+**完整性**：
+- 是否定义了创作目标和里程碑？
+- 是否明确了创作流程和步骤？
+- 是否定义了质量标准？
+
+**清晰度**：
+- 任务划分是否清晰具体？
+- 时间安排是否合理？
+- 验收标准是否明确？
+
+**一致性**：
+- 计划是否与大纲规模匹配？
+- 任务是否涵盖所有规划内容？
+
+##### 2.5 伏笔管理检查
+
+**读取文件**：
+- `spec/tracking/plot-tracker.json`
+- `outline.md`
+
+**生成检查项维度**：
+
+**完整性**：
+- 是否记录了所有规划的伏笔？
+- 每个伏笔是否定义了铺设章节和回收章节？
+- 是否定义了伏笔的类型和重要性？
+
+**清晰度**：
+- 伏笔内容描述是否清晰？
+- 回收方式是否明确？
+
+**可测量性**：
+- 回收时机是否有明确的章节号或范围？
+- 是否定义了铺设密度（避免过多未回收伏笔）？
+
+**一致性**：
+- 伏笔是否与大纲情节匹配？
+- planted 和 resolved 字段是否一致？
+
+#### 内容验证类检查（执行脚本生成报告）
+
+这些检查需要扫描实际写作内容，调用对应的 bash 脚本：
+
+##### 2.5 世界观一致性检查
+
+执行命令：
+```bash
+bash scripts/bash/check-world.sh --checklist
+```
+
+如果脚本不存在，提示用户该功能正在开发中。
+
+##### 2.6 情节对齐检查
+
+执行命令：
+```bash
+bash scripts/bash/check-plot.sh --checklist
+```
+
+##### 2.7 数据同步检查
+
+执行命令：
+```bash
+bash scripts/bash/check-consistency.sh --checklist
+```
+
+##### 2.8 时间线检查
+
+执行命令：
+```bash
+bash scripts/bash/check-timeline.sh check --checklist
+```
+
+##### 2.9 写作状态检查
+
+**目标**：检查写作准备度，确保所有必要资源就绪。
+
+**检查项**：
+
+**风格指南状态**：
+- [ ] personal-voice.md 是否存在？
+- [ ] 如果不存在且已写 3+ 章，是否需要执行风格学习？
+- [ ] 风格指南是否过时（最后更新 > 10 章前）？
+
+**规格文档状态**：
+- [ ] specification.md 是否存在且完整？
+- [ ] outline.md 是否存在？
+- [ ] 角色设定是否完整？
+
+**追踪数据状态**：
+- [ ] plot-tracker.json 是否存在？
+- [ ] character-state.json 是否存在？
+- [ ] 追踪数据是否与已写章节同步？
+
+**任务状态**：
+- [ ] tasks.md 是否存在？
+- [ ] 当前任务是否明确？
+- [ ] 是否有阻塞任务？
+
+**实现方式**：
+
+如果存在脚本，执行：
+```bash
+bash scripts/bash/check-writing-state.sh --checklist
+```
+
+否则，手动检查上述项目并生成报告。
+
+**风格学习集成**：
+
+如果检测到 personal-voice.md 不存在且已写 3+ 章：
+```markdown
+⚠️ 风格指南缺失
+
+检测到：
+- 已写章节：5 章
+- personal-voice.md：不存在
+
+建议：
+执行风格学习生成个性化风格指南：
+  /style-learning
+
+或手动创建：
+  .specify/memory/personal-voice.md
+```
+
+### 3. 输出 Checklist
+
+**保存位置**：`spec/checklists/`
+
+**文件命名规则**：
+- 规格质量类：`[类型]-quality.md`（如 `outline-quality.md`）
+- 内容验证类：`[类型]-[日期].md`（如 `world-consistency-20251011.md`）
+
+**输出格式**：使用 `templates/checklist-template.md` 作为模板。
+
+### 4. 报告结果
+
+输出：
+- Checklist 文件路径
+- 检查项总数
+- 检查类型和范围
+- 如何使用 checklist 的说明
+
+## 示例用法
+
+```bash
+# 规格质量检查
+/checklist 大纲质量
+/checklist 角色设定
+/checklist 世界观
+
+# 内容验证检查
+/checklist 世界观一致性
+/checklist 情节对齐
+/checklist 数据同步
+```
+
+## 注意事项
+
+1. **规格质量类 checklist**：用于写作前的规划验证，发现文档本身的质量问题
+2. **内容验证类 checklist**：用于写作后的内容检查，发现实际产出的问题
+3. 两类 checklist 互补，建议：规划阶段使用第一类，写作阶段使用第二类
+4. 所有 checklist 保存在 `spec/checklists/` 目录，便于追踪历史检查记录
+
+## 向后兼容说明
+
+旧命令 `/world-check` 和 `/plot-check` 仍然可用，但推荐使用统一的 `/checklist` 命令。

package/templates/commands/clarify.md

@@ -0,0 +1,257 @@
+---
+description: 通过针对性问答澄清故事大纲中的模糊点，确保创作方向明确，支持焦点参数
+argument-hint: [关键词或焦点领域]
+allowed-tools: Read(//stories/**), Read(stories/**), Read(//plugins/**), Read(plugins/**), Write(//stories/*/story.md), Write(stories/*/story.md), Bash(ls:*), Bash(find:*), Bash(*)
+model: claude-sonnet-4-5-20250929
+disable-model-invocation: false
+scripts:
+  sh: .specify/scripts/bash/clarify-story.sh --json --paths-only
+  ps: .specify/scripts/powershell/clarify-story.ps1 -Json -PathsOnly
+---
+
+焦点区域（可选）：$ARGUMENTS
+---
+
+## 目标
+
+检测并减少故事大纲中的歧义或缺失的决策点，通过交互式问答收集澄清信息，并将结果记录在故事文件中。
+
+**注意**：此澄清流程应在 `/plan` 之前运行并完成。如果用户明确表示跳过澄清（例如，探索性创作），可以继续，但必须警告下游返工风险会增加。
+
+## 执行步骤
+
+### 1. 初始化检查
+
+运行 `{SCRIPT}` 获取当前故事路径：
+- 解析 JSON 获取 `STORY_PATH` 和 `STORY_NAME`
+- 如果没有找到故事文件，提示用户先运行 `/story` 创建故事大纲
+- 加载故事文件内容进行分析
+
+<!-- PLUGIN_HOOK: genre-knowledge-clarify -->
+<!-- 插件增强区：类型识别
+     如果你安装了 genre-knowledge 插件，请在此处插入类型识别增强提示词
+     参考：plugins/genre-knowledge/README.md 的"2.1 增强 /clarify 命令"章节
+-->
+
+### 2. 结构化歧义扫描
+
+对故事大纲进行全面扫描，评估每个类别的清晰度（清晰/部分清晰/缺失）：
+
+**创作定位**
+- 目标读者群体（年龄段、性别倾向、阅读层次）
+- 作品定位（商业爽文/严肃文学/类型小说）
+- 预期规模（短篇3-5万/中篇10-20万/长篇50万+）
+
+**世界观设定**
+- 时代背景精确度（具体年份/朝代/架空程度）
+- 世界规则（魔法体系/科技水平/社会制度）
+- 地理范围（单一城市/多国/大陆/星际）
+
+**角色设计**
+- 主角成长曲线（废柴逆袭/天才型/稳扎稳打）
+- 主角性格基调（热血/冷静/腹黑/圣母）
+- 配角功能定位（推动剧情/情感支撑/对比反衬）
+- 反派智商设定（降智反派/势均力敌/高维碾压）
+
+**叙事策略**
+- 视角选择（第一人称/第三人称限定/上帝视角）
+- 时间线结构（线性叙事/倒叙插叙/多线并行）
+- 叙事节奏（快节奏爽文/慢热铺垫/张弛有度）
+
+**情节核心**
+- 核心冲突类型（人vs人/人vs自然/人vs社会/人vs自我）
+- 主线目标明确度（复仇/成长/拯救/探索）
+- 结局倾向（大团圆/悲剧/开放式）
+
+**风格基调**
+- 文风选择（白话流畅/古风典雅/幽默诙谐/冷峻写实）
+- 描写侧重（动作场面/心理描写/环境氛围/对话推进）
+- 情感基调（热血激昂/压抑黑暗/温馨治愈/虐心催泪）
+
+**创作约束**
+- 敏感内容处理（violence程度/情感尺度）
+- 价值观导向（正能量/现实主义/批判性）
+- 更新计划（日更/周更/月更）
+
+对每个"部分清晰"或"缺失"的类别生成候选问题，除非：
+- 澄清不会实质影响创作方向
+- 信息更适合在章节规划阶段确定
+
+### 3. 生成优先问题队列
+
+内部生成最多5个优先澄清问题，应用以下约束：
+- 整个会话最多5个问题
+- 每个问题必须可以通过以下方式之一回答：
+  * 多选题（2-5个互斥选项）
+  * 简答题（限制5个词以内）
+- 只包含对创作方向有实质影响的问题
+- 确保类别覆盖平衡，优先高影响领域
+- 如果超过5个类别需要澄清，选择（影响力×不确定性）最高的5个
+
+### 3.5 问题设计原则（对话式理解）
+
+每个问题应当**像真人写手在交流**，而不是工程师在填表。
+
+**核心原则**：
+- ✅ **先说观察，再问问题**：让作者明白"为什么要问这个"
+- ✅ **说人话**：用创作者的语言，而不是分类学术语
+- ✅ **指出影响**：让作者理解这个决策会影响什么
+- ❌ **避免直接抛问题**：不要一上来就"请问你的目标读者是？"
+
+**对比示例**：
+
+❌ **工程化提问**（避免）：
+```
+问题1：你的目标读者是什么年龄段？
+A. 18-25岁  B. 26-35岁  C. 36-45岁
+```
+
+✅ **对话式提问**（推荐）：
+```
+💬 我注意到你的故事有校园元素，但也有职场内容。这两个场景对应的读者群体差异很大——
+校园读者喜欢热血成长，职场读者更关注权谋博弈。这会直接影响我们的节奏设计和价值观表达。
+
+所以想先确认：**你主要想写给谁看？**
+
+| 选项 | 说明 |
+|------|------|
+| A | 学生群体（18-25岁）- 侧重成长和理想主义 |
+| B | 职场人士（26-35岁）- 侧重现实和策略思维 |
+| C | 通吃（调整为双线叙事，兼顾两者）|
+| D | 自定义（请输入你的想法）|
+```
+
+**提问结构模板**：
+```markdown
+💬 [观察到的现象/矛盾点]。[这会影响什么创作决策]。
+
+所以想确认：**[核心问题]**
+
+[选项表格或简答提示]
+```
+
+### 4. 顺序问答循环
+
+**一次展示一个问题**，按照对话式格式提问。
+
+多选题格式（必须包含问题背景）：
+```markdown
+💬 [问题背景说明：你观察到了什么？这会影响什么？]
+
+所以想确认：**[核心问题]**
+
+| 选项 | 说明 |
+|------|------|
+| A | 选项A的详细说明 |
+| B | 选项B的详细说明 |
+| C | 选项C的详细说明 |
+| D | 选项D的详细说明 |
+| E | 选项E的详细说明（可选）|
+| F | 自定义（请输入你的想法）|
+```
+
+简答题格式（必须包含问题背景）：
+```markdown
+💬 [问题背景说明：你观察到了什么？这会影响什么？]
+
+所以想确认：**[核心问题]**
+
+请简要回答（5个词以内）：_______
+```
+
+**处理用户回答**
+- 验证答案有效性
+- 如选择 F（自定义），接收并记录用户输入的自定义内容
+- 如有歧义，请求快速澄清
+- 记录答案并继续下一个问题
+
+**停止条件**
+- 所有关键歧义已解决
+- 用户示意完成（"好了"、"够了"、"不用了"）
+- 已达到5个问题上限
+
+### 5. 整合澄清结果
+
+每个接受的答案后立即：
+
+**首次整合时**
+- 在故事大纲中创建 `## 澄清记录` 章节（如不存在）
+- 添加 `### 澄清会话 [日期]` 子标题
+
+**记录格式**
+```markdown
+- 问：[问题内容] → 答：[用户答案]
+```
+
+**更新相关章节**
+根据澄清内容更新故事大纲的对应部分：
+- 创作定位 → 更新故事概述
+- 世界观 → 更新世界观设定
+- 角色 → 更新角色设定
+- 叙事策略 → 添加到创作说明
+- 风格基调 → 添加到风格指南
+
+### 6. 验证与保存
+
+每次更新后验证：
+- 澄清记录完整性
+- 没有遗留的模糊标记被新答案解决
+- 没有矛盾的陈述
+- Markdown 格式正确
+
+将更新后的内容写回故事文件。
+
+### 7. 完成报告
+
+报告包含：
+- 提问和回答的问题数量
+- 更新的故事文件路径
+- 触及的章节列表
+- 覆盖率总结表：
+
+| 类别 | 状态 |
+|------|------|
+| 创作定位 | ✅ 已澄清 |
+| 世界观设定 | ✅ 已澄清 |
+| 角色设计 | ⏸ 延迟到规划 |
+| ... | ... |
+
+- 建议的下一步命令（通常是 `/plan`）
+
+## 行为规则
+
+- 如果没有发现有意义的歧义，回应："未检测到需要立即澄清的关键歧义。"
+- 如果故事文件缺失，指导用户先运行 `/story`
+- 不超过5个问题的总限制
+- 避免询问纯技术写作细节
+- 尊重用户的提前终止信号
+- 如果未提问就达到完全覆盖，输出简洁的覆盖总结
+
+## 小说创作特定考虑
+
+- **类型适配**：根据故事类型（爽文/悬疑/言情/严肃文学等）加载对应知识库，提供针对性问题
+- **读者导向**：商业作品vs文学作品的不同标准和侧重点
+- **文化敏感**：某些题材需要特别谨慎处理
+- **系列规划**：是否为系列作品会影响整体架构和决策
+
+优先级上下文：{ARGS}
+
+## 资源加载（可选）
+
+本命令用于澄清创作需求和规格细节，默认不加载额外资源。
+
+### 可选配置
+
+如果需要参考特定类型或风格的创作规范：
+
+```yaml
+resource-loading:
+  clarify:
+    knowledge-base:
+      genres:
+        - romance  # 言情类型规范
+      requirements:
+        - anti-ai-v4  # 特定创作要求
+```
+
+**推荐资源**: genres/* 和 requirements/*（根据项目类型）