novel-maker 2.2.0

package/skill/scripts/common/install.py

@@ -0,0 +1,169 @@
+#!/usr/bin/env python3
+"""
+NovelMaker 安装脚本（Python 版）
+
+当 npx 不可用时的备选安装方案。
+
+使用方式：
+    python scripts/common/install.py [--ide trae|claude|cursor|...] [--uninstall]
+"""
+
+import sys
+import argparse
+from pathlib import Path
+
+
+# 支持的 IDE 列表
+TARGETS = [
+    {"name": "Claude Code",   "dir": ".claude/skills/novel-maker",  "detect": [".claude"]},
+    {"name": "Cursor",        "dir": ".cursor/rules/novel-maker",   "detect": [".cursor", ".cursorrules"]},
+    {"name": "Trae",          "dir": ".trae/skills/novel-maker",    "detect": [".trae"]},
+    {"name": "Windsurf",      "dir": ".windsurf/skills/novel-maker", "detect": [".windsurf"]},
+    {"name": "Gemini CLI",    "dir": ".gemini/skills/novel-maker",  "detect": ["GEMINI.md"]},
+    {"name": "Codex CLI",     "dir": ".codex/skills/novel-maker",   "detect": [".codex"]},
+    {"name": "OpenCode",      "dir": ".opencode/skills/novel-maker", "detect": [".opencode"]},
+    {"name": "Aider",         "dir": ".aider/skills/novel-maker",   "detect": [".aider"]},
+    {"name": "Hermes Agent",  "dir": ".hermes/skills/novel-maker",  "detect": [".hermes", "HERMES.md"]},
+    {"name": "Qwen Code",     "dir": ".qwen/skills/novel-maker",    "detect": [".qwen"]},
+    {"name": "Claw Code",     "dir": ".claw/skills/novel-maker",    "detect": [".claw", "CLAW.md"]},
+    {"name": "Qoder",         "dir": ".qoder/skills/novel-maker",   "detect": [".qoder"]},
+    {"name": "Antigravity",   "dir": ".agents/skills/novel-maker",  "detect": [".agents"]},
+    {"name": "OpenClaw",      "dir": "skills/novel-maker",          "detect": [".openclaw"]},
+    {"name": "Kiro",          "dir": ".kiro/steering/novel-maker",  "detect": [".kiro"]},
+    {"name": "VS Code",       "dir": ".github/superpowers/novel-maker", "detect": [".github/copilot-instructions.md"]},
+    {"name": "DeerFlow",      "dir": "skills/custom/novel-maker",   "detect": ["deer_flow"]},
+    {"name": "Copilot CLI",   "dir": ".claude/skills/novel-maker",  "detect": [".claude"]},
+]
+
+# 工具别名
+TOOL_ALIASES = {
+    "claude": "Claude Code",
+    "cursor": "Cursor",
+    "trae": "Trae",
+    "windsurf": "Windsurf",
+    "gemini": "Gemini CLI",
+    "codex": "Codex CLI",
+    "opencode": "OpenCode",
+    "aider": "Aider",
+    "hermes": "Hermes Agent",
+    "qwen": "Qwen Code",
+    "claw": "Claw Code",
+    "qoder": "Qoder",
+    "antigravity": "Antigravity",
+    "openclaw": "OpenClaw",
+    "kiro": "Kiro",
+}
+
+
+def detect_ides():
+    """检测当前项目中的 IDE"""
+    detected = []
+    cwd = Path.cwd()
+    
+    for target in TARGETS:
+        for detect in target["detect"]:
+            if (cwd / detect).exists():
+                detected.append(target)
+                break
+    
+    return detected
+
+
+def copy_dir(src, dest):
+    """递归复制目录"""
+    import shutil
+    src = Path(src)
+    dest = Path(dest)
+    dest.mkdir(parents=True, exist_ok=True)
+    
+    for item in src.iterdir():
+        if item.name == '.DS_Store':
+            continue
+        dest_item = dest / item.name
+        if item.is_dir():
+            copy_dir(item, dest_item)
+        else:
+            shutil.copy2(item, dest_item)
+
+
+def install_skill(target):
+    """安装技能到指定 IDE"""
+    cwd = Path.cwd()
+    skill_dir = cwd / "skill"
+    
+    if not skill_dir.exists():
+        print(f"❌ 错误：未找到 skill/ 目录")
+        return False
+    
+    dest_dir = cwd / target["dir"]
+    print(f"  安装到 {target['name']}: {target['dir']}")
+    
+    try:
+        copy_dir(skill_dir, dest_dir)
+        print(f"  ✅ {target['name']} 安装成功")
+        return True
+    except Exception as e:
+        print(f"  ❌ {target['name']} 安装失败: {e}")
+        return False
+
+
+def uninstall_skill():
+    """卸载技能"""
+    import shutil
+    cwd = Path.cwd()
+    
+    print("🗑️  卸载 NovelMaker...\n")
+    
+    for target in TARGETS:
+        dest_dir = cwd / target["dir"]
+        if dest_dir.exists():
+            shutil.rmtree(dest_dir)
+            print(f"  ✅ {target['name']} 已卸载")
+    
+    print("\n✅ 卸载完成")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="NovelMaker 安装脚本")
+    parser.add_argument("--ide", help="指定 IDE 的类型")
+    parser.add_argument("--uninstall", action="store_true", help="卸载技能")
+    args = parser.parse_args()
+    
+    print("\n  NovelMaker v2.0.0 - 全能网文写作助手")
+    print("  6角色协作架构，用说话的方式写小说\n")
+    
+    if args.uninstall:
+        uninstall_skill()
+        return
+    
+    if args.ide:
+        tool_name = TOOL_ALIASES.get(args.ide.lower())
+        if not tool_name:
+            print(f"❌ 未知的工具: {args.ide}")
+            print(f"支持的: {', '.join(TOOL_ALIASES.keys())}")
+            sys.exit(1)
+        targets = [t for t in TARGETS if t["name"] == tool_name]
+    else:
+        targets = detect_ides()
+    
+    if not targets:
+        print("❌ 未检测到 IDE，请使用 --ide 参数指定")
+        print(f"支持的: {', '.join(TOOL_ALIASES.keys())}")
+        sys.exit(1)
+    
+    print(f"检测到 {len(targets)} 个 IDE:\n")
+    for t in targets:
+        print(f"  - {t['name']}")
+    print()
+    
+    for target in targets:
+        install_skill(target)
+    
+    print("\n✅ 安装完成！")
+    print("\n在 IDE 聊天框输入以下指令开始创作：")
+    print("  /novel-maker init 开始写小说")
+    print("  /novel-maker help 查看帮助\n")
+
+
+if __name__ == "__main__":
+    main()

