novelws 1.2.0

package/templates/skills/genre-knowledge/fantasy/SKILL.md

@@ -0,0 +1,355 @@
+---
+name: fantasy-world-building
+description: "Use when user mentions fantasy, magic system, or world-building for fantastical settings - provides fantasy genre conventions, magic system design patterns, and world-building frameworks"
+allowed-tools: Read, Grep
+---
+
+# 奇幻小说世界构建规范
+
+## 快速参考
+
+| 元素 | 指导原则 | 关键点 |
+|------|---------|-------|
+| **魔法系统** | 必须有清晰规则 | 限制比力量更重要 |
+| **世界设定** | 内在自洽 | 每个规则都有原因 |
+| **种族/生物** | 独特且有逻辑 | 避免单纯的人类翻版 |
+| **历史深度** | 至少三代历史 | 过去影响现在 |
+| **政治结构** | 权力分布清晰 | 冲突有根源 |
+
+## 核心原则
+
+### Sanderson 魔法法则
+
+**第一法则**：读者从魔法中获得的满足感，与其理解魔法的程度成正比
+- 如果魔法要解决问题，读者必须理解它的规则
+- 软魔法系统（神秘）用于氛围和奇观
+- 硬魔法系统（规则明确）用于解决问题
+
+**第二法则**：限制比力量更有趣
+- 强大的魔法需要强大的代价
+- 限制创造冲突和策略
+- 完美的系统无法创造戏剧
+
+**第三法则**：在添加新东西之前，先扩展已有的
+- 深化现有元素胜过添加新元素
+- 相互关联的系统比孤立的更强
+- 复杂度应该有机生长
+
+## 魔法系统设计
+
+### 硬魔法系统（规则明确）
+
+**必要元素**：
+1. **能量来源**
+   - 魔法从哪里来？
+   - 是有限的还是无限的？
+   - 可以耗尽吗？
+
+2. **使用规则**
+   - 谁能使用？如何获得？
+   - 需要什么条件？
+   - 有什么限制？
+
+3. **代价/后果**
+   - 使用魔法的成本是什么？
+   - 过度使用会怎样？
+   - 是否有长期影响？
+
+4. **可能与不可能**
+   - 魔法能做什么？
+   - 明确不能做什么
+   - 边界在哪里？
+
+**示例框架**：
+
+```
+魔法系统：元素操控
+来源：每个人出生时拥有一种元素亲和
+规则：只能操控自己的元素，需要该元素存在于周围
+限制：精神疲劳，过度使用导致元素反噬
+代价：使用魔法时消耗生命力，需要休息恢复
+禁忌：不能创造元素，只能操控；不能操控生物体内的元素
+```
+
+### 软魔法系统（神秘感）
+
+**特征**：
+- 规则不完全为读者所知
+- 更多用于氛围和奇观
+- 不应该方便地解决主要冲突
+- 保持神秘感和敬畏
+
+**使用场景**：
+- 古老的魔法，已部分遗失
+- 神祇力量，超越凡人理解
+- 背景奇观和世界建设
+- 不影响主线解决的辅助情节
+
+## 世界构建框架
+
+### 地理与环境
+
+**必须考虑**：
+1. **地形**
+   - 山脉、河流、海洋如何影响文明？
+   - 气候如何塑造文化？
+   - 资源分布如何影响经济？
+
+2. **生态系统**
+   - 食物链是什么样的？
+   - 魔法生物如何适应环境？
+   - 人类/其他智慧种族如何生存？
+
+3. **魔法对地理的影响**
+   - 魔法如何改变自然？
+   - 有魔法造成的地标吗？
+   - 魔法灾难留下了什么痕迹？
+
+### 社会与文化
+
+**层次架构**：
+
+**政治层面**：
+- 政府形式（君主制、民主、神权等）
+- 权力如何传递？
+- 魔法如何影响政治？
+- 不同派系的冲突
+
+**经济层面**：
+- 贸易什么？为什么？
+- 货币系统
+- 魔法如何影响经济？
+- 资源稀缺性
+
+**社会层面**：
+- 阶级结构
+- 种族关系
+- 魔法使用者的地位
+- 教育和知识传播
+
+**文化层面**：
+- 宗教和信仰
+- 艺术和娱乐
+- 节日和传统
+- 价值观和禁忌
+
+### 历史深度
+
+**最少三代历史**：
+
+**当代**（故事发生时）：
+- 现状是什么？
+- 主要冲突和问题
+- 主要势力和人物
+
+**父辈代**（30-50年前）：
+- 什么事件塑造了当代？
+- 老一辈记得什么？
+- 遗留的问题
+
+**祖辈代**（60-100年前）：
+- 传说和故事
+- 失落的知识
+- 历史创伤
+
+**古代**（更久远）：
+- 神话和传说
+- 文明的兴衰
+- 为当代设定埋下种子
+
+## 种族与生物设计
+
+### 智慧种族
+
+**避免单一特征**：
+❌ 所有精灵都优雅高贵
+❌ 所有矮人都贪婪暴躁
+❌ 所有兽人都野蛮好战
+
+**创造深度**：
+✅ 内部多样性（不同文化、价值观）
+✅ 个体差异（性格各异）
+✅ 历史复杂性（好的和坏的历史）
+
+**种族特征应该有原因**：
+- 生理特征如何帮助生存？
+- 文化特征从何而来？
+- 与其他种族的关系历史
+
+### 魔法生物
+
+**设计原则**：
+1. **生态位**
+   - 它在生态系统中的角色？
+   - 吃什么？被什么吃？
+   - 如何繁殖？
+
+2. **魔法来源**
+   - 为什么有魔法？
+   - 魔法如何帮助它生存？
+   - 有什么代价或限制？
+
+3. **与人类的关系**
+   - 危险还是有用？
+   - 能驯养吗？
+   - 人类如何应对？
+
+## 常见陷阱
+
+### ❌ 过度解释
+
+**问题**：花费章节解释世界设定，停止故事推进
+
+**解决**：
+- 在行动中展示设定
+- 只解释角色需要知道的
+- 让读者自己拼凑一些东西
+- 信息应该服务于情节或角色
+
+### ❌ 不一致的规则
+
+**问题**：魔法/世界规则为了情节便利而改变
+
+**解决**：
+- 提前建立所有主要规则
+- 跟踪已建立的规则
+- 例外需要早期暗示
+- 让角色在限制内创造性地解决问题
+
+### ❌ 欧洲中世纪默认设置
+
+**问题**：所有奇幻都是欧洲中世纪的翻版
+
+**解决**：
+- 探索其他文化和时期
+- 混合多个文化元素
+- 创造独特的社会结构
+- 考虑魔法如何改变社会发展
+
+### ❌ 选中之人陷阱
+
+**问题**：主角因为预言/血统特殊，而非行动
+
+**解决**：
+- 让主角通过选择变得特殊
+- 即使有预言，也让他们努力实现
+- 颠覆或解构陷阱
+- 专注于角色成长，而非天赋
+
+## 奇幻子类型
+
+### 高奇幻（史诗奇幻）
+- 完全虚构的世界
+- 善恶对抗
+- 史诗般的规模和风险
+- 魔法是世界的一部分
+
+### 低奇幻
+- 现实世界+魔法元素
+- 较小的个人风险
+- 魔法稀有且神秘
+- 更接地气的基调
+
+### 城市奇幻
+- 现代城市设定
+- 隐藏的魔法世界
+- 通常有侦探/神秘元素
+- 两个世界的碰撞
+
+### 黑暗奇幻
+- 道德灰色
+- 恐怖和暴力元素
+- 反英雄主角
+- 更严酷的后果
+
+## 与 Novel-Writer 命令集成
+
+### 当 `/specify` 执行时
+- 定义核心世界元素（魔法、种族、地理）
+- 识别奇幻子类型
+- 列出必须建立的主要规则
+- 计划信息揭示的节奏
+
+### 在 `/plan` 期间
+- 绘制世界元素如何影响情节
+- 计划魔法系统的展示
+- 设计不同文化的碰撞
+- 确保世界规则的一致性
+
+### 在 `/write` 时
+- 在行动中展示世界，而非倾倒
+- 让角色对世界元素做出反应
+- 使用感官细节使世界生动
+- 保持已建立规则的一致性
+
+### 在 `/analyze` 期间
+- 检查世界规则的一致性
+- 验证魔法系统的逻辑
+- 确认所有世界元素都有目的
+- 确保设定服务于故事
+
+## 世界构建检查清单
+
+- [ ] 魔法系统有清晰的规则和限制
+- [ ] 地理和气候影响文化和情节
+- [ ] 至少三代历史深度
+- [ ] 多个政治势力有清晰动机
+- [ ] 经济和贸易有逻辑基础
+- [ ] 种族/文化有内部多样性
+- [ ] 魔法生物有生态位和目的
+- [ ] 宗教/信仰系统有影响
+- [ ] 社会结构有明确阶级和流动性
+- [ ] 所有规则在整个故事中保持一致
+
+## 信息揭示策略
+
+### 冰山原则
+
+**创造的 vs 展示的**：
+- 创造 100%，但只展示 10-20%
+- 读者不需要知道所有东西
+- 深度创造自信和一致性
+- 作者知道的比展示的多
+
+### 展示时机
+
+**第一章**：
+- 基本世界观（不是详尽说明）
+- 一个引人注目的魔法/奇幻元素
+- 主角在世界中的位置
+
+**前 25%**：
+- 核心魔法系统规则
+- 主要种族/文化
+- 中心冲突及其世界根源
+
+**中段**：
+- 深化已建立元素
+- 复杂化世界政治
+- 揭示历史影响
+
+**后段**：
+- 连接所有世界线索
+- 揭示深层历史
+- 展示世界元素如何解决冲突
+
+## 读者期望
+
+**奇幻读者想要什么**：
+- 沉浸式、可信的世界
+- 一致且有趣的魔法系统
+- 复杂的文化和政治
+- 对经典陷阱的新鲜视角
+- 世界感觉比故事更大
+
+**让奇幻读者沮丧的是什么**：
+- 不一致的世界规则
+- 方便情节的魔法
+- 单薄的欧洲中世纪抄袭
+- 缺乏深度的世界
+- 信息倾倒而非有机揭示
+
+---
+
+**记住**：伟大的世界构建是故事的基础，而非目的。世界应该服务于角色和情节，而角色的行动应该受到世界规则的塑造和限制。平衡深度与叙事流畅性是关键。
+

