alextiannus/skills/novel-writer

Novel Writer Skills - Claude Code 专用小说创作工具

🚀 专为 Claude Code 设计的 AI 智能小说创作助手

深度集成 Slash Commands 和 Agent Skills，提供最佳创作体验

✨ 核心特性

• 📚 Slash Commands - Claude Code 斜杠命令，七步方法论完整支持
• 🤖 Agent Skills - AI 自动激活的知识库和智能检查系统
• 🎯 类型知识库 - 自动提供言情、悬疑、奇幻等类型创作惯例
• 🔍 智能质量检查 - 自动监控一致性、节奏、视角等问题
• 📝 写作技巧增强 - 对话、场景、角色等专业技巧自动应用
• 🔌 插件系统 - 可扩展功能，如真实人声、翻译等

🚀 快速开始

1. 安装

npm install -g novel-writer-skills

2. 初始化项目

# 基本用法
novelwrite init my-novel

# 在当前目录初始化
novelwrite init --here

# 预装插件
novelwrite init my-novel --plugins authentic-voice

3. 在 Claude Code 中开始创作

在 Claude Code 中打开项目，使用斜杠命令：

/constitution    # 1. 创建创作宪法
/specify         # 2. 定义故事规格
/clarify         # 3. 澄清关键决策
/plan            # 4. 制定创作计划
/tasks           # 5. 分解任务清单
/write           # 6. AI 辅助写作
/analyze         # 7. 质量验证分析

🎨 Agent Skills 自动激活

类型知识库（Genre Knowledge）

当你提到特定类型时，相应的知识库会自动激活：

• 💕 Romance - 言情小说惯例和情感节奏
• 🔍 Mystery - 推理悬疑技巧和线索管理
• 🐉 Fantasy - 奇幻设定规范和世界构建

写作技巧（Writing Techniques）

写作过程中自动应用最佳实践：

• 💬 Dialogue - 对话自然度和角色声音
• 🎬 Scene Structure - 场景构建和节奏控制
• 👤 Character Arc - 角色弧线和成长逻辑

智能检查（Quality Assurance）

后台自动监控，主动提醒问题：

• ✅ Consistency Checker - 一致性检查（角色、世界观、时间线）
• 🧭 Workflow Guide - 引导使用七步方法论

📚 Slash Commands

七步方法论

| 命令 | 功能 | 输出 | |------|------|------| | /constitution | 创建创作宪法 | .specify/memory/constitution.md | | /specify | 定义故事规格 | stories/[name]/specification.md | | /clarify | 澄清模糊点（5个问题） | 更新 specification.md | | /plan | 制定创作计划 | stories/[name]/creative-plan.md | | /tasks | 分解任务清单 | stories/[name]/tasks.md | | /write | 执行章节写作 | stories/[name]/content/chapter-XX.md | | /analyze | 质量验证分析 | 分析报告（双模式：框架/内容） |

追踪与验证

| 命令 | 功能 | |------|------| | /track-init | 初始化追踪系统 | | /track | 综合追踪更新 | | /plot-check | 情节一致性检查 | | /timeline | 时间线管理 | | /relations | 角色关系追踪 | | /world-check | 世界观验证 |

🔌 插件系统

安装插件

# 列出可用插件
novelwrite plugin:list

# 安装插件
novelwrite plugin:add authentic-voice

# 移除插件
novelwrite plugin:remove authentic-voice

官方插件

• authentic-voice - 真实人声写作插件，提升原创度和生活质感
• 更多插件开发中...

📖 项目结构

my-novel/
├── .claude/
│   ├── commands/       # Slash Commands
│   └── skills/         # Agent Skills
│
├── .specify/           # Spec Kit 配置
│   ├── memory/
│   │   └── constitution.md
│   └── templates/
│       ├── scripts/    # 命令行脚本工具
│       │   ├── bash/
│       │   └── powershell/
│       ├── commands/
│       ├── knowledge/
│       └── ...
│
├── stories/
│   └── 001-my-story/
│       ├── specification.md
│       ├── creative-plan.md
│       ├── tasks.md
│       └── content/
│           ├── chapter-01.md
│           └── ...
│
├── spec/
│   ├── tracking/       # 追踪数据
│   │   ├── plot-tracker.json
│   │   ├── timeline.json
│   │   ├── character-state.json
│   │   └── relationships.json
│   │
│   └── knowledge/      # 知识库
│       ├── characters/
│       ├── worldbuilding/
│       └── references/
│
└── README.md

