novelws 3.1.0 → 5.0.0

package/templates/scripts/README.md

@@ -1,187 +0,0 @@
-# 脚本工具集
-
-本目录包含 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

@@ -1,170 +0,0 @@
-#!/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

package/templates/scripts/bash/check-analyze-stage.sh

@@ -1,108 +0,0 @@
-#!/usr/bin/env bash
-# 检测 analyze 命令应该执行的阶段
-# 返回 JSON 格式的阶段信息
-
-set -euo pipefail
-
-# 解析参数
-JSON_OUTPUT=false
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --json|-j)
-            JSON_OUTPUT=true
-            shift
-            ;;
-        *)
-            echo "未知参数: $1" >&2
-            exit 1
-            ;;
-    esac
-done
-
-# 加载公共函数
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "${SCRIPT_DIR}/common.sh"
-
-# 获取项目根目录和故事目录
-if ! PROJECT_ROOT=$(get_project_root); then
-    echo "错误: 无法获取项目根目录" >&2
-    exit 1
-fi
-
-if ! STORY_DIR=$(get_current_story_dir); then
-    echo "错误: 未找到故事目录" >&2
-    exit 1
-fi
-
-# 默认返回值
-ANALYZE_TYPE="content"
-CHAPTER_COUNT=0
-HAS_SPEC=false
-HAS_PLAN=false
-HAS_TASKS=false
-REASON=""
-
-# 检查规格文件
-SPEC_PATH="${STORY_DIR}/specification.md"
-if [[ -f "$SPEC_PATH" ]]; then
-    HAS_SPEC=true
-fi
-
-# 检查计划文件
-PLAN_PATH="${STORY_DIR}/creative-plan.md"
-if [[ -f "$PLAN_PATH" ]]; then
-    HAS_PLAN=true
-fi
-
-# 检查任务文件
-TASKS_PATH="${STORY_DIR}/tasks.md"
-if [[ -f "$TASKS_PATH" ]]; then
-    HAS_TASKS=true
-fi
-
-# 统计章节数量
-CONTENT_DIR="${STORY_DIR}/content"
-if [[ ! -d "$CONTENT_DIR" ]]; then
-    CONTENT_DIR="${STORY_DIR}/chapters"
-fi
-
-if [[ -d "$CONTENT_DIR" ]]; then
-    # 统计 .md 文件数量（排除索引文件）
-    CHAPTER_COUNT=$(find "$CONTENT_DIR" -maxdepth 1 -type f -name "*.md" \
-        ! -name "README.md" ! -name "index.md" 2>/dev/null | wc -l)
-fi
-
-# 决策逻辑
-if [[ $CHAPTER_COUNT -eq 0 ]]; then
-    # 无章节内容 → 框架分析
-    ANALYZE_TYPE="framework"
-    REASON="无章节内容，建议进行框架一致性分析"
-elif [[ $CHAPTER_COUNT -lt 3 ]]; then
-    # 章节数量不足 → 框架分析（但提示可以开始写作）
-    ANALYZE_TYPE="framework"
-    REASON="章节数量较少（${CHAPTER_COUNT} 章），建议继续写作或进行框架验证"
-else
-    # 章节充足 → 内容分析
-    ANALYZE_TYPE="content"
-    REASON="已完成 ${CHAPTER_COUNT} 章，可进行内容质量分析"
-fi
-
-# 输出 JSON 或人类可读格式
-if [[ "$JSON_OUTPUT" == true ]]; then
-    # JSON 格式输出
-    cat <<EOF
-{"analyze_type":"${ANALYZE_TYPE}","chapter_count":${CHAPTER_COUNT},"has_spec":${HAS_SPEC},"has_plan":${HAS_PLAN},"has_tasks":${HAS_TASKS},"story_dir":"${STORY_DIR}","reason":"${REASON}"}
-EOF
-else
-    # 人类可读输出
-    echo "分析阶段检测结果"
-    echo "=================="
-    echo "故事目录: ${STORY_DIR}"
-    echo "章节数量: ${CHAPTER_COUNT}"
-    echo "规格文件: $(if [[ "$HAS_SPEC" == true ]]; then echo '✅'; else echo '❌'; fi)"
-    echo "计划文件: $(if [[ "$HAS_PLAN" == true ]]; then echo '✅'; else echo '❌'; fi)"
-    echo "任务文件: $(if [[ "$HAS_TASKS" == true ]]; then echo '✅'; else echo '❌'; fi)"
-    echo ""
-    echo "推荐模式: ${ANALYZE_TYPE}"
-    echo "原因: ${REASON}"
-fi