package/skill/scripts/common/nm_utils.py

@@ -0,0 +1,296 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+NovelMaker 脚本公共工具模块
+提供所有脚本共用的函数，消除重复代码。
+"""
+
+import os
+import re
+import sys
+import json
+from collections import Counter
+
+# ─── 字符编码兼容 ───────────────────────────────
+if sys.platform == 'win32':
+    import io
+    if hasattr(sys.stdout, 'buffer'):
+        sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8', errors='replace')
+    if hasattr(sys.stderr, 'buffer'):
+        sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8', errors='replace')
+
+# ─── Markdown 清理 ───────────────────────────────
+_MARKDOWN_PATTERNS = [
+    (r'#{1,6}\s*', ''),
+    (r'\*\*(.*?)\*\*', r'\1'),
+    (r'\*(.*?)\*', r'\1'),
+    (r'~~(.*?)~~', r'\1'),
+    (r'`(.*?)`', r'\1'),
+    (r'\[(.*?)\]\(.*?\)', r'\1'),
+    (r'>\s?', ''),
+    (r'-{3,}', ''),
+    (r'\*{3,}', ''),
+]
+
+
+def clean_markdown(text):
+    """Remove markdown formatting from text."""
+    for pattern, repl in _MARKDOWN_PATTERNS:
+        text = re.sub(pattern, repl, text)
+    return text
+
+
+def count_chinese(text):
+    """Count Chinese characters in text."""
+    return len(re.findall(r'[\u4e00-\u9fff]', text))
+
+
+def extract_title(content):
+    """Extract chapter title from markdown heading."""
+    m = re.search(r'^#\s*(.+)$', content, re.MULTILINE)
+    return m.group(1).strip() if m else None
+
+
+def read_chapter(filepath):
+    """Read a chapter file and return (raw_text, title, clean_text, word_count)."""
+    with open(filepath, 'r', encoding='utf-8') as f:
+        raw = f.read()
+    title = extract_title(raw)
+    clean = clean_markdown(raw)
+    wc = count_chinese(clean)
+    return raw, title, clean, wc
+
+
+def extract_content_from_chapter(file_path):
+    """Extract body content after the chapter heading line."""
+    with open(file_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    lines = content.split('\n')
+    content_start = 0
+    for i, line in enumerate(lines):
+        if line.startswith('#') and '章' in line:
+            content_start = i + 1
+            break
+    return '\n'.join(lines[content_start:])
+
+
+# ─── 角色提取 ───────────────────────────────
+_STOP_PREFIXES = ('他', '她', '我', '你', '它', '这', '那', '一', '几', '每', '各', '有', '是', '不', '又', '也', '就', '便', '被', '把', '向', '对', '从', '跟', '将', '让', '却', '只')
+_STOP_SUFFIXES = ('道', '说', '问', '笑', '喊', '怒', '叫', '哭', '叹', '喃', '咕', '叨', '呼', '喝')
+_STOP_WORDS = {
+    '说道', '问道', '喊道', '笑道', '怒道', '冷冷道', '淡淡道', '低声道', '大声道',
+    '心中', '忽然', '这个时候', '就在这', '只听得', '眼看', '原来',
+    '可以', '没有', '已经', '这个', '那个', '什么', '怎么', '为什么',
+    '如果', '因为', '所以', '但是', '而且', '然后', '虽然', '不过',
+    '只是', '还是', '或者', '一定', '可能', '应该', '必须', '能够',
+    '他们', '自己', '我们', '你们', '这些', '那些', '所有', '每个',
+    '现在', '刚才', '以前', '以后', '之前', '之后', '一直', '终于',
+    '看着', '听到', '发现', '感觉', '觉得', '知道', '想到', '看到',
+    '继续', '开始', '已经', '准备', '打算', '决定', '选择', '同意',
+    '掌门', '宗主', '长老', '堂主', '舵主',
+    '摆了摆手', '点了点头', '摇了摇头', '挥了挥手', '拱了拱手',
+    '老者淡淡', '少年笑', '中年笑', '大汉道', '老妪道', '少妇道',
+}
+_GENERIC_TITLES = ('老者', '少年', '中年', '大汉', '老妪', '少妇', '壮汉', '妇人', '男子', '女子')
+
+
+def extract_characters(text):
+    """Extract character names from dialogue patterns, filtering noise."""
+    candidates = set()
+    for m in re.finditer(r'([\u4e00-\u9fff]{2,4})(?:说道|问道|喊道|笑道|怒道|冷冷道|淡淡道|低声道|大声道|心想|暗道|思忖|暗想|心说)', text):
+        candidates.add(m.group(1))
+    for m in re.finditer(r'([\u4e00-\u9fff]{2,4})[：:]["\u201c]', text):
+        candidates.add(m.group(1))
+    for m in re.finditer(r'["\u201d]([\u4e00-\u9fff]{2,4})[说问道喊笑怒冷淡淡低大]', text):
+        candidates.add(m.group(1))
+
+    filtered = []
+    for c in sorted(candidates):
+        if c in _STOP_WORDS:
+            continue
+        if c.startswith(_STOP_PREFIXES):
+            continue
+        if c.endswith(_STOP_SUFFIXES) and len(c) <= 3:
+            continue
+        if len(c) >= 4 and re.search(r'[了的得地着过]', c[1:-1]):
+            continue
+        if any(c.startswith(t) for t in _GENERIC_TITLES):
+            continue
+        filtered.append(c)
+    return filtered
+
+
+def extract_locations(text):
+    """Extract location names from movement/position patterns."""
+    locs = set()
+    for m in re.finditer(r'(?:在|到|去|进入|来到|回到)([\u4e00-\u9fff]{2,6})(?:中|里|内|外|前|后|上|下|边|旁)?(?:[，。！？\s]|$)', text):
+        locs.add(m.group(1))
+    return sorted(locs)[:10]
+
+
+# ─── 钩子检测 ───────────────────────────────
+_HOOK_CUES = {
+    '揭示': ['原来', '竟然是', '才发现', '终于明白', '真相', '秘密', '身份'],
+    '危机': ['突然', '忽然', '就在这时', '猛地', '危险', '不好', '糟糕', '惊变', '杀意'],
+    '选择': ['怎么办', '选哪', '两难', '不得', '必须', '只能', '要么', '是否'],
+    '期待': ['下次', '明天', '等着', '一定', '会回来', '再来', '不会放'],
+    '反转': ['没想到', '不料', '却', '反而', '居然', '竟'],
+    '悬念': ['到底', '究竟', '为什么', '怎么', '是否', '会不会', '难道'],
+}
+
+_HOOK_PATTERN_MAP = {
+    "揭示": re.compile(r'(原来|竟然|居然|没想到|真相|秘密|隐藏|真相大白|揭露)'),
+    "危机": re.compile(r'(危险|危机|追杀|暗杀|陷阱|包围|生死|命悬一线|千钧一发)'),
+    "选择": re.compile(r'(选择|决定|犹豫|两难|何去何从|必须做出)'),
+    "期待": re.compile(r'(明天|明天就|明天开始|等着|等着我|三天后|约定|届时)'),
+    "反转": re.compile(r'(但是|然而|却|没想到|谁知|岂料|不料|偏偏|可是)'),
+    "悬念": re.compile(r'(他不知道|她没看到|没有人知道|神秘|未知|谜团|未解|尚未)'),
+}
+
+
+def detect_hook(text, last_n=400):
+    """Detect chapter ending hook type from text tail."""
+    tail = ''.join(re.findall(r'[\u4e00-\u9fff，。！？、：""\u201c\u201d\u2026\uff01\uff1f]', text[-last_n:]))
+    found = {}
+    for ctype, keywords in _HOOK_CUES.items():
+        score = sum(1 for kw in keywords if kw in tail)
+        if score:
+            found[ctype] = score
+    best = max(found, key=found.get) if found else '未检测'
+    return {'type': best, 'cues': found, 'tail_preview': tail[-80:] if tail else ''}
+
+
+def detect_hook_type_from_patterns(text):
+    """Detect hook type using compiled regex patterns (for batch scanning)."""
+    scores = {}
+    for hook_type, pattern in _HOOK_PATTERN_MAP.items():
+        scores[hook_type] = len(pattern.findall(text))
+    if not scores or max(scores.values()) == 0:
+        return "未知"
+    return max(scores, key=scores.get)
+
+
+# ─── 章节排序 ───────────────────────────────
+_CHAPTER_PATTERN = re.compile(r'第([零一二三四五六七八九十百\d]+)章.*\.md$')
+_CN_MAP = {'零': 0, '一': 1, '二': 2, '三': 3, '四': 4,
+           '五': 5, '六': 6, '七': 7, '八': 8, '九': 9, '十': 10}
+
+
+def chapter_sort_key(filepath):
+    """Sort key for chapter filenames (handles Chinese numerals)."""
+    m = _CHAPTER_PATTERN.search(os.path.basename(filepath))
+    if m:
+        num_str = m.group(1)
+        if num_str.isdigit():
+            return int(num_str)
+        val = 0
+        for ch in num_str:
+            val = val * 10 + _CN_MAP.get(ch, 0)
+        return val
+    return 9999
+
+
+def list_chapters(chapters_dir, recent_n=None):
+    """List chapter files in a directory, sorted by chapter number."""
+    if not os.path.isdir(chapters_dir):
+        return []
+    files = [os.path.join(chapters_dir, f) for f in os.listdir(chapters_dir)
+             if _CHAPTER_PATTERN.search(f)]
+    files.sort(key=chapter_sort_key)
+    if recent_n:
+        files = files[-recent_n:]
+    return files
+
+
+# ─── 摘要生成 ───────────────────────────────
+def generate_summary(text, first_n=150, last_n=200):
+    """Generate head/tail summary from chapter text."""
+    clean = clean_markdown(text)
+    chinese_only = ''.join(re.findall(r'[\u4e00-\u9fff，。！？、：""\u201c\u201d]', clean))
+    head = chinese_only[:first_n]
+    tail = chinese_only[-last_n:] if len(chinese_only) > last_n else chinese_only[first_n:]
+    return {'开头': head, '结尾': tail}
+
+
+# ─── 结构检测 ───────────────────────────────
+def detect_structure(text):
+    """Detect chapter structure: dialogue/action/description ratios."""
+    lines = [l.strip() for l in text.split('\n') if l.strip()]
+    dialogue_lines = sum(1 for l in lines if re.search(r'["\u201c\u201d]|[\u300c\u300d]|[：:][\u201c]', l))
+    action_keywords = ['打', '砍', '刺', '踢', '冲', '跑', '跳', '飞', '击', '轰', '斩', '劈', '砸', '撞']
+    description_keywords = ['阳光', '月光', '山', '水', '云', '风', '雨', '雪', '花', '树', '雾', '光', '影',
+                            '宫殿', '阁楼', '庭院', '房间', '大厅', '森林', '沙漠', '河流', '山谷']
+    action_count = sum(1 for l in lines if any(kw in l for kw in action_keywords))
+    desc_count = sum(1 for l in lines if any(kw in l for kw in description_keywords))
+    total = len(lines)
+    return {
+        'dialogue_pct': round(dialogue_lines / total * 100, 1) if total else 0,
+        'action_pct': round(action_count / total * 100, 1) if total else 0,
+        'description_pct': round(desc_count / total * 100, 1) if total else 0,
+        'total_paragraphs': total
+    }
+
+
+# ─── 节奏评级 ───────────────────────────────
+_HIGHEST_INTENSITY_KEYWORDS = ['生死', '对决', '终极', '决战', '毁灭', '崩塌', '同归于尽', '最后一击']
+_HIGH_INTENSITY_KEYWORDS = ['战斗', '突破', '打脸', '击杀', '轰杀', '爆发', '碾压', '秒杀']
+_MID_INTENSITY_KEYWORDS = ['准备', '计划', '修炼', '提升', '领悟', '探索']
+_LOW_INTENSITY_KEYWORDS = ['日常', '对话', '闲聊', '休息', '散步', '喝茶']
+
+
+def estimate_pacing(text):
+    """Estimate chapter pacing level S1-S5 based on content keywords."""
+    clean = clean_markdown(text)
+    lines = [l.strip() for l in clean.split('\n') if l.strip()]
+    total = max(len(lines), 1)
+    highest = sum(1 for l in lines if any(kw in l for kw in _HIGHEST_INTENSITY_KEYWORDS))
+    high = sum(1 for l in lines if any(kw in l for kw in _HIGH_INTENSITY_KEYWORDS))
+    mid = sum(1 for l in lines if any(kw in l for kw in _MID_INTENSITY_KEYWORDS))
+    low = sum(1 for l in lines if any(kw in l for kw in _LOW_INTENSITY_KEYWORDS))
+    score = highest * 5 + high * 4 + mid * 3 + low * 1
+    avg = score / total
+    if avg >= 2.5:
+        return 'S5', 5
+    elif avg >= 1.8:
+        return 'S4', 4
+    elif avg >= 1.2:
+        return 'S3', 3
+    elif avg >= 0.6:
+        return 'S2', 2
+    else:
+        return 'S1', 1
+
+
+# ─── Markdown 大纲解析 ───────────────────────────────
+def parse_outline_headings(text, max_level=4):
+    """Parse markdown outline into a tree of headings."""
+    tree = []
+    for line in text.split('\n'):
+        m = re.match(r'^(#{1,' + str(max_level) + r'})\s+(.+)', line)
+        if m:
+            level = len(m.group(1))
+            title = m.group(2).strip()
+            tree.append({'level': level, 'title': title})
+    return tree
+
+
+# ─── Truth文件读取 ───────────────────────────────
+def read_truth_section(filepath):
+    """Read a truth file and return structured sections."""
+    if not os.path.exists(filepath):
+        return None
+    with open(filepath, 'r', encoding='utf-8') as f:
+        text = f.read()
+    sections = {}
+    current_section = 'header'
+    sections[current_section] = []
+    for line in text.split('\n'):
+        if line.startswith('## '):
+            current_section = line[3:].strip()
+            sections[current_section] = []
+        elif line.startswith('# '):
+            current_section = line[2:].strip()
+            sections[current_section] = []
+        else:
+            sections[current_section].append(line)
+    return {k: '\n'.join(v).strip() for k, v in sections.items() if v}

package/skill/scripts/common/validate.py

@@ -0,0 +1,215 @@
+#!/usr/bin/env python3
+"""NovelMaker 技能验证脚本
+
+验证所有技能文件的完整性和正确性：
+- Python 脚本语法检查
+- 文件引用完整性检查
+- 角色定义完整性检查
+- 题材包完整性检查
+- 弧线模板完整性检查
+"""
+
+import ast
+import os
+import re
+import sys
+from pathlib import Path
+
+SKILL_DIR = Path(__file__).resolve().parent.parent.parent
+PROJECT_DIR = SKILL_DIR.parent
+
+
+def check_python_syntax():
+    """检查所有 Python 脚本的语法"""
+    results = []
+    scripts_dir = SKILL_DIR / "scripts"
+    for py_file in sorted(scripts_dir.rglob("*.py")):
+        try:
+            with open(py_file, encoding="utf-8") as f:
+                ast.parse(f.read())
+            results.append(("PASS", py_file.name, "语法正确"))
+        except SyntaxError as e:
+            results.append(("FAIL", py_file.name, f"语法错误: {e.msg} 行{e.lineno}"))
+    return results
+
+
+def check_markdown_references():
+    """检查 SKILL.md 和 QUICK-REF.md 中的文件引用"""
+    results = []
+    patterns = [
+        (SKILL_DIR / "SKILL.md", r'\[.*?\]\(([^)]+)\)'),
+        (SKILL_DIR / "QUICK-REF.md", r'`scripts/(\S+\.py)`'),
+    ]
+
+    for md_file, pattern in patterns:
+        if not md_file.exists():
+            results.append(("FAIL", md_file.name, "文件不存在"))
+            continue
+
+        with open(md_file, encoding="utf-8") as f:
+            content = f.read()
+
+        for match in re.finditer(pattern, content):
+            ref = match.group(1)
+            if ref.startswith(("http://", "https://", "#")):
+                continue
+            ref_path = md_file.parent / ref
+            if not ref_path.exists():
+                results.append(("WARN", md_file.name, f"断裂引用: {ref}"))
+            else:
+                results.append(("PASS", md_file.name, f"引用有效: {ref}"))
+    return results
+
+
+def check_agents():
+    """检查角色定义完整性"""
+    results = []
+    agents_dir = SKILL_DIR / "agents"
+    expected = ["coordinator.md", "planner.md", "writer.md",
+                "auditor.md", "reviser.md", "reviewer.md"]
+
+    for agent in expected:
+        agent_path = agents_dir / agent
+        if not agent_path.exists():
+            results.append(("FAIL", f"agents/{agent}", "文件不存在"))
+            continue
+        with open(agent_path, encoding="utf-8") as f:
+            content = f.read()
+        required_sections = ["职责", "触发"]
+        missing = [s for s in required_sections if s not in content]
+        if missing:
+            results.append(("WARN", f"agents/{agent}", f"缺少章节: {', '.join(missing)}"))
+        else:
+            results.append(("PASS", f"agents/{agent}", "定义完整"))
+    return results
+
+
+def check_genre_packs():
+    """检查题材包完整性"""
+    results = []
+    packs_dir = SKILL_DIR / "genre-packs"
+    required_files = ["rules.md", "templates.md", "arc-types.md"]
+
+    for pack_dir in sorted(packs_dir.iterdir()):
+        if not pack_dir.is_dir() or pack_dir.name.startswith("_"):
+            continue
+        for req_file in required_files:
+            file_path = pack_dir / req_file
+            if not file_path.exists():
+                results.append(("FAIL", f"genre-packs/{pack_dir.name}/{req_file}", "文件不存在"))
+            else:
+                results.append(("PASS", f"genre-packs/{pack_dir.name}/{req_file}", "存在"))
+    return results
+
+
+def check_arc_templates():
+    """检查弧线模板完整性"""
+    results = []
+    templates_dir = SKILL_DIR / "arc-templates"
+
+    for genre_dir in sorted(templates_dir.iterdir()):
+        if not genre_dir.is_dir():
+            continue
+        md_files = list(genre_dir.glob("*.md"))
+        if not md_files:
+            results.append(("WARN", f"arc-templates/{genre_dir.name}", "目录为空"))
+        else:
+            results.append(("PASS", f"arc-templates/{genre_dir.name}", f"{len(md_files)}个模板"))
+    return results
+
+
+def check_rules():
+    """检查规则文件完整性"""
+    results = []
+    rules_dir = SKILL_DIR / "rules"
+    expected = ["anti-ai-expressions.md", "character-voice.md", "consistency-check.md", "smart-query.md"]
+
+    for rule in expected:
+        rule_path = rules_dir / rule
+        if not rule_path.exists():
+            results.append(("FAIL", f"rules/{rule}", "文件不存在"))
+        else:
+            results.append(("PASS", f"rules/{rule}", "存在"))
+    return results
+
+
+def check_templates():
+    """检查模板文件完整性"""
+    results = []
+    templates_dir = SKILL_DIR / "templates"
+    required = ["constitution.md", "outline.md", "chapter.md", "character-profile.md"]
+
+    for tpl in required:
+        tpl_path = templates_dir / tpl
+        if not tpl_path.exists():
+            results.append(("FAIL", f"templates/{tpl}", "文件不存在"))
+        else:
+            results.append(("PASS", f"templates/{tpl}", "存在"))
+    return results
+
+
+def check_hooks():
+    """检查 Hook 文件完整性"""
+    results = []
+    hooks_dir = SKILL_DIR / "hooks"
+    expected = ["context-injection.md", "intent-detection.md", "chapter-complete.md",
+                "review-trigger.md", "summary-trigger.md"]
+
+    for hook in expected:
+        hook_path = hooks_dir / hook
+        if not hook_path.exists():
+            results.append(("FAIL", f"hooks/{hook}", "文件不存在"))
+        else:
+            results.append(("PASS", f"hooks/{hook}", "存在"))
+    return results
+
+
+def run_all_checks():
+    """运行所有检查"""
+    checks = [
+        ("Python 脚本语法", check_python_syntax),
+        ("Markdown 文件引用", check_markdown_references),
+        ("角色定义", check_agents),
+        ("题材包", check_genre_packs),
+        ("弧线模板", check_arc_templates),
+        ("规则文件", check_rules),
+        ("模板文件", check_templates),
+        ("Hook 文件", check_hooks),
+    ]
+
+    total_pass = 0
+    total_warn = 0
+    total_fail = 0
+
+    print("=" * 60)
+    print("NovelMaker 技能验证报告")
+    print("=" * 60)
+
+    for check_name, check_func in checks:
+        results = check_func()
+        passes = [r for r in results if r[0] == "PASS"]
+        warns = [r for r in results if r[0] == "WARN"]
+        fails = [r for r in results if r[0] == "FAIL"]
+
+        total_pass += len(passes)
+        total_warn += len(warns)
+        total_fail += len(fails)
+
+        status = "✓" if not fails else "✗"
+        print(f"\n{status} {check_name} ({len(passes)}通过 {len(warns)}警告 {len(fails)}失败)")
+
+        for level, name, msg in fails:
+            print(f"  ✗ {name}: {msg}")
+        for level, name, msg in warns:
+            print(f"  ⚠ {name}: {msg}")
+
+    print("\n" + "=" * 60)
+    print(f"总计: {total_pass}通过 {total_warn}警告 {total_fail}失败")
+    print("=" * 60)
+
+    return total_fail == 0
+
+
+if __name__ == "__main__":
+    success = run_all_checks()
+    sys.exit(0 if success else 1)