novelws 1.2.0

package/templates/memory/personal-voice.md

@@ -0,0 +1,113 @@
+# 个人语料与表达指纹（Personal Voice）
+
+用途：为写作提供稳定、自然的个人表达基础。越具体越好，尽量来自你的真实经历与说话习惯
+
+## 口头禅与常用表达
+- 示例：我嘴快，但心里有数
+- 示例：先把话挑明，再慢慢办
+- 示例：这事儿吧，怎么说呢
+- 示例：得，就这么定了
+
+## 固定句式与节奏偏好
+- 示例：长句里讲道理，短句落锤
+- 示例：段落喜欢先摆事实，后给判断
+- 示例：爱用"...但是吧"转折
+- 示例：习惯性重复关键词强调
+
+## 词汇选择偏好
+- **常用词替代**
+  - 把"因此"说成"所以"、"这么着"
+  - 把"然而"说成"可是"、"但是吧"
+  - 把"非常"说成"特别"、"老"、"挺"
+  - 把"或许"说成"也许"、"说不定"、"兴许"
+- **量词习惯**
+  - 一个人/一位人、一只狗/一条狗
+  - 一顿饭/一餐饭、一场雨/一阵雨
+- **形容词口味**
+  - 少用"美丽"多用"好看"、"漂亮"
+  - 少用"优秀"多用"不错"、"挺好"
+  - 避免书面化形容词，偏爱口语化
+
+## 句子构造习惯
+- **习惯性开头**
+  - 那什么、我跟你说、你知道吗
+  - 说真的、讲道理、实话实说
+  - 要我说、依我看、咱这么想
+- **句中口头禅**
+  - 就是说、那个啥、怎么说呢
+  - 对吧、是不是、你说呢
+  - 这个吧、那啥、反正吧
+- **结尾语气词**
+  - 吧、啊、呢、嘛、哈
+  - 的、了、着、过（动态助词使用偏好）
+  - 省略号使用习惯（...或。。。）
+
+## 生活经历清单（可写片段名或关键词）
+- 示例：冬天在厂里连夜抢修
+- 示例：高铁上目送一位老人到站没人接
+- 示例：小时候邻居家的那只大黄狗
+- 示例：第一次进城时的窘迫
+
+## 行业/地域词汇（口音、俚语、术语）
+- 示例：北方口音词：咣当、抻、撂
+- 示例：行业术语：回填、预案、解骚（中医）
+- 示例：方言词：嘎嘣脆、溜达、唠嗑
+- 示例：网络用语的使用频率和类型
+
+## 自然化缺陷（重要：增加真实感）
+- **偶尔的错别字**（每千字1-2处）
+  - 的地得混用："他欢快的跑着"
+  - 同音字错误："在哪"写成"在那"
+- **标点随意性**
+  - 省略号数量不固定：...或。。。或……
+  - 逗号和句号的随意使用
+  - 偶尔忘记标点，特别是对话中
+- **口语化省略**
+  - 把"但是"说成"但"
+  - 把"这样"说成"这样儿"
+  - 主语省略："觉得这事不靠谱"
+- **语法不完美**
+  - 偶尔的语序调整："这事我真没想到"
+  - 不完整句："要是能早点知道..."
+  - 重复强调："真的真的很重要"
+
+## 写作忌口与避讳
+- 示例：少用"众所周知""在某种程度"等空话
+- 示例：避免套路化励志语
+- 示例：不用文绉绉的书面语
+- 示例：避免过度使用成语
+
+## 比喻口味与意象库
+- 示例：铁轨、雾气、路灯、雨棚、手套味道
+- 示例：用器物与气味代替抽象名词
+- 示例：偏爱具体场景而非抽象概念
+- 示例：生活化比喻优于文学化比喻
+
+## 思维模式与表达逻辑
+- **联想跳跃**
+  - 从A突然想到B的模式
+  - 话题转换的个人习惯
+  - 插入语和补充说明的位置
+- **情绪表达**
+  - 激动时的语言变化
+  - 生气时的用词特点
+  - 开心时的表达方式
+- **叙述顺序**
+  - 倾向时间顺序还是重要性顺序
+  - 爱不爱用倒叙、插叙
+  - 细节补充的时机
+
+## 常见场景的说话方式
+- 示例：安慰人不爱直接说大道理，更愿意讲个亲历的小事
+- 示例：批评时先肯定后指出问题
+- 示例：紧张时语速加快，用词重复
+- 示例：思考时的口头禅"这个嘛..."
+
+## 个人价值取向与反复念叨的话
+- 示例：能把事办明白，比把话说漂亮更重要
+- 示例：人得实在，别整那些虚的
+- 示例：日子是自己过的，别太在意别人说啥
+
+---
+提示：本文件越常更新，生成文本越接近你的真实表达
+

