novelws 1.2.0

package/templates/skills/quality-assurance/workflow-guide/SKILL.md

@@ -0,0 +1,381 @@
+---
+name: novel-writer-workflow-guide
+description: "Use when user starts a novel project or asks how to organize their writing - guides through novel-writer's seven-step methodology and ensures proper workflow"
+allowed-tools: Read, Grep
+---
+
+# Novel Writer 系统化创作工作流
+
+## 当用户说"我想写小说"
+
+**立即激活此工作流指南。**
+
+## 七步方法论概览
+
+```
+1. /constitution  → 建立创作原则
+2. /specify       → 定义故事规格
+3. /clarify       → 澄清模糊点
+4. /plan          → 制定创作计划
+5. /tasks         → 分解执行任务
+6. /write         → AI 辅助写作
+7. /analyze       → 质量验证分析
+```
+
+## 详细步骤指导
+
+### 步骤 1：建立创作原则
+
+> "让我们从使用 `/constitution` 定义你的创作原则开始。这建立了你的核心价值观、质量标准和这个故事的不可协商规则。"
+
+**为什么这很重要**：作为你的"创作宪法" - 决策会参考这些原则。
+
+**包含什么**：
+- 核心价值观（传递什么理念）
+- 质量底线（绝对不妥协的）
+- 风格原则（语言、节奏、氛围）
+- 内容原则（角色、情节、世界观规范）
+
+**典型时长**：15-20 分钟
+
+### 步骤 2：定义故事规格
+
+> "现在使用 `/specify` 创建类似产品规格的故事文档。像产品经理一样思考：这个故事是什么，为谁写的，什么使它独特？"
+
+**要包含什么**：
+- 一句话概括
+- 目标读者
+- 核心冲突
+- 主要角色
+- 成功标准
+
+**为什么这很重要**：
+- 明确"为谁写"和"写什么"
+- 设定可衡量的成功标准
+- 为后续创作提供明确目标
+
+**典型时长**：30-45 分钟
+
+**特殊标记**：
+- `[需要澄清]` - 标记需要进一步明确的点
+- `[核心需求]` - 不可妥协的需求
+- `[可选特性]` - 锦上添花的内容
+
+### 步骤 3：澄清关键决策
+
+> "运行 `/clarify` 通过 5 个精准问题解决任何不清楚的方面。AI 会识别你的规格中的模糊点，帮助你做出清晰的决定。"
+
+**为什么这很重要**：规划中的模糊 = 写作中的混乱。
+
+**过程**：
+- AI 识别规格中的模糊点
+- 生成最多 5 个关键问题
+- 交互式回答，答案直接更新规格
+- 保留决策历史以便回溯
+
+**典型问题**：
+- "主角的核心动机是复仇还是正义？"
+- "故事节奏是快速爽文还是慢热精品？"
+- "结局是大团圆还是留有遗憾？"
+
+**典型时长**：10-15 分钟
+
+### 步骤 4：制定创作计划
+
+> "使用 `/plan` 创建章节结构和技术方法。这是你决定如何实现你的规格的地方。"
+
+**要设计什么**：
+- 章节分解与活跃情节线
+- 节奏和张力分布
+- 伏笔计划
+- 角色弧线映射
+
+**为什么这很重要**：
+- 把抽象需求变成具体方案
+- 选择合适的写作方法和结构
+- 设计情节、人物、世界观的具体实现
+
+**技术决策示例**：
+- "使用七点结构增强悬念"
+- "采用多线叙事展现复杂性"
+- "通过限定视角增加神秘感"
+
+**典型时长**：45-60 分钟
+
+### 步骤 5：分解执行任务
+
+> "执行 `/tasks` 生成带优先级、依赖关系和估算工作量的可操作任务列表。"
+
+**任务类型**：
+- 章节写作任务
+- 角色档案完善
+- 世界观设定补充
+- 修订和润色任务
+
+**任务标记**：
+- `[P]` - 可并行执行
+- `[依赖:X]` - 依赖任务 X 完成
+- `[高优]` - 高优先级任务
+
+**为什么这很重要**：
+- 大目标变成小步骤，降低创作难度
+- 明确优先级和依赖关系
+- 支持并行创作提高效率
+
+**典型时长**：20-30 分钟
+
+### 步骤 6：开始写作
+
+> "现在 `/write` 逐章使用 AI 辅助。规格和计划指导每一章，确保一致性。"
+
+**写作时**：
+- 类型知识 skills 自动激活
+- 一致性检查器在后台运行
+- 节奏监控在检测到问题时提醒
+
+**执行原则**：
+- 严格遵循 constitution 的原则
+- 参考 plan 中的技术方案
+- 完成 tasks 中的具体任务
+- 保持与规格的一致性
+
+**推荐节奏**：
+- 每次写作会话 1-2 章
+- 每 3-5 章停下来回顾
+- 保持前进动力，不要过度编辑
+
+### 步骤 7：质量检查
+
+> "每 5 章运行 `/analyze` 保持质量并及早发现问题。"
+
+**两种分析模式**：
+- **框架分析**（写作前）：验证规划
+- **内容分析**（写作后）：验证执行
+
+**验证维度**：
+- 宪法合规性（是否违背核心原则）
+- 规格满足度（是否实现了需求）
+- 内容一致性（情节、时间、人物）
+- 质量标准（是否达到设定标准）
+
+**何时运行**：
+- 完成前 3 章后（早期验证）
+- 每 5 章（定期检查）
+- 完成草稿后（全面审查）
+
+## Skills 自动激活
+
+在遵循此工作流时，相关 skills 将基于上下文激活：
+
+**在 `/specify` 期间**：
+- 如果你提到"言情"→ Romance skill 激活
+- 如果你提到"悬疑"→ Mystery skill 激活
+- 如果你提到"奇幻"→ Fantasy skill 激活
+
+**在 `/write` 期间**：
+- 写对话 → Dialogue Techniques 激活
+- 写场景 → Scene Structure 激活
+- 任何写作 → Consistency Checker 后台运行
+
+**整个过程中**：
+- Workflow Guide（此 skill）保持活跃
+- 确保你不跳过关键步骤
+- 在需要时提供提醒
+
+## 当用户偏离时
+
+如果用户尝试跳过步骤或直接开始写作而没有计划：
+
+**温和提醒**：
+> "我注意到你直接跳到写作。Novel-writer 的优势在于系统性的前期计划。你想运行 `/constitution` 和 `/specify` 建立坚实基础吗？这会使写作过程更流畅并有助于保持一致性。"
+
+**如果用户坚持跳过**：
+> "我理解 - 你总是可以稍后创建规划文档。但是，请注意，没有 `/specify` 和 `/plan`，你需要手动跟踪一致性。"
+
+## 不同规模项目的调整
+
+### 短篇小说（1-3 万字）
+
+**简化流程**：
+```
+/specify → /clarify → /write → /analyze
+```
+
+**重点**：明确核心冲突和转折
+
+**时间**：1-2 天密集工作
+
+### 中篇小说（10-20 万字）
+
+**标准流程**：
+```
+完整七步
+```
+
+**重点**：计划和任务分解
+
+**时间**：2-6 个月
+
+### 长篇连载（50 万字+）
+
+**强化流程**：
+```
+重复循环 plan → tasks → write → analyze
+```
+
+**重点**：持续的一致性验证
+
+**时间**：6-18 个月
+
+## 常见问题处理
+
+### "我已经有大纲了"
+
+> "太好了！让我们使用 `/specify` 将其转换为 novel-writer 的格式。这使其机器可读并启用所有追踪功能。"
+
+**过程**：
+1. 将现有大纲导入
+2. 用 `/specify` 格式化
+3. 用 `/clarify` 填补空白
+4. 用 `/plan` 创建详细的技术计划
+
+### "这看起来设置很多"
+
+> "设置需要 30-60 分钟，但节省了数小时的修订。你本质上是为你的小说创建'源代码' - 修改规格，重新生成内容。没有它，更改需要全文手动重写。"
+
+**收益**：
+- 保持一致性自动
+- 更改传播自动
+- 质量检查系统化
+- 修订更快更容易
+
+### "我可以只使用部分工作流吗？"
+
+> "可以，但有些命令相互依赖：
+> - `/write` 需要 `/specify` 和 `/plan` 才能有效工作
+> - `/analyze` 需要已写的章节来评估
+> - `/track` 需要先 `/track-init`
+> 
+> 最小可行工作流：`/constitution` → `/specify` → `/write`"
+
+**完全可选**：
+- `/clarify` - 如果你的规格已经清楚
+- `/tasks` - 如果你更喜欢自由形式写作
+- `/analyze` - 虽然强烈推荐
+
+### "这适合我的写作风格吗？"
+
+**兼容的写作风格**：
+- **规划者**：会喜欢结构
+- **裤子作者**（凭感觉写）：使用轻量级规格，专注于 `/write`
+- **混合型**：根据需要调整
+
+**调整建议**：
+- 规划者：在 `/plan` 上花更多时间
+- 裤子作者：保持 `/specify` 简短，允许发现
+- 混合型：使用完整流程但保持灵活
+
+## 进度追踪
+
+### 视觉进度指示器
+
+当你进行工作流时，我会显示你的位置：
+
+```
+✅ /constitution  完成
+✅ /specify       完成
+✅ /clarify       完成
+🔄 /plan          进行中...
+⏸️ /tasks         待定
+⏸️ /write         待定
+⏸️ /analyze       待定
+```
+
+### 里程碑
+
+**规划阶段完成**（steps 1-5）：
+- 你有完整的故事蓝图
+- 准备开始写作
+- 所有主要决策已做出
+
+**第一稿完成**（步骤 6）：
+- 所有章节已写
+- 准备全面分析
+- 进入修订阶段
+
+**质量验证通过**（步骤 7）：
+- 一致性验证
+- 符合质量标准
+- 准备发布或进一步润色
+
+## 与其他 Skills 的集成
+
+### 自动触发
+
+**当你提到类型时**：
+- "言情"→ Romance skill 提供惯例
+- "悬疑"→ Mystery skill 提供线索布置
+- "奇幻"→ Fantasy skill 提供世界构建
+
+**当你遇到困难时**：
+- "角色感觉平淡"→ 建议 Character Development commands
+- "场景拖沓"→ Scene Structure skill 激活
+- "对话僵硬"→ Dialogue Techniques skill 激活
+
+### 协作工作流
+
+**所有 Skills 都知道工作流**：
+- 他们会参考你在工作流中的位置
+- 建议基于当前阶段适当
+- 在需要时提醒完成前面的步骤
+
+## 成功模式
+
+### 高生产力模式
+
+```
+周一：/constitution + /specify（2-3小时）
+周二：/clarify + /plan（2-3小时）
+周三：/tasks + 开始 /write（2-3小时）
+周四-周日：/write 会话（每天1-2小时）
+下周一：/analyze + 计划下一批
+```
+
+### 探索性模式
+
+```
+第1周：/constitution + 轻量级 /specify
+第2-3周：/write 探索性章节
+第4周：基于学习更新 /specify 和 /plan
+第5-8周：结构化 /write
+第9周：/analyze 和修订
+```
+
+### 冲刺模式（NaNoWriMo）
+
+```
+第1天：快速 /constitution + /specify + /plan（4小时）
+第2-27天：密集 /write（每天2000字）
+第28-30天：/analyze + 紧急修复
+```
+
+## 你不是孤单的
+
+**在整个过程中**：
+- 我在这里指导和提醒
+- Skills 自动应用专业知识
+- 一致性自动检查
+- 你专注于创作，系统处理组织
+
+**你总是掌控**：
+- 跳过你不需要的步骤
+- 调整以适应你的风格
+- 随时更改计划
+- 工具服务于你，不是相反
+
+---
+
+**记住**：这个工作流不是枷锁 - 它是脚手架。它支持你的创作过程，使强大的东西成为可能。一旦你熟悉它，它就变成第二天性，你会想知道你以前是如何在没有它的情况下写作的。
+
+**准备开始了吗？让我们从 `/constitution` 开始！**
+

package/templates/skills/writing-techniques/character-arc/SKILL.md

@@ -0,0 +1,267 @@
+---
+name: character-arc-techniques
+description: "Use when writing character development scenes or planning character growth - provides real-time guidance on character arcs, transformation tracking, and growth consistency"
+allowed-tools: Read
+---
+
+# 角色弧线写作技巧 (Character Arc Techniques)
+
+## 快速参考（Quick Reference）
+
+### 写作中的角色弧线检查
+在写角色相关场景时,随时问自己：
+1. **角色现在处于弧线哪个阶段?** (8 阶段模型)
+2. **本章是否推进了角色成长?** (必须有变化)
+3. **成长是否通过行为展示?** (而非内心独白)
+4. **外部冲突是否逼迫内部成长?** (两者联动)
+
+### 三种弧线类型速查
+- **正向弧**：Lie → Truth (成长/救赎)
+- **负向弧**：Truth → Lie (堕落/悲剧)
+- **平面弧**：已知 Truth,改变他人 (英雄故事)
+
+## 核心原则 (Core Principles)
+
+### 1. 每章都应该推进角色弧线
+
+**检查方法**：
+- 章节开始时角色的信念状态
+- 章节结束时角色的信念状态
+- 如果完全相同 → 这章可能是废话
+
+**示例**：
+
+❌ **没有推进**：
+```
+第 10 章开始：林晓认为"依靠别人是弱点"
+[本章内容：打怪升级,与角色成长无关]
+第 10 章结束：林晓仍然认为"依靠别人是弱点"
+```
+
+✅ **有推进**：
+```
+第 10 章开始：林晓认为"依靠别人是弱点"
+[本章内容：独自行动失败,队友冒险救他]
+第 10 章结束：林晓开始质疑这个信念（出现裂痕）
+```
+
+### 2. 用行为展示成长,而非内心独白
+
+❌ **Tell 型成长**：
+```
+经历了这件事,林晓终于明白,真正的力量不是独来独往,
+而是信任队友。他决定改变。
+```
+
+✅ **Show 型成长**：
+```
+第二天的任务中,当队长询问意见时,
+林晓没有像往常一样冷着脸拒绝,而是沉默了几秒,
+然后说："我觉得……可以试试你的方案。"
+队长愣了一下,随即笑了。
+```
+
+### 3. 成长必须有代价
+
+**原则**：角色不会无缘无故改变。
+
+**代价类型**：
+- 失败的痛苦（尝试旧方法失败）
+- 关系的损失（坚持 Lie 导致失去重要的人）
+- 外部压力（环境逼迫必须改变）
+- 自我怀疑的煎熬（放弃旧信念的痛苦）
+
+### 4. 转变应该是渐进的
+
+**错误节奏**：
+- 前 20 章：完全没变
+- 第 21 章：突然顿悟
+- 后面：彻底变了
+
+**正确节奏**：
+- 每 5-10 章：一个小转变
+- 反复拉扯（前进 2 步,后退 1 步）
+- 中点（50%）：重要顿悟
+- 最终（75-85%）：完成转变
+
+## 实践应用 (Best Practices)
+
+### 写作前检查
+
+**在开始写一章前**：
+1. 读取 `spec/tracking/character-state.json`
+2. 确认角色当前弧线阶段（1-8）
+3. 规划本章要推进到哪个阶段
+4. 设计具体的行为变化
+
+### 写作中检查
+
+**在写作过程中**：
+- ✓ 每个重要选择 → 思考：角色是用 Lie 还是 Truth 做决定?
+- ✓ 每段对话 → 思考：能否暗示信念的变化?
+- ✓ 每个冲突 → 思考：是否逼迫角色面对内在缺陷?
+
+### 写作后检查
+
+**章节完成后**：
+1. 更新 `character-state.json` 中的角色状态
+2. 标注本章的弧线阶段
+3. 检查是否有明显的行为变化证据
+4. 验证转变是否合理（有铺垫、有代价）
+
+### 与 /track 命令的配合
+
+执行 `/track` 时，会更新：
+```json
+{
+  "characterName": "林晓",
+  "arc": {
+    "type": "positive",
+    "currentStage": 4,  // 阶段 4: 抗拒改变
+    "lie": "依靠别人是弱点",
+    "truth": "信任是力量而非弱点",
+    "lastChange": {
+      "chapter": 10,
+      "evidence": "首次接受队友建议"
+    }
+  }
+}
+```
+
+## 常见陷阱 (Common Pitfalls)
+
+### 1. 角色学不乖（重复同样错误）
+
+**症状**：
+- 角色在第 5 章犯的错，第 25 章还在犯
+- 没有学习和成长的痕迹
+
+**解决**：
+- 检查 character-state.json，确认弧线进展
+- 每次犯错应该是"更高级的错"（螺旋上升）
+
+### 2. 转变太突然（缺乏铺垫）
+
+**症状**：
+- 前一章还坚持 Lie，下一章就完全接受 Truth
+- 读者反馈"不可信""太假"
+
+**解决**：
+- 至少提前 5-10 章开始埋下怀疑的种子
+- 设计小的失败让角色质疑 Lie
+- 中点安排重要顿悟（但未完全转变）
+
+### 3. 成长与情节脱节
+
+**症状**：
+- 外部情节：主角拯救世界
+- 内部成长：主角克服社交恐惧
+- 两者完全无关
+
+**解决**：
+- 确保外部冲突逼迫内部成长
+- 示例：必须团队合作才能拯救世界 → 逼迫克服社交恐惧
+
+### 4. 多个主角的弧线混乱
+
+**症状**：
+- 主角 A 的成长时机抢了主角 B 的戏
+- 弧线节奏冲突
+
+**解决**：
+- 错开弧线高峰（A 中点顿悟时，B 处于低谷）
+- 互相影响（A 的成长帮助 B 开始质疑）
+
+## 角色弧线阶段速查表
+
+| 阶段 | 名称 | 角色状态 | 章节位置 (%) | 标志事件 |
+|-----|------|---------|------------|---------|
+| 1 | 日常世界 | 完全活在 Lie 中 | 0-10% | 展示 Lie 的影响 |
+| 2 | 渴望 vs 需求 | 想要 Want,不知 Need | 10-15% | 事件打破平衡 |
+| 3 | 新世界 | 首次接触 Truth | 15-25% | 离开舒适区 |
+| 4 | 抗拒 | 拒绝 Truth,抓住 Lie | 25-40% | 用旧方法失败 |
+| 5 | 中点顿悟 | 看见 Truth（但未接受） | 40-60% | 重要认知转变 |
+| 6 | 深渊 | Lie vs Truth 拉锯 | 60-75% | 黑暗时刻 |
+| 7 | 选择 | 放弃 Want,接受 Need | 75-85% | 关键选择时刻 |
+| 8 | 新自我 | 用 Truth 解决冲突 | 85-100% | 证明成长 |
+
+## 实时建议触发
+
+**当用户在写作时提到以下内容，主动提供建议**：
+
+### 触发词：角色决策场景
+> "林晓面临选择……"
+
+**建议**：
+- 检查：这个选择是基于 Lie 还是 Truth?
+- 如果基于 Lie → 应该导致失败（推进弧线）
+- 如果基于 Truth → 检查是否太早（弧线阶段）
+
+### 触发词：角色情绪反应
+> "林晓很生气……"
+
+**建议**：
+- 思考：这个情绪背后的深层信念是什么?
+- 是否与 Lie 或 Truth 有关?
+- 能否通过行为展示而非直接说出?
+
+### 触发词：角色关系变化
+> "林晓和队友的关系……"
+
+**建议**：
+- 关系变化通常反映内在成长
+- 检查关系变化是否对应弧线阶段
+- 确保关系变化有具体事件支撑
+
+## 检查清单 (Checklist)
+
+### 规划阶段（/specify, /plan）
+- [ ] 角色的 Lie 和 Truth 是否清晰定义?
+- [ ] 弧线类型是否确定（正/负/平）?
+- [ ] 八个阶段是否对应到章节?
+- [ ] 外部冲突是否逼迫内部成长?
+
+### 写作阶段（/write）
+- [ ] 本章角色处于哪个弧线阶段?
+- [ ] 本章是否推进了弧线?
+- [ ] 成长是否通过行为展示?
+- [ ] 角色状态是否已更新到 tracking?
+
+### 分析阶段（/analyze）
+- [ ] 弧线进展是否符合规划?
+- [ ] 转变是否有足够铺垫?
+- [ ] 是否避免了突兀转变?
+- [ ] 角色行为是否前后一致?
+
+## 与其他工具的集成
+
+### 与 craft/character-arc.md 的关系
+- **本 Skill**：快速检查和实时建议
+- **Knowledge Base**：完整理论和详细案例
+- **使用建议**：写作时用 Skill，遇到困难时读 Knowledge Base
+
+### 与 consistency-checker Skill 的配合
+- consistency-checker 检查行为是否一致
+- character-arc 检查成长是否合理
+- 两者互补
+
+### 与 pre-write-checklist Skill 的配合
+- pre-write-checklist 确保加载角色状态
+- character-arc 提供具体写作建议
+
+## 进阶使用
+
+### 多主角弧线管理
+- 为每个主角维护独立的 character-state
+- 错开弧线高峰时刻
+- 设计弧线交叉影响
+
+### 群像角色的弧线
+- 主角：完整弧线（8 阶段）
+- 重要配角：简化弧线（3-5 阶段）
+- 次要角色：可以是平面角色（无弧线）
+
+---
+
+**使用建议**：
+将本 Skill 设为写作时的常驻参考，每写一章都过一遍检查清单。