🆚 与 novel-writer 的关系

| 特性 | novel-writer | novel-writer-skills | |------|-------------|-------------------| | 支持平台 | 13个AI工具（Claude、Cursor、Gemini等） | Claude Code 专用 | | 核心方法论 | ✅ 七步方法论 | ✅ 七步方法论 | | Slash Commands | ✅ 跨平台命令 | ✅ Claude 优化命令 | | Agent Skills | ❌ 不支持 | ✅ 深度集成 | | 智能检查 | ⚠️ 手动执行 | ✅ 自动监控 | | 类型知识库 | ⚠️ 需手动查阅 | ✅ 自动激活 | | 适用场景 | 需要跨平台支持 | 追求最佳体验（Claude Code） |

选择建议：

• 如果你使用多个AI工具 → 选择 novel-writer
• 如果你专注 Claude Code → 选择 novel-writer-skills

🛠️ CLI 命令

项目管理

# 初始化项目
novelwrite init <project-name>

# 检查环境
novelwrite check

# 升级项目
novelwrite upgrade

插件管理

# 列出已安装插件
novelwrite plugin:list

# 安装插件
novelwrite plugin:add <plugin-name>

# 移除插件
novelwrite plugin:remove <plugin-name>

🔧 命令行脚本（可选）

除了 Claude Code 中的 Slash Commands，项目还包含命令行脚本工具：

脚本位置

初始化项目后，脚本位于：.specify/templates/scripts/

.specify/templates/scripts/
├── bash/          # macOS/Linux 脚本
└── powershell/    # Windows 脚本

使用场景

• ✅ 命令行替代 - 在终端中直接执行七步方法论
• ✅ 自动化工作流 - 集成到 CI/CD 或批处理脚本
• ✅ 批量操作 - 处理多个故事或批量检查
• ✅ 独立使用 - 不依赖 Claude Code 的场景

快速示例

macOS/Linux:

# 创建宪法
bash .specify/templates/scripts/bash/constitution.sh

# 定义规格
bash .specify/templates/scripts/bash/specify-story.sh

# 追踪进度
bash .specify/templates/scripts/bash/track-progress.sh

Windows:

# 创建宪法
.\.specify\templates\scripts\powershell\constitution.ps1

# 定义规格
.\.specify\templates\scripts\powershell\specify-story.ps1

# 追踪进度
.\.specify\templates\scripts\powershell\track-progress.ps1

可用脚本

所有 Slash Commands 都有对应的脚本版本：

| 脚本 | 功能 | 对应命令 | |-----|------|---------| | constitution | 创建创作宪法 | /constitution | | specify-story | 定义故事规格 | /specify | | plan-story | 制定创作计划 | /plan | | track-progress | 追踪进度 | /track | | check-consistency | 一致性检查 | - | | 以及更多... | 查看 .specify/templates/scripts/README.md | - |

📖 详细文档：scripts/README.md

何时使用脚本 vs Slash Commands

| 场景 | 推荐方式 | |-----|---------| | 日常创作、需要 AI 协助 | ✅ Slash Commands (优先) | | 批量处理、自动化 | ✅ 命令行脚本 | | CI/CD 集成 | ✅ 命令行脚本 | | 快速检查验证 | ✅ 命令行脚本 |

📚 文档

• 入门指南 - 详细安装和使用教程
• 命令详解 - 所有命令的完整说明
• Skills 指南 - Agent Skills 工作原理
• 脚本工具集 - 命令行脚本使用指南
• 插件开发 - 如何开发自己的插件

🤝 贡献

欢迎提交 Issue 和 Pull Request！

项目地址：https://github.com/wordflowlab/novel-writer-skills

📄 许可证

MIT License

🙏 致谢

本项目基于 novel-writer 的方法论，专为 Claude Code 深度优化。

---

Novel Writer Skills - 让 Claude Code 成为你的最佳创作伙伴！ ✨📚