package/templates/scripts/README.md

@@ -0,0 +1,187 @@
+# 脚本工具集
+
+本目录包含 Novel Writer Skills 的命令行脚本工具，作为 Claude Code Slash Commands 的替代方案。
+
+## 📂 目录结构
+
+```text
+scripts/
+├── bash/          # macOS/Linux 脚本
+├── powershell/    # Windows 脚本
+└── README.md      # 本文档
+```
+
+## 🔄 novel-writer-skills 适配说明
+
+这些脚本已从 [novel-writer](https://github.com/wordflowlab/novel-writer) 移植并适配到 novel-writer-skills 项目结构：
+
+### 路径差异
+
+| 文件 | novel-writer | novel-writer-skills |
+|------|-------------|-------------------|
+| 宪法文件 | `memory/constitution.md` | `.specify/memory/constitution.md` |
+| 故事规格 | `stories/*/specification.md` | `stories/*/specification.md` ✅ |
+| 追踪数据 | `spec/tracking/*.json` | `spec/tracking/*.json` ✅ |
+
+**所有脚本已自动适配新路径**，无需手动修改！
+
+## 🎯 使用场景
+
+虽然 Novel Writer Skills 主要为 Claude Code 设计，但这些脚本提供了：
+
+- ✅ **命令行替代方案** - 在终端中直接执行操作
+- ✅ **自动化工作流** - 集成到 CI/CD 或自动化脚本中
+- ✅ **批处理操作** - 处理多个故事或批量检查
+- ✅ **独立工具** - 不依赖 Claude Code 的独立功能
+
+## 🚀 快速开始
+
+### macOS/Linux 用户
+
+```bash
+# 进入项目根目录
+cd my-novel
+
+# 使用脚本（示例：创建宪法）
+bash .specify/templates/scripts/bash/constitution.sh
+
+# 或者添加到 PATH
+export PATH="$PATH:$(pwd)/.specify/templates/scripts/bash"
+constitution.sh
+```
+
+### Windows 用户
+
+```powershell
+# 进入项目根目录
+cd my-novel
+
+# 使用脚本（示例：创建宪法）
+.\.specify\templates\scripts\powershell\constitution.ps1
+
+# 或者添加到环境变量
+$env:PATH += ";$(Get-Location)\.specify\templates\scripts\powershell"
+constitution.ps1
+```
+
+## 📚 核心脚本
+
+### 七步方法论
+
+| 脚本 | 功能 | 对应命令 |
+|-----|------|---------|
+| `constitution.sh/ps1` | 创建创作宪法 | `/constitution` |
+| `specify-story.sh/ps1` | 定义故事规格 | `/specify` |
+| `clarify-story.sh/ps1` | 澄清模糊点 | `/clarify` |
+| `plan-story.sh/ps1` | 制定创作计划 | `/plan` |
+| `generate-tasks.sh/ps1` | 生成任务清单 | `/tasks` |
+| `analyze-story.sh/ps1` | 质量验证分析 | `/analyze` |
+
+### 追踪与检查
+
+| 脚本 | 功能 | 对应命令 |
+|-----|------|---------|
+| `init-tracking.sh/ps1` | 初始化追踪系统 | `/track-init` |
+| `track-progress.sh/ps1` | 综合追踪更新 | `/track` |
+| `check-plot.sh/ps1` | 情节一致性检查 | `/plot-check` |
+| `check-timeline.sh/ps1` | 时间线管理 | `/timeline` |
+| `manage-relations.sh/ps1` | 角色关系追踪 | `/relations` |
+| `check-world.sh/ps1` | 世界观验证 | `/world-check` |
+| `check-consistency.sh/ps1` | 一致性检查 | - |
+| `check-writing-state.sh/ps1` | 写作状态检查 | - |
+
+### 工具脚本
+
+| 脚本 | 功能 |
+|-----|------|
+| `common.sh/ps1` | 通用函数库（被其他脚本引用） |
+| `text-audit.sh/ps1` | 文本审计工具 |
+| `test-word-count.sh` | 字数统计（仅 bash） |
+
+## 🔧 通用函数库
+
+`common.sh` 和 `common.ps1` 提供了以下公共函数：
+
+### Bash 函数
+
+```bash
+get_project_root()    # 获取项目根目录
+get_current_story()   # 获取当前故事目录
+get_active_story()    # 获取活跃故事名称
+create_numbered_dir() # 创建带编号的目录
+```
+
+### PowerShell 函数
+
+```powershell
+Get-ProjectRoot       # 获取项目根目录
+Get-CurrentStoryDir   # 获取当前故事目录
+Get-ActiveStory       # 获取活跃故事名称
+```
+
+## ⚠️ 注意事项
+
+1. **项目根目录识别** - 脚本通过查找 `.specify/config.json` 确定项目根目录
+2. **执行权限** - Linux/macOS 用户需要确保脚本有执行权限：
+   ```bash
+   chmod +x .specify/templates/scripts/bash/*.sh
+   ```
+3. **与 Slash Commands 的区别**：
+   - Slash Commands 在 Claude Code 中使用，有 AI 交互能力
+   - 脚本适合自动化和批处理，无 AI 交互
+   - 推荐优先使用 Slash Commands 以获得最佳体验
+
+## 🆚 何时使用脚本 vs Slash Commands
+
+| 场景 | 推荐方式 |
+|-----|---------|
+| 日常创作、需要 AI 协助 | ✅ Slash Commands |
+| 批量处理、自动化 | ✅ 脚本 |
+| CI/CD 集成 | ✅ 脚本 |
+| 学习和理解工作流 | ✅ 脚本（可查看源码） |
+| 快速检查和验证 | ✅ 脚本 |
+
+## 📖 示例：完整工作流
+
+```bash
+# 1. 创建宪法
+bash constitution.sh
+
+# 2. 定义故事规格
+bash specify-story.sh
+
+# 3. 澄清模糊点（通常需要人工参与）
+bash clarify-story.sh
+
+# 4. 制定计划
+bash plan-story.sh
+
+# 5. 生成任务
+bash generate-tasks.sh
+
+# 6. 初始化追踪
+bash init-tracking.sh
+
+# 7. 写作过程中定期追踪
+bash track-progress.sh
+
+# 8. 最终分析
+bash analyze-story.sh
+```
+
+## 🔗 相关文档
+
+- [Novel Writer Skills 主文档](../../README.md)
+- [命令详解](../../docs/guides/commands.md)
+- [入门指南](../../docs/guides/getting-started.md)
+
+## 💡 提示
+
+这些脚本是从 [novel-writer](https://github.com/wordflowlab/novel-writer) 项目移植而来，经过调整以适配 Novel Writer Skills 的项目结构。
+
+如果你在多个 AI 工具间切换，也可以考虑使用完整版的 [novel-writer](https://github.com/wordflowlab/novel-writer)。
+
+---
+
+**Happy Writing!** ✨📚
+

package/templates/scripts/bash/analyze-story.sh

@@ -0,0 +1,170 @@
+#!/bin/bash
+
+# 故事分析验证脚本
+# 用于 /analyze 命令
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Parse arguments
+STORY_NAME="$1"
+ANALYSIS_TYPE="${2:-full}"  # full, compliance, quality, progress
+
+# Get project root
+PROJECT_ROOT=$(get_project_root)
+cd "$PROJECT_ROOT"
+
+# 确定故事路径
+if [ -z "$STORY_NAME" ]; then
+    STORY_NAME=$(get_active_story)
+fi
+
+STORY_DIR="stories/$STORY_NAME"
+
+# 检查必要文件
+check_story_files() {
+    local missing_files=()
+
+    # 检查基准文档
+    [ ! -f ".specify/memory/constitution.md" ] && missing_files+=("宪法文件")
+    [ ! -f "$STORY_DIR/specification.md" ] && missing_files+=("规格文件")
+    [ ! -f "$STORY_DIR/creative-plan.md" ] && missing_files+=("计划文件")
+
+    if [ ${#missing_files[@]} -gt 0 ]; then
+        echo "⚠️ 缺少以下基准文档："
+        for file in "${missing_files[@]}"; do
+            echo "  - $file"
+        done
+        return 1
+    fi
+
+    return 0
+}
+
+# 统计内容
+analyze_content() {
+    local content_dir="$STORY_DIR/content"
+    local total_words=0
+    local chapter_count=0
+
+    if [ -d "$content_dir" ]; then
+        echo "内容统计："
+        echo ""
+        for file in "$content_dir"/*.md; do
+            if [ -f "$file" ]; then
+                ((chapter_count++))
+                # 使用准确的中文字数统计
+                local words=$(count_chinese_words "$file")
+                ((total_words += words))
+                local filename=$(basename "$file")
+                echo "  $filename: $words 字"
+            fi
+        done
+        echo ""
+        echo "  总字数：$total_words"
+        echo "  章节数：$chapter_count"
+        if [ $chapter_count -gt 0 ]; then
+            echo "  平均章节长度：$((total_words / chapter_count)) 字"
+        fi
+    else
+        echo "内容统计："
+        echo "  尚未开始写作"
+    fi
+}
+
+# 检查任务完成度
+check_task_completion() {
+    local tasks_file="$STORY_DIR/tasks.md"
+    if [ ! -f "$tasks_file" ]; then
+        echo "任务文件不存在"
+        return
+    fi
+
+    local total_tasks=$(grep -c "^- \[" "$tasks_file" 2>/dev/null || echo 0)
+    local completed_tasks=$(grep -c "^- \[x\]" "$tasks_file" 2>/dev/null || echo 0)
+    local in_progress=$(grep -c "^- \[~\]" "$tasks_file" 2>/dev/null || echo 0)
+    local pending=$((total_tasks - completed_tasks - in_progress))
+
+    echo "任务进度："
+    echo "  总任务：$total_tasks"
+    echo "  已完成：$completed_tasks"
+    echo "  进行中：$in_progress"
+    echo "  未开始：$pending"
+
+    if [ $total_tasks -gt 0 ]; then
+        local completion_rate=$((completed_tasks * 100 / total_tasks))
+        echo "  完成率：$completion_rate%"
+    fi
+}
+
+# 检查规格符合度
+check_specification_compliance() {
+    local spec_file="$STORY_DIR/specification.md"
+
+    echo "规格符合度检查："
+
+    # 检查P0需求（简化版）
+    local p0_count=$(grep -c "^### 必须包含（P0）" "$spec_file" 2>/dev/null || echo 0)
+    if [ $p0_count -gt 0 ]; then
+        echo "  P0需求：检测到，需人工验证"
+    fi
+
+    # 检查是否还有[需要澄清]标记
+    local unclear=$(grep -c "\[需要澄清\]" "$spec_file" 2>/dev/null || echo 0)
+    if [ $unclear -gt 0 ]; then
+        echo "  ⚠️ 仍有 $unclear 处需要澄清"
+    else
+        echo "  ✅ 所有决策已澄清"
+    fi
+}
+
+# 主分析流程
+main() {
+    echo "故事分析报告"
+    echo "============"
+    echo "故事：$STORY_NAME"
+    echo "分析时间：$(date '+%Y-%m-%d %H:%M:%S')"
+    echo ""
+
+    # 检查基准文档
+    if ! check_story_files; then
+        echo ""
+        echo "❌ 无法进行完整分析，请先完成基准文档"
+        exit 1
+    fi
+
+    echo "✅ 基准文档完整"
+    echo ""
+
+    # 根据分析类型执行
+    case "$ANALYSIS_TYPE" in
+        full)
+            analyze_content
+            echo ""
+            check_task_completion
+            echo ""
+            check_specification_compliance
+            ;;
+        quality)
+            analyze_content
+            ;;
+        progress)
+            check_task_completion
+            ;;
+        compliance)
+            check_specification_compliance
+            ;;
+        *)
+            echo "未知的分析类型：$ANALYSIS_TYPE"
+            exit 1
+            ;;
+    esac
+
+    echo ""
+    echo "分析完成。详细报告已保存到：$STORY_DIR/analysis-report.md"
+}
+
+main