package/templates/skills/genre-knowledge/mystery/SKILL.md

@@ -0,0 +1,337 @@
+---
+name: mystery-novel-conventions
+description: "Use when user mentions mystery, detective, crime, or suspense-focused narrative - provides genre conventions, clue placement, and fair play principles for mystery writing"
+allowed-tools: Read, Grep
+---
+
+# 悬疑推理小说创作规范
+
+## 快速参考
+
+| 元素 | 指导原则 | 位置 |
+|------|---------|------|
+| **触发事件** | 案件/谜团发生 | 前 10% |
+| **误导线索** | 错误的引导 | 贯穿全文，3-5 个 |
+| **真实线索** | 公平游戏的证据 | 75% 之前 |
+| **真相揭露** | 真相揭示 | 85-95% |
+| **收尾** | 结束所有线索 | 最后 5% |
+
+## 核心原则
+
+### 公平游戏原则
+
+**黄金法则**：读者必须在侦探之前获得所有解决谜团所需的线索。
+
+1. **没有隐藏信息**
+   - 所有关键线索都必须呈现给读者
+   - 侦探不能基于读者不知道的信息破案
+   - 只在结尾揭示的秘密证据违反公平游戏
+
+2. **逻辑推理**
+   - 解决方案必须能从呈现的事实中逻辑推导
+   - 巧合可以使情况复杂化，但永远不能解决
+   - 直觉可以，但必须基于已展示的证据
+
+3. **不使用机械降神**
+   - 不能突然出现新角色作为罪犯
+   - 不能有之前未提及的能力或工具
+   - 不能有神的干预或纯粹的运气
+
+## 悬疑小说结构
+
+### 第一幕：铺垫（0-25%）
+
+**建立常态世界**：
+- 介绍主角和他们的世界
+- 展示角色能力
+- 埋下性格怪癖的种子
+
+**案件发生**：
+- 在前 10% 发生
+- 必须足够有趣/不寻常以证明调查的必要性
+- 风险应该清晰
+
+**初步调查**：
+- 主角接受案件
+- 首次访谈和证据收集
+- 建立关键嫌疑人
+
+### 第二幕：调查（25-75%）
+
+**收集线索**：
+- 呈现所有公平游戏的证据
+- 混合真实线索与误导线索
+- 每条线索都应该感觉重要
+
+**误导线索**：
+- 3-5 条看似有希望的虚假线索
+- 必须足够可信以误导
+- 最终通过逻辑调查证伪
+
+**复杂化升级**：
+- 新证据与旧理论矛盾
+- 嫌疑人有不在场证明或秘密
+- 风险升级（更多案件、主角面临危险）
+
+**中点转折**（约 50%）：
+- 重新框架谜团的重大揭示
+- 主角的理论被证明错误
+- 新角度出现
+
+### 第三幕：解决（75-100%）
+
+**黑暗之夜**（75-85%）：
+- 主角似乎被难住
+- 所有理论都失败了
+- 绝望或怀疑的时刻
+
+**真相揭露**（85-95%）：
+- 关键洞察连接所有点
+- 主角重构真相
+- 与罪犯对峙
+
+**收尾**（95-100%）：
+- 解释如何/为什么
+- 所有松散的线索被收紧
+- 正义得到伸张（或有意颠覆）
+
+## 线索布置策略
+
+### 线索类型
+
+**物理证据**：
+- 物品、指纹、DNA
+- 必须在需要之前埋下
+- 重要性最初可能不清楚
+
+**证言证据**：
+- 证人陈述
+- 不在场证明及其矛盾
+- 谎言（有意或无意）
+
+**行为证据**：
+- 角色对事件的反应
+- 不寻常的行为模式
+- 通过行动揭示的动机
+
+**circumstantial证据**：
+- 机会、手段、动机
+- 模式和联系
+- 时间线不一致
+
+### 线索布置时机
+
+**早期线索**（0-25%）：
+- 建立基准事实
+- 埋下看似无辜的种子
+- 介绍所有关键嫌疑人
+
+**中期线索**（25-75%）：
+- 混合真实线索与误导线索
+- 使情况复杂化
+- 揭示角色动机
+
+**后期线索**（75-85%）：
+- 使其可解的最后一块拼图
+- 可以是一直存在的东西
+- 主角的顿悟时刻
+
+## 误导线索最佳实践
+
+### 有效的误导线索
+
+**特征**：
+- 足够可信以显得真实
+- 有一些证据支持
+- 最终通过逻辑被证伪
+- 揭示为虚假时不显得廉价
+
+**示例**：
+- 有强烈动机但坚实不在场证明的嫌疑人
+- 被栽赃的有罪证据
+- 巧合出现在犯罪现场
+- 看起来有罪但实际无辜的秘密活动
+
+### 常见错误
+
+❌ **太明显**：读者立即看穿
+❌ **太勉强**：感觉强迫和人为
+❌ **从不解释**：悬而未决没有解决
+❌ **太多**：读者失去追踪并感到沮丧
+
+## 嫌疑人管理
+
+### 经典设置
+
+**至少 3 个嫌疑人**：
+- 每个都需要动机、手段和机会
+- 每个在某个时刻都应该显得有罪
+- 至少一个应该是同情的
+
+**罪犯**：
+- 应该在介绍的角色中（公平游戏）
+- 必须有最终揭示的逻辑动机
+- 他们有罪的线索必须从早期就存在
+
+**误导嫌疑人**：
+- 最明显的选择
+- 强烈的动机和间接证据
+- 最终通过调查被排除
+
+**同情嫌疑人**：
+- 读者希望不是有罪的
+- 有值得保护的秘密
+- 通常帮助解决真正的谜团
+
+### 角色秘密
+
+**每个嫌疑人都应该有秘密**：
+- 不是所有秘密都与案件相关
+- 秘密创造误导
+- 揭示秘密推进调查
+- 有些秘密比案件更具破坏性
+
+## 常见陷阱
+
+### ❌ 不可知的解决方案
+
+**问题**：罪犯或方法依赖读者没有的信息
+
+**解决**：在 75% 标记之前埋下所有必要线索；读者应该能够解决
+
+### ❌ 无能的侦探
+
+**问题**：主角错过明显线索或行为不合逻辑
+
+**解决**：让侦探有能力但人性化；他们可以犯错，但不是愚蠢
+
+### ❌ 太多巧合
+
+**问题**：情节通过方便的运气而非调查推进
+
+**解决**：巧合可以使情况复杂化，永远不能解决；侦探必须努力寻找答案
+
+### ❌ 无聊的中段
+
+**问题**：调查变成重复的访谈接访谈
+
+**解决**：变化调查方法；添加动作、危险、个人风险
+
+### ❌ 仓促的解释
+
+**问题**：复杂的解决方案在最后一章的对话中倾倒
+
+**解决**：分散揭示；让读者拼凑；保持解释清晰但不冗长
+
+## 子类型变化
+
+### 温馨推理
+- 业余侦探
+- 有限的暴力描写
+- 小社区背景
+- 角色驱动
+- 通常幽默的基调
+
+### 硬派侦探
+- 专业调查员
+- 粗糙、现实的暴力
+- 道德复杂的世界
+- 愤世嫉俗的基调
+- 动作导向
+
+### 警察程序
+- 专注于调查过程
+- 多个侦探/团队
+- 现实的程序
+- 技术细节重要
+- 官僚主义作为障碍
+
+### 密室推理
+- 不可能的犯罪场景
+- 有限的嫌疑人（谁有机会）
+- 巧妙的方法是关键
+- 解决方案必须合乎逻辑
+
+## 与 Novel-Writer 命令集成
+
+### 当 `/specify` 执行时
+- 清晰定义中心谜团
+- 列出所有主要嫌疑人及其动机
+- 识别关键线索及其出现位置
+- 决定公平游戏规则
+
+### 在 `/plan` 期间
+- 绘制线索布置时间线
+- 设计误导线索模式
+- 计划调查序列
+- 结构揭示和反转
+
+### 在 `/write` 时
+- 确保线索可见但不明显
+- 平衡调查与角色发展
+- 保持节奏（动作、揭示、复杂化）
+- 跟踪读者知道什么vs侦探知道什么
+
+### 在 `/analyze` 期间
+- 验证公平游戏 - 读者能解决吗？
+- 检查所有线索是否已埋下
+- 确保没有机械降神
+- 确认令人满意的解决
+
+## 悬疑写作检查清单
+
+- [ ] 中心谜团引人入胜且清晰
+- [ ] 3-5 个有动机的可行嫌疑人
+- [ ] 揭示前呈现所有关键线索
+- [ ] 误导线索可信且最终得到解释
+- [ ] 侦探有能力且合乎逻辑
+- [ ] 解决方案可从给定信息推导
+- [ ] 没有巧合解决谜团
+- [ ] 时间线一致且可追踪
+- [ ] 所有松散的线索都被收紧
+- [ ] 揭示令人满意，而非令人失望
+
+## 线索可见性框架
+
+### 三个层次
+
+**层次 1 - 明显**（25% 的线索）：
+- 引入时明确重要
+- 主角和读者一起注意到
+- 建立基准事实
+
+**层次 2 - 微妙**（50% 的线索）：
+- 提及但不强调
+- 重要性后来变得清晰
+- 奖励细心的读者
+
+**层次 3 - 藏在显眼处**（25% 的线索）：
+- 引入时看似无关紧要
+- 只有在回顾时才有意义
+- "啊哈！"时刻
+
+### 示例
+
+**层次 1**："窗户从里面解锁"  
+**层次 2**：角色在闲聊中提到自己是左撇子  
+**层次 3**：房间描述包括烟灰缸中的特定品牌香烟
+
+## 读者期望
+
+**悬疑读者想要什么**：
+- 与侦探一起解决的公平机会
+- 事后有意义的聪明转折
+- 有能力但会犯错的主角
+- 令人满意的"啊哈！"时刻
+- 正义（或有目的的有意颠覆）
+
+**让悬疑读者沮丧的是什么**：
+- 只在结尾揭示的隐藏信息
+- 通过未展示的推理解决的主角
+- 勉强的巧合
+- 没有误导的明显罪犯
+- 松散的线索悬而未决
+
+---
+
+**记住**：一个伟大的谜团让读者因解决它而感到聪明，或因没有看到它而印象深刻 - 但总是满意线索一直都在那里。