novelws 3.1.0 → 5.0.0

package/templates/scripts/bash/check-writing-state.sh

@@ -1,854 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-# 检查写作状态脚本
-# 用于 /write 命令
-
-# ============================================
-# Phase 1: 文件时间戳缓存
-# ============================================
-#
-# 缓存值约定:
-# - mtime > 0: 文件存在，值为修改时间戳
-# - mtime = 0: stat 命令失败（权限问题、文件系统错误等）
-# - mtime = -1: 文件不存在（预加载时已确认）
-# - 未缓存: 键不存在于缓存中
-
-# Bash 版本检测
-BASH_MAJOR_VERSION="${BASH_VERSION%%.*}"
-
-# 缓存存储（关联数组或线性数组）
-if [[ "$BASH_MAJOR_VERSION" -ge 4 ]]; then
-    # Bash 4.0+: 使用关联数组
-    declare -A FILE_MTIME_CACHE
-else
-    # Bash 3.x: 使用线性数组模拟
-    FILE_MTIME_CACHE_KEYS=()
-    FILE_MTIME_CACHE_VALUES=()
-fi
-
-# ============================================
-# Phase 2: 资源去重机制
-# ============================================
-#
-# 用于避免在单次脚本执行中重复检查同一资源文件
-
-# Phase 2: 资源去重 - 检测 Bash 版本并选择实现
-if [ "${BASH_VERSINFO[0]}" -ge 4 ]; then
-    # Bash 4.0+: 使用关联数组（O(1) 查找）
-    USE_ASSOCIATIVE_ARRAY=true
-    declare -A loaded_resources_set
-else
-    # Bash 3.x: 降级到线性数组（O(n) 查找）
-    USE_ASSOCIATIVE_ARRAY=false
-    loaded_resources_array=()
-    echo "警告: Bash 版本低于 4.0，资源去重使用降级方案（性能稍差）" >&2
-fi
-
-# 检查资源是否已加载（Bash 4.0+）
-is_resource_loaded_assoc() {
-    local path=$1
-    [[ ${loaded_resources_set["$path"]+_} ]]
-}
-
-# 标记资源为已加载（Bash 4.0+）
-mark_resource_loaded_assoc() {
-    local path=$1
-    loaded_resources_set["$path"]=1
-}
-
-# 检查资源是否已加载（Bash 3.x 降级）
-is_resource_loaded_array() {
-    local path=$1
-    for loaded in "${loaded_resources_array[@]}"; do
-        if [ "$loaded" = "$path" ]; then
-            return 0
-        fi
-    done
-    return 1
-}
-
-# 标记资源为已加载（Bash 3.x 降级）
-mark_resource_loaded_array() {
-    local path=$1
-    loaded_resources_array+=("$path")
-}
-
-# 统一接口（自动选择实现）
-is_resource_loaded() {
-    if [ "$USE_ASSOCIATIVE_ARRAY" = true ]; then
-        is_resource_loaded_assoc "$@"
-    else
-        is_resource_loaded_array "$@"
-    fi
-}
-
-mark_resource_loaded() {
-    if [ "$USE_ASSOCIATIVE_ARRAY" = true ]; then
-        mark_resource_loaded_assoc "$@"
-    else
-        mark_resource_loaded_array "$@"
-    fi
-}
-
-# ============================================
-# Phase 3: 缓存文件清理机制
-# ============================================
-#
-# 清理超过 24 小时的旧缓存文件，避免磁盘空间浪费
-# 防御性设计：缓存目录不存在时直接返回
-
-cleanup_old_cache() {
-    local cache_dir="$PROJECT_ROOT/.specify/.cache"
-
-    # 缓存目录不存在，无需清理
-    if [ ! -d "$cache_dir" ]; then
-        return
-    fi
-
-    # 删除超过 24 小时未修改的缓存文件
-    find "$cache_dir" -name "*.json" -type f -mtime +1 -delete 2>/dev/null || true
-
-    # 删除空目录
-    find "$cache_dir" -type d -empty -delete 2>/dev/null || true
-}
-
-# 预加载文件修改时间到缓存
-# 参数: $@ = 文件路径列表
-# 说明: 由于 Bash 命令替换会创建子shell，我们使用预加载策略
-#       在脚本初始化时一次性加载所有文件的 mtime
-preload_file_mtimes() {
-    local file_path
-    local mtime
-
-    for file_path in "$@"; do
-        # 文件不存在：记录为 -1
-        if [ ! -f "$file_path" ]; then
-            if [[ "$BASH_MAJOR_VERSION" -ge 4 ]]; then
-                FILE_MTIME_CACHE[$file_path]="-1"
-            else
-                FILE_MTIME_CACHE_KEYS+=("$file_path")
-                FILE_MTIME_CACHE_VALUES+=("-1")
-            fi
-            continue
-        fi
-
-        # 读取文件时间戳 (macOS/Linux 兼容)
-        if [[ "$OSTYPE" == "darwin"* ]]; then
-            mtime=$(stat -f "%m" "$file_path" 2>/dev/null || echo "0")
-        else
-            mtime=$(stat -c "%Y" "$file_path" 2>/dev/null || echo "0")
-        fi
-
-        # 存入缓存
-        if [[ "$BASH_MAJOR_VERSION" -ge 4 ]]; then
-            FILE_MTIME_CACHE[$file_path]="$mtime"
-        else
-            FILE_MTIME_CACHE_KEYS+=("$file_path")
-            FILE_MTIME_CACHE_VALUES+=("$mtime")
-        fi
-    done
-}
-
-# 获取文件修改时间（从缓存）
-# 参数: $1 = 文件路径
-# 返回: 修改时间戳（秒），如果未缓存则返回 0
-get_file_mtime() {
-    local file_path="$1"
-
-    if [[ "$BASH_MAJOR_VERSION" -ge 4 ]]; then
-        # Bash 4.0+: 关联数组查找
-        echo "${FILE_MTIME_CACHE[$file_path]:-0}"
-    else
-        # Bash 3.x: 线性数组查找
-        for i in "${!FILE_MTIME_CACHE_KEYS[@]}"; do
-            if [[ "${FILE_MTIME_CACHE_KEYS[$i]}" == "$file_path" ]]; then
-                echo "${FILE_MTIME_CACHE_VALUES[$i]}"
-                return 0
-            fi
-        done
-        echo "0"
-    fi
-}
-
-# 检查文件是否已被缓存
-# 参数: $1 = 文件路径
-# 返回: 0 = 已缓存, 1 = 未缓存
-is_file_cached() {
-    local file_path="$1"
-
-    if [[ "$BASH_MAJOR_VERSION" -ge 4 ]]; then
-        [[ ${FILE_MTIME_CACHE[$file_path]+isset} ]]
-    else
-        for key in "${FILE_MTIME_CACHE_KEYS[@]}"; do
-            [[ "$key" == "$file_path" ]] && return 0
-        done
-        return 1
-    fi
-}
-
-# 检查文件是否存在（基于缓存）
-# 参数: $1 = 文件路径
-# 返回: 0 = 文件存在, 1 = 文件不存在或未缓存
-is_file_exists_cached() {
-    local file_path="$1"
-    local mtime=$(get_file_mtime "$file_path")
-
-    # mtime > 0: 文件存在
-    # mtime = 0: stat 失败或未缓存
-    # mtime = -1: 文件不存在
-    [[ "$mtime" != "0" && "$mtime" != "-1" ]]
-}
-
-# Source common functions
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/common.sh"
-
-# 预加载文件时间戳缓存（性能优化）
-# 注意：必须在 get_project_root 之前进行，或者在确定项目根目录后再预加载
-# 这里我们延迟到获取 PROJECT_ROOT 之后
-PRELOAD_FILES_PENDING=true
-
-# 检查是否为 checklist 模式
-CHECKLIST_MODE=false
-if [ "$1" = "--checklist" ]; then
-    CHECKLIST_MODE=true
-fi
-
-# 检查是否为 JSON 输出模式
-JSON_MODE=false
-if [ "$1" = "--json" ] || [ "$2" = "--json" ]; then
-    JSON_MODE=true
-fi
-
-# Get project root
-PROJECT_ROOT=$(get_project_root)
-cd "$PROJECT_ROOT"
-
-# 获取当前故事
-STORY_NAME=$(get_active_story)
-STORY_DIR="stories/$STORY_NAME"
-
-# 预加载文件时间戳（性能优化）
-if [ "$PRELOAD_FILES_PENDING" = true ]; then
-    # 构建待预加载的文件列表
-    PRELOAD_FILE_LIST=(
-        # 知识库文件
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/dialogue.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/scene-structure.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/character-arc.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/pacing.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/show-not-tell.md"
-        # Skill 文件
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/dialogue-techniques/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/scene-structure/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/character-arc/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/pacing-control/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/quality-assurance/consistency-checker/SKILL.md"
-        # 规格文件
-        "$STORY_DIR/specification.md"
-    )
-
-    # 执行预加载
-    preload_file_mtimes "${PRELOAD_FILE_LIST[@]}"
-    PRELOAD_FILES_PENDING=false
-fi
-
-# Phase 3: 清理旧缓存（轻量级，不影响性能）
-cleanup_old_cache
-
-# 检查方法论文档
-check_methodology_docs() {
-    local missing=()
-
-    [ ! -f ".specify/memory/constitution.md" ] && missing+=("宪法")
-    [ ! -f "$STORY_DIR/specification.md" ] && missing+=("规格")
-    [ ! -f "$STORY_DIR/creative-plan.md" ] && missing+=("计划")
-    [ ! -f "$STORY_DIR/tasks.md" ] && missing+=("任务")
-
-    if [ ${#missing[@]} -gt 0 ]; then
-        echo "⚠️ 缺少以下基准文档："
-        for doc in "${missing[@]}"; do
-            echo "  - $doc"
-        done
-        echo ""
-        echo "建议按照七步方法论完成前置步骤："
-        echo "1. /constitution - 创建创作宪法"
-        echo "2. /specify - 定义故事规格"
-        echo "3. /clarify - 澄清关键决策"
-        echo "4. /plan - 制定创作计划"
-        echo "5. /tasks - 生成任务清单"
-        return 1
-    fi
-
-    echo "✅ 方法论文档完整"
-    return 0
-}
-
-# 检查待写作任务
-check_pending_tasks() {
-    local tasks_file="$STORY_DIR/tasks.md"
-
-    if [ ! -f "$tasks_file" ]; then
-        echo "❌ 任务文件不存在"
-        return 1
-    fi
-
-    # 统计任务状态
-    local pending=$(grep -c "^- \[ \]" "$tasks_file" 2>/dev/null || echo 0)
-    local in_progress=$(grep -c "^- \[~\]" "$tasks_file" 2>/dev/null || echo 0)
-    local completed=$(grep -c "^- \[x\]" "$tasks_file" 2>/dev/null || echo 0)
-
-    echo ""
-    echo "任务状态："
-    echo "  待开始：$pending"
-    echo "  进行中：$in_progress"
-    echo "  已完成：$completed"
-
-    if [ $pending -eq 0 ] && [ $in_progress -eq 0 ]; then
-        echo ""
-        echo "🎉 所有任务已完成！"
-        echo "建议运行 /analyze 进行综合验证"
-        return 0
-    fi
-
-    # 显示下一个待写作任务
-    echo ""
-    echo "下一个写作任务："
-    grep "^- \[ \]" "$tasks_file" | head -n 1 || echo "（无待处理任务）"
-}
-
-# 检查已完成内容
-check_completed_content() {
-    local content_dir="$STORY_DIR/content"
-    local validation_rules="$STORY_DIR/spec/tracking/validation-rules.json"
-    local min_words=2000
-    local max_words=4000
-
-    # 读取验证规则（如果存在）
-    if [ -f "$validation_rules" ]; then
-        if command -v jq >/dev/null 2>&1; then
-            min_words=$(jq -r '.rules.chapterMinWords // 2000' "$validation_rules")
-            max_words=$(jq -r '.rules.chapterMaxWords // 4000' "$validation_rules")
-        fi
-    fi
-
-    if [ -d "$content_dir" ]; then
-        local chapter_count=$(ls "$content_dir"/*.md 2>/dev/null | wc -l)
-        if [ $chapter_count -gt 0 ]; then
-            echo ""
-            echo "已完成章节：$chapter_count"
-            echo "字数要求：${min_words}-${max_words} 字"
-            echo ""
-            echo "最近写作："
-            for file in $(ls -t "$content_dir"/*.md 2>/dev/null | head -n 3); do
-                local filename=$(basename "$file")
-                local words=$(count_chinese_words "$file")
-                local status="✅"
-
-                if [ "$words" -lt "$min_words" ]; then
-                    status="⚠️ 字数不足"
-                elif [ "$words" -gt "$max_words" ]; then
-                    status="⚠️ 字数超出"
-                fi
-
-                echo "  - $filename: $words 字 $status"
-            done
-        fi
-    else
-        echo ""
-        echo "尚未开始写作"
-    fi
-}
-
-# 生成 checklist 格式输出
-output_checklist() {
-    local has_constitution=false
-    local has_specification=false
-    local has_plan=false
-    local has_tasks=false
-    local pending=0
-    local in_progress=0
-    local completed=0
-    local chapter_count=0
-    local bad_chapters=0
-    local min_words=2000
-    local max_words=4000
-
-    # 检查文档
-    [ -f ".specify/memory/constitution.md" ] && has_constitution=true
-    [ -f "$STORY_DIR/specification.md" ] && has_specification=true
-    [ -f "$STORY_DIR/creative-plan.md" ] && has_plan=true
-    [ -f "$STORY_DIR/tasks.md" ] && has_tasks=true
-
-    # 统计任务
-    if [ "$has_tasks" = true ]; then
-        pending=$(grep -c "^- \[ \]" "$STORY_DIR/tasks.md" 2>/dev/null || echo 0)
-        in_progress=$(grep -c "^- \[~\]" "$STORY_DIR/tasks.md" 2>/dev/null || echo 0)
-        completed=$(grep -c "^- \[x\]" "$STORY_DIR/tasks.md" 2>/dev/null || echo 0)
-    fi
-
-    # 读取验证规则
-    local validation_rules="$STORY_DIR/spec/tracking/validation-rules.json"
-    if [ -f "$validation_rules" ] && command -v jq >/dev/null 2>&1; then
-        min_words=$(jq -r '.rules.chapterMinWords // 2000' "$validation_rules")
-        max_words=$(jq -r '.rules.chapterMaxWords // 4000' "$validation_rules")
-    fi
-
-    # 检查章节内容
-    local content_dir="$STORY_DIR/content"
-    if [ -d "$content_dir" ]; then
-        chapter_count=$(ls "$content_dir"/*.md 2>/dev/null | wc -l | tr -d ' ')
-
-        # 统计不符合字数要求的章节
-        for file in "$content_dir"/*.md; do
-            [ -f "$file" ] || continue
-            local words=$(count_chinese_words "$file")
-            if [ "$words" -lt "$min_words" ] || [ "$words" -gt "$max_words" ]; then
-                bad_chapters=$((bad_chapters + 1))
-            fi
-        done
-    fi
-
-    # 计算总任务和完成率
-    local total_tasks=$((pending + in_progress + completed))
-    local completion_rate=0
-    if [ $total_tasks -gt 0 ]; then
-        completion_rate=$((completed * 100 / total_tasks))
-    fi
-
-    # 输出 checklist
-    cat <<EOF
-# 写作状态检查 Checklist
-
-**检查时间**: $(date '+%Y-%m-%d %H:%M:%S')
-**当前故事**: $STORY_NAME
-**字数标准**: ${min_words}-${max_words} 字
-
----
-
-## 文档完整性
-
-- [$([ "$has_constitution" = true ] && echo "x" || echo " ")] CHK001 constitution.md 存在
-- [$([ "$has_specification" = true ] && echo "x" || echo " ")] CHK002 specification.md 存在
-- [$([ "$has_plan" = true ] && echo "x" || echo " ")] CHK003 creative-plan.md 存在
-- [$([ "$has_tasks" = true ] && echo "x" || echo " ")] CHK004 tasks.md 存在
-
-## 任务进度
-
-EOF
-
-    if [ "$has_tasks" = true ]; then
-        echo "- [$([ $in_progress -gt 0 ] && echo "x" || echo " ")] CHK005 有进行中的任务（$in_progress 个）"
-        echo "- [x] CHK006 待开始任务数量（$pending 个）"
-        echo "- [$([ $completed -gt 0 ] && echo "x" || echo " ")] CHK007 已完成任务进度（$completed/$total_tasks = $completion_rate%）"
-    else
-        echo "- [ ] CHK005 有进行中的任务（tasks.md 不存在）"
-        echo "- [ ] CHK006 待开始任务数量（tasks.md 不存在）"
-        echo "- [ ] CHK007 已完成任务进度（tasks.md 不存在）"
-    fi
-
-    cat <<EOF
-
-## 内容质量
-
-- [$([ $chapter_count -gt 0 ] && echo "x" || echo " ")] CHK008 已完成章节数（$chapter_count 章）
-EOF
-
-    if [ $chapter_count -gt 0 ]; then
-        echo "- [$([ $bad_chapters -eq 0 ] && echo "x" || echo "!")] CHK009 字数符合标准（$([ $bad_chapters -eq 0 ] && echo "全部符合" || echo "$bad_chapters 章不符合")）"
-    else
-        echo "- [ ] CHK009 字数符合标准（尚未开始写作）"
-    fi
-
-    cat <<EOF
-
----
-
-## 后续行动
-
-EOF
-
-    local has_actions=false
-
-    # 检查缺失文档
-    if [ "$has_constitution" = false ] || [ "$has_specification" = false ] || [ "$has_plan" = false ] || [ "$has_tasks" = false ]; then
-        echo "- [ ] 完成方法论文档（运行对应命令：/constitution, /specify, /plan, /tasks）"
-        has_actions=true
-    fi
-
-    # 检查任务
-    if [ $pending -gt 0 ] || [ $in_progress -gt 0 ]; then
-        if [ $in_progress -gt 0 ]; then
-            echo "- [ ] 继续进行中的任务（$in_progress 个）"
-        else
-            echo "- [ ] 开始下一个待写作任务（共 $pending 个）"
-        fi
-        has_actions=true
-    fi
-
-    # 检查章节质量
-    if [ $bad_chapters -gt 0 ]; then
-        echo "- [ ] 修复字数不符合要求的章节（$bad_chapters 章）"
-        has_actions=true
-    fi
-
-    # 完成建议
-    if [ $pending -eq 0 ] && [ $in_progress -eq 0 ] && [ $completed -gt 0 ]; then
-        echo "- [ ] 运行 /analyze 进行综合验证"
-        has_actions=true
-    fi
-
-    if [ "$has_actions" = false ]; then
-        echo "*写作状态良好，无需特别行动*"
-    fi
-
-    cat <<EOF
-
----
-
-**检查工具**: check-writing-state.sh
-**版本**: 1.1 (支持 checklist 输出)
-EOF
-}
-
-# ==================== 新增：资源加载检查函数 ====================
-
-# JSON 字符串转义辅助函数
-json_escape() {
-    local str="$1"
-    # 按顺序转义：反斜杠 -> 引号 -> 控制字符
-    str="${str//\\/\\\\}"    # \ -> \\
-    str="${str//\"/\\\"}"    # " -> \"
-    str="${str//$'\t'/\\t}"  # tab -> \t
-    str="${str//$'\n'/\\n}"  # newline -> \n
-    str="${str//$'\r'/\\r}"  # carriage return -> \r
-    echo "$str"
-}
-
-# 解析 specification.md 的 resource-loading 配置
-parse_resource_loading_config() {
-    local spec_file="$STORY_DIR/specification.md"
-
-    if [ ! -f "$spec_file" ]; then
-        echo "{}" # 返回空 JSON
-        return
-    fi
-
-    # 提取 YAML frontmatter 中的 resource-loading 配置
-    # 这里简化处理，实际应该用 yq 或 python 解析 YAML
-    # 当前版本：检测是否存在 resource-loading 配置
-
-    if grep -q "resource-loading:" "$spec_file"; then
-        echo '{"configured": true}'
-    else
-        echo '{"configured": false}'
-    fi
-}
-
-# 检查 knowledge-base 文件是否存在
-check_knowledge_base_available() {
-    local missing=()
-    local available=()
-
-    # 检查所有 craft knowledge-base
-    local craft_files=(
-        ".specify/templates/knowledge-base/craft/dialogue.md"
-        ".specify/templates/knowledge-base/craft/scene-structure.md"
-        ".specify/templates/knowledge-base/craft/character-arc.md"
-        ".specify/templates/knowledge-base/craft/pacing.md"
-        ".specify/templates/knowledge-base/craft/show-not-tell.md"
-    )
-
-    for file in "${craft_files[@]}"; do
-        local full_path="$PROJECT_ROOT/$file"
-        # 使用缓存检查文件是否存在
-        if is_file_exists_cached "$full_path"; then
-            available+=("$file")
-        else
-            missing+=("$file")
-        fi
-    done
-
-    # 输出结果（JSON 格式将在后续步骤实现）
-    if [ ${#missing[@]} -gt 0 ]; then
-        echo "⚠️ 缺少以下 knowledge-base 文件："
-        for file in "${missing[@]}"; do
-            echo "  - $file"
-        done
-        return 1
-    fi
-
-    echo "✅ Knowledge-base 文件完整 (${#available[@]} 个)"
-    return 0
-}
-
-# 检查 skills 是否存在
-check_skills_available() {
-    local missing=()
-    local available=()
-
-    # 检查 writing-techniques skills
-    local skill_dirs=(
-        ".specify/templates/skills/writing-techniques/dialogue-techniques"
-        ".specify/templates/skills/writing-techniques/scene-structure"
-        ".specify/templates/skills/writing-techniques/character-arc"
-        ".specify/templates/skills/writing-techniques/pacing-control"
-    )
-
-    for dir in "${skill_dirs[@]}"; do
-        local skill_file="$PROJECT_ROOT/$dir/SKILL.md"
-        # 使用缓存检查文件是否存在
-        if is_file_exists_cached "$skill_file"; then
-            available+=("$dir")
-        else
-            missing+=("$dir")
-        fi
-    done
-
-    if [ ${#missing[@]} -gt 0 ]; then
-        echo "⚠️ 缺少以下 skills："
-        for dir in "${missing[@]}"; do
-            echo "  - $dir/SKILL.md"
-        done
-        return 1
-    fi
-
-    echo "✅ Skills 完整 (${#available[@]} 个)"
-    return 0
-}
-
-# 生成资源加载报告（JSON 格式）
-generate_load_report() {
-    # Phase 3: 性能监控
-    local start_time
-    if [[ "$OSTYPE" == "darwin"* ]]; then
-        start_time=$(python3 -c 'import time; print(int(time.time() * 1000))' 2>/dev/null || date +%s)
-    else
-        start_time=$(date +%s%3N 2>/dev/null || date +%s)
-    fi
-
-    local spec_file="$STORY_DIR/specification.md"
-
-    local knowledge_base_files=(
-        "craft/dialogue.md"
-        "craft/scene-structure.md"
-        "craft/character-arc.md"
-        "craft/pacing.md"
-        "craft/show-not-tell.md"
-    )
-
-    local skills_files=(
-        "writing-techniques/dialogue-techniques"
-        "writing-techniques/scene-structure"
-        "writing-techniques/character-arc"
-        "writing-techniques/pacing-control"
-        "quality-assurance/consistency-checker"
-    )
-
-    local disabled_resources=()
-
-    # 检查配置文件
-    local has_config=false
-    if [ -f "$spec_file" ] && grep -q "resource-loading:" "$spec_file"; then
-        has_config=true
-
-        # 检查是否禁用了 auto-load
-        if grep -A 1 "resource-loading:" "$spec_file" | grep -q "auto-load: false"; then
-            # 如果禁用自动加载，清空默认列表
-            knowledge_base_files=()
-            skills_files=()
-        fi
-
-        # TODO: 解析配置文件中的具体资源列表
-        # 当前简化版本，完整解析需要 yq 或 python
-    fi
-
-    # 检查文件是否存在，生成警告（使用缓存 + Phase 2 去重）
-    local warnings=()
-    for kb in "${knowledge_base_files[@]}"; do
-        local kb_path=".specify/templates/knowledge-base/$kb"
-
-        # Phase 2: 资源去重检查
-        if is_resource_loaded "$kb_path"; then
-            # 资源已检查过，跳过
-            continue
-        fi
-
-        # 标记为已加载
-        mark_resource_loaded "$kb_path"
-
-        # 检查文件是否存在（使用完整路径）
-        if ! is_file_exists_cached "$PROJECT_ROOT/$kb_path"; then
-            warnings+=("知识库文件不存在: $kb")
-        fi
-    done
-
-    for skill in "${skills_files[@]}"; do
-        local skill_path=".specify/templates/skills/$skill/SKILL.md"
-
-        # Phase 2: 资源去重检查
-        if is_resource_loaded "$skill_path"; then
-            # 资源已检查过，跳过
-            continue
-        fi
-
-        # 标记为已加载
-        mark_resource_loaded "$skill_path"
-
-        # 检查文件是否存在（使用完整路径）
-        if ! is_file_exists_cached "$PROJECT_ROOT/$skill_path"; then
-            warnings+=("Skill 文件不存在: $skill/SKILL.md")
-        fi
-    done
-
-    # Phase 2: 检测缓存命中（基于 specification.md 是否已被缓存加载且有效）
-    # 仅当文件在缓存中且成功读取时，才视为"缓存命中"
-    # 缓存语义: -1 = 文件不存在, 0 = stat 失败或未缓存, >0 = 成功读取
-    local cached=false
-    local cache_hint=""
-
-    # 获取缓存的 mtime
-    local spec_mtime=$(get_file_mtime "$spec_file")
-
-    # 仅当 mtime > 0 时才视为缓存命中
-    if [[ "$spec_mtime" != "0" && "$spec_mtime" != "-1" ]]; then
-        cached=true
-        cache_hint="此报告基于缓存生成（specification.md 未修改）。AI 可复用本次会话中已加载的资源。"
-    fi
-
-    # 生成 JSON 报告（使用 echo 逐行输出，处理空数组）
-    echo "{"
-    echo "  \"status\": \"ready\","
-
-    # 生成时间戳，带错误处理和回退
-    local timestamp
-    if timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null); then
-        echo "  \"timestamp\": \"$timestamp\","
-    elif timestamp=$(date +"%Y-%m-%dT%H:%M:%S%z" 2>/dev/null); then
-        echo "  \"timestamp\": \"$timestamp\","
-    else
-        echo "  \"timestamp\": \"unknown\","
-    fi
-
-    echo "  \"has_config\": $has_config,"
-
-    # Phase 2: 添加缓存标记字段
-    echo "  \"cached\": $cached,"
-    echo "  \"session_cache_enabled\": true,"
-    if [ "$cached" = true ]; then
-        echo "  \"cache_hint\": \"$(json_escape "$cache_hint")\","
-    fi
-
-    echo "  \"resources\": {"
-    echo "    \"knowledge-base\": ["
-
-    # 输出 knowledge-base 列表
-    local first=true
-    for kb in "${knowledge_base_files[@]}"; do
-        if [ "$first" = true ]; then
-            echo -n "      \"$(json_escape "$kb")\""
-            first=false
-        else
-            echo ","
-            echo -n "      \"$(json_escape "$kb")\""
-        fi
-    done
-    echo ""
-    echo "    ],"
-
-    echo "    \"skills\": ["
-    # 输出 skills 列表
-    first=true
-    for skill in "${skills_files[@]}"; do
-        if [ "$first" = true ]; then
-            echo -n "      \"$(json_escape "$skill")\""
-            first=false
-        else
-            echo ","
-            echo -n "      \"$(json_escape "$skill")\""
-        fi
-    done
-    echo ""
-    echo "    ],"
-
-    echo "    \"disabled\": ["
-    # 输出 disabled 列表
-    first=true
-    for res in "${disabled_resources[@]}"; do
-        if [ "$first" = true ]; then
-            echo -n "      \"$(json_escape "$res")\""
-            first=false
-        else
-            echo ","
-            echo -n "      \"$(json_escape "$res")\""
-        fi
-    done
-    echo ""
-    echo "    ]"
-
-    echo "  },"
-
-    # Phase 3: 性能指标
-    local end_time
-    if [[ "$OSTYPE" == "darwin"* ]]; then
-        end_time=$(python3 -c 'import time; print(int(time.time() * 1000))' 2>/dev/null || date +%s)
-    else
-        end_time=$(date +%s%3N 2>/dev/null || date +%s)
-    fi
-    local generation_time=$((end_time - start_time))
-
-    echo "  \"performance\": {"
-    echo "    \"generation_time_ms\": $generation_time,"
-    echo "    \"cache_hit\": $cached"
-    echo "  },"
-
-    echo "  \"warnings\": ["
-    # 输出 warnings 列表
-    first=true
-    for warn in "${warnings[@]}"; do
-        if [ "$first" = true ]; then
-            echo -n "      \"$(json_escape "$warn")\""
-            first=false
-        else
-            echo ","
-            echo -n "      \"$(json_escape "$warn")\""
-        fi
-    done
-    echo ""
-    echo "    ]"
-    echo "}"
-}
-
-# 主流程
-main() {
-    # JSON 模式优先处理
-    if [ "$JSON_MODE" = true ]; then
-        generate_load_report
-        exit 0
-    fi
-
-    # Checklist 模式直接输出并退出
-    if [ "$CHECKLIST_MODE" = true ]; then
-        output_checklist
-        exit 0
-    fi
-
-    # 原有的详细输出模式
-    echo "写作状态检查"
-    echo "============"
-    echo "当前故事：$STORY_NAME"
-    echo ""
-
-    if ! check_methodology_docs; then
-        exit 1
-    fi
-
-    check_pending_tasks
-    check_completed_content
-
-    echo ""
-    echo "准备就绪，可以开始写作"
-}
-
-main