参考Spec-kit 实现小说撰写工具

Files	Last commit	Last update
.claude	fix: 修复命令前缀从 novel. 改为 content. - Claude Code: /content.audit, /content.write-draft 等 - Gemini CLI: /content:audit (目录结构改为 .gemini/commands/content/) - Codex CLI: /content-audit, /content-write-draft 等 - 其他平台: /audit, /write-draft 等 - 更新构建系统提示信息 - 版本号升级到 0.1.2	10 months ago
.github	feat: 多平台命令格式优化 v0.15.0 ## 核心改进 - 实现单一源 + 构建系统架构，统一管理所有平台命令 - 修复各平台 frontmatter 字段支持问题 - 为 13 个 AI 平台提供正确的命令格式 ## 技术更新 - 新增构建脚本 scripts/build/generate-commands.sh - 支持 4 种 frontmatter 类型：none/minimal/partial/full - Gemini 和 Qwen 使用 TOML 格式，只包含 description 和 prompt - 变量占位符自动转换：$ARGUMENTS → {{args}} ## 平台支持 ✅ Claude Code - 完整 frontmatter ✅ Gemini CLI - TOML 格式 ✅ Cursor - 纯 Markdown ✅ Windsurf - 部分 frontmatter ✅ Roo Code - 部分 frontmatter ✅ GitHub Copilot - 纯 Markdown ✅ Qwen Code - TOML 格式 ✅ OpenCode - 最小 frontmatter ✅ Codex CLI - 纯 Markdown ✅ Kilo Code - 部分 frontmatter ✅ Auggie CLI - 纯 Markdown ✅ CodeBuddy - 纯 Markdown ✅ Amazon Q Developer - 纯 Markdown ## 文档更新 - 更新 README.md 添加所有支持平台说明 - 更新 docs/gemini-command-guide.md 说明新架构 - 更新 docs/upgrade-guide.md 添加升级指南 - 新增 CHANGELOG v0.15.0 详细说明 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
.specify	feat: 改进小说分段格式规范并修复脚本错误 v0.16.3 1. 修复 check-writing-state.sh 语法错误 - 移除第170行 for 循环中的非法重定向 - 添加可执行权限 - 创建 .specify 目录副本以支持开发环境 2. 优化小说分段格式规范 - 禁止使用"一"、"二"、"三"等数字标记分段 - 推荐使用纯空行（两个换行）进行场景转换 - 理由：数字标记过于生硬，破坏阅读沉浸感 3. 更新文档和模板 - writing-constitution.md: 添加分段格式规范章节 - writing-constitution-template.md: 同步更新模板 - write 命令模板: 添加分段格式提醒和检查项 4. 创建必要的目录结构 - 为 story-20251011 创建 content 目录 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
docs	feat: 添加 Codex CLI 支持 v0.19.0 🎉 新功能 - 完整支持 OpenAI Codex CLI - 命令格式: /novel-命令名 (例如: /novel-write) - 使用 novel- 前缀避免命名冲突 - 13 个核心命令全部支持 📚 新增文档 - docs/ai-platform-commands.md - 13 个 AI 平台完整命令对照指南 - 更新 docs/why-codex-not-supported.md 说明已支持 - 更新 README.md 添加 Codex CLI 说明 - 更新 templates/GEMINI.md 明确命名空间规则 🔧 构建系统 - 修改 scripts/build/generate-commands.sh 支持 Codex - Codex 使用纯 Markdown 格式(无 frontmatter) - 命令文件位于 .codex/prompts/ 目录 🎯 支持平台现在支持 13 个 AI 平台: Claude、Gemini、Codex、Cursor、Windsurf、 Roo Code、GitHub Copilot、Qwen、OpenCode、Kilo Code、Auggie、 CodeBuddy、Amazon Q 参考: Spec-Kit v0.0.11+ 实现方案 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
experts	fix: 修复 expert 命令缺失核心专家文件 v0.17.1 ## 问题 - 用户反馈 roocode experts/core 目录不存在 - expert 命令引用了不存在的 experts/core/<type>.md 文件 - 构建系统未复制 experts 目录到 dist ## 修复内容 1. 创建核心专家文件 - experts/core/plot.md - 剧情结构专家 - experts/core/character.md - 人物塑造专家 - experts/core/world.md - 世界观设计专家 - experts/core/style.md - 文风语言专家 2. 更新构建脚本 - 在 copy_support_files 函数中添加 experts 目录复制逻辑 - 确保所有 AI 平台构建产物都包含 experts 3. 修正路径引用 - 更新 expert.md 命令中的路径：experts/core → .specify/experts/core - 更新 allowed-tools 中的路径模式 ## 测试验证 - ✅ 所有 13 个 AI 平台构建成功 - ✅ dist/roocode/.specify/experts/core/ 包含全部 4 个专家文件 - ✅ novel init --ai roocode --here 成功创建完整项目 - ✅ 跨平台支持（claude、cursor、gemini 等） 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
memory	fix: 修复宪法文件命名和脚本路径重复问题 v0.18.4 ### 🐛 问题修复 #### 宪法文件命名统一 - 统一宪法文件命名为 constitution.md - 重命名源文件: memory/writing-constitution.md → memory/constitution.md - 修改所有 Bash/PowerShell 脚本中的文件路径引用 - 修改所有命令模板中的文件引用和权限配置 - 解决用户项目中出现多个宪法文件的问题 #### 脚本路径重复问题 - 修复构建系统中 rewrite_paths() 函数的路径重复添加问题 - 使用临时标记保护已有 .specify/ 路径 - 修正路径错误: .specify.specify/scripts/ → .specify/scripts/ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
other	fix: 修复命令前缀从 novel. 改为 content. - Claude Code: /content.audit, /content.write-draft 等 - Gemini CLI: /content:audit (目录结构改为 .gemini/commands/content/) - Codex CLI: /content-audit, /content-write-draft 等 - 其他平台: /audit, /write-draft 等 - 更新构建系统提示信息 - 版本号升级到 0.1.2	10 months ago
plugins	feat: 标准化 genre-knowledge 插件安装系统 v0.18.3 统一插件安装方式,使 genre-knowledge 使用标准的 `novel plugins:add` 命令主要改进: - 新增 `plugins/genre-knowledge/config.yaml` 配置文件 - 定义插件元数据 (name, version, description, type, dependencies) - type: knowledge (特殊类型,无独立命令) - 安装后显示详细的增强步骤说明 - 更新 `plugins/genre-knowledge/README.md` - 安装方法: `novel plugins:add genre-knowledge` - 卸载方法: `novel plugins:remove genre-knowledge` - 添加安装验证说明 - 更新 `src/cli.ts` - 在 `plugins:list` 命令提示中添加 genre-knowledge - 在 `plugins:add` 错误提示中添加 genre-knowledge - 与其他插件保持一致的用户体验测试验证: - ✅ 插件安装流程测试通过 - ✅ 插件列表显示正确 - ✅ 增强命令文件复制成功 (3个文件,95行) - ✅ 安装后显示详细使用说明 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
scripts	feat: 添加 Codex CLI 支持 v0.19.0 🎉 新功能 - 完整支持 OpenAI Codex CLI - 命令格式: /novel-命令名 (例如: /novel-write) - 使用 novel- 前缀避免命名冲突 - 13 个核心命令全部支持 📚 新增文档 - docs/ai-platform-commands.md - 13 个 AI 平台完整命令对照指南 - 更新 docs/why-codex-not-supported.md 说明已支持 - 更新 README.md 添加 Codex CLI 说明 - 更新 templates/GEMINI.md 明确命名空间规则 🔧 构建系统 - 修改 scripts/build/generate-commands.sh 支持 Codex - Codex 使用纯 Markdown 格式(无 frontmatter) - 命令文件位于 .codex/prompts/ 目录 🎯 支持平台现在支持 13 个 AI 平台: Claude、Gemini、Codex、Cursor、Windsurf、 Roo Code、GitHub Copilot、Qwen、OpenCode、Kilo Code、Auggie、 CodeBuddy、Amazon Q 参考: Spec-Kit v0.0.11+ 实现方案 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
spec	chore: 架构优化 - 类型知识插件化 v0.18.1 ## 核心改进将类型知识从 spec/knowledge/genres/ 迁移到 plugins/genre-knowledge/，实现真正的可选插件架构。 ### 类型知识插件化 - 迁移 5 个类型知识文件到插件： · fantasy.md (669行) - 奇幻/玄幻 · scifi.md (530行) - 科幻 · romance.md (378行) - 言情 · mystery.md (353行) - 悬疑推理 · shuangwen.md (236行) - 爽文 - 插件包含 7 个知识文件（含 2 个专项深度文件） ### 可选插件架构 - 移除核心命令对插件的硬编码依赖 - 添加 plugins/** 通配符权限支持所有插件 - 保留 PLUGIN_HOOK 标记供用户手动启用 - 用户只需复制粘贴增强提示词，无需修改权限 ### 设计理念 - ✅ 清晰职责：spec/ 专注用户内容，plugins/ 专注可选功能 - ✅ 单一数据源：避免重复和混乱 - ✅ 架构简洁：无技术债务，无向后兼容代码 ## 影响文件 - deleted: spec/knowledge/genres/* (5个文件) - added: plugins/genre-knowledge/ (7个知识文件 + 2个README) - modified: templates/commands/{clarify,plan,analyze}.md - modified: package.json (版本 0.18.1) - modified: CHANGELOG.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
src	feat: v0.20.0 - Interactive startup interface ## 🎯 主要更新 ### 交互式启动界面 - ✨ 添加 spec-kit 风格的交互式选择界面 - 🎨 箭头键选择 AI 助手（13个平台） - 📚 箭头键选择写作方法（6种：三幕结构、英雄之旅、故事圈、七点结构、皮克斯公式、雪花十步） - 🔧 箭头键选择脚本类型（sh/ps） - 👨‍🏫 交互式确认专家模式 - ⚡ 保持向后兼容：CLI 参数仍然有效 ## 📝 详细变更新增文件: - `src/utils/interactive.ts` - 交互式选择工具修改文件: - `src/cli.ts` - 集成交互式模式 - `package.json` - 版本更新到 0.20.0 ## 🚀 使用方式 ```bash # 交互式模式（新功能） novel init my-story # 参数模式（兼容） novel init my-story --ai cursor --method hero-journey --with-experts ``` ## 📂 目录结构保持使用 `.specify/` 目录（与 article-writer 的 `.content/` 不同） 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
stories	chore: 重构命令体系,完善跨平台支持和追踪系统 - 新增 clarify、expert、track-init 命令 - 删除冗余的 story、style、outline、chapters 命令 - 同步 Bash 和 PowerShell 脚本 - 移动脚本到 .specify 目录统一管理 - 完善 Gemini 命令模板 - 添加追踪系统和验证规则 - 更新文档和工作流程说明 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	11 months ago
templates	feat: 添加 Codex CLI 支持 v0.19.0 🎉 新功能 - 完整支持 OpenAI Codex CLI - 命令格式: /novel-命令名 (例如: /novel-write) - 使用 novel- 前缀避免命名冲突 - 13 个核心命令全部支持 📚 新增文档 - docs/ai-platform-commands.md - 13 个 AI 平台完整命令对照指南 - 更新 docs/why-codex-not-supported.md 说明已支持 - 更新 README.md 添加 Codex CLI 说明 - 更新 templates/GEMINI.md 明确命名空间规则 🔧 构建系统 - 修改 scripts/build/generate-commands.sh 支持 Codex - Codex 使用纯 Markdown 格式(无 frontmatter) - 命令文件位于 .codex/prompts/ 目录 🎯 支持平台现在支持 13 个 AI 平台: Claude、Gemini、Codex、Cursor、Windsurf、 Roo Code、GitHub Copilot、Qwen、OpenCode、Kilo Code、Auggie、 CodeBuddy、Amazon Q 参考: Spec-Kit v0.0.11+ 实现方案 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
.gitignore	docs: 更新 README 添加项目矩阵章节 - 新增项目矩阵章节，介绍 WordFlowLab 的多个探索项目 - 包含方法论探索系列（Novel-Writer, Novel-Writer-OpenSpec, Novel-Writer-Skills） - 包含工具实现系列（WriteFlow, NovelWeave） - 添加技术演进路径和选择建议 - 更新 .gitignore 配置	10 months ago
.npmignore	feat: 多平台命令格式优化 v0.15.0 ## 核心改进 - 实现单一源 + 构建系统架构，统一管理所有平台命令 - 修复各平台 frontmatter 字段支持问题 - 为 13 个 AI 平台提供正确的命令格式 ## 技术更新 - 新增构建脚本 scripts/build/generate-commands.sh - 支持 4 种 frontmatter 类型：none/minimal/partial/full - Gemini 和 Qwen 使用 TOML 格式，只包含 description 和 prompt - 变量占位符自动转换：$ARGUMENTS → {{args}} ## 平台支持 ✅ Claude Code - 完整 frontmatter ✅ Gemini CLI - TOML 格式 ✅ Cursor - 纯 Markdown ✅ Windsurf - 部分 frontmatter ✅ Roo Code - 部分 frontmatter ✅ GitHub Copilot - 纯 Markdown ✅ Qwen Code - TOML 格式 ✅ OpenCode - 最小 frontmatter ✅ Codex CLI - 纯 Markdown ✅ Kilo Code - 部分 frontmatter ✅ Auggie CLI - 纯 Markdown ✅ CodeBuddy - 纯 Markdown ✅ Amazon Q Developer - 纯 Markdown ## 文档更新 - 更新 README.md 添加所有支持平台说明 - 更新 docs/gemini-command-guide.md 说明新架构 - 更新 docs/upgrade-guide.md 添加升级指南 - 新增 CHANGELOG v0.15.0 详细说明 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
CHANGELOG.md	feat: 添加 Codex CLI 支持 v0.19.0 🎉 新功能 - 完整支持 OpenAI Codex CLI - 命令格式: /novel-命令名 (例如: /novel-write) - 使用 novel- 前缀避免命名冲突 - 13 个核心命令全部支持 📚 新增文档 - docs/ai-platform-commands.md - 13 个 AI 平台完整命令对照指南 - 更新 docs/why-codex-not-supported.md 说明已支持 - 更新 README.md 添加 Codex CLI 说明 - 更新 templates/GEMINI.md 明确命名空间规则 🔧 构建系统 - 修改 scripts/build/generate-commands.sh 支持 Codex - Codex 使用纯 Markdown 格式(无 frontmatter) - 命令文件位于 .codex/prompts/ 目录 🎯 支持平台现在支持 13 个 AI 平台: Claude、Gemini、Codex、Cursor、Windsurf、 Roo Code、GitHub Copilot、Qwen、OpenCode、Kilo Code、Auggie、 CodeBuddy、Amazon Q 参考: Spec-Kit v0.0.11+ 实现方案 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
LICENSE	feat: 发布到 npm 公共仓库 - 添加 LICENSE 文件 - 更改包名为 novel-writer-cn - 成功发布版本 0.1.0	11 months ago
METHODOLOGY.md	chore: 重构命令体系,完善跨平台支持和追踪系统 - 新增 clarify、expert、track-init 命令 - 删除冗余的 story、style、outline、chapters 命令 - 同步 Bash 和 PowerShell 脚本 - 移动脚本到 .specify 目录统一管理 - 完善 Gemini 命令模板 - 添加追踪系统和验证规则 - 更新文档和工作流程说明 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	11 months ago
README.md	docs: 在项目矩阵中添加 Article-Writer - 在"方法论探索系列"表格中新增 Article-Writer 项目 - 说明其基于 Spec-Kit 方法论，采用九步写作流程 - 定位为公众号/自媒体文章创作工具，专注降低 AI 味 - 添加 🆕 标记突出新项目 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
bun.lock	fix: 修复路径权限和宪法文件命名问题 v0.13.3 ## 问题修复 ### 1. 路径权限不匹配 - 添加相对路径权限支持 - 所有命令现在同时支持 `//path/` 和 `path/` 格式 - 修复 Read/Write 权限检查失败的问题 ### 2. 移除旧版本兼容逻辑 - 统一使用 `memory/novel-constitution.md` - 移除 `.specify/memory/writing-constitution.md` 兼容代码 - 简化 constitution.sh 和 constitution.ps1 脚本 - 更新命令说明，明确文件检查逻辑 ### 3. 优化执行流程 - constitution 命令现在先用 Bash 检查文件是否存在 - 避免尝试 Read 不存在的文件 - 提供更清晰的错误提示 ## 修改文件 - templates/commands-claude/*.md (14个文件，添加相对路径权限) - scripts/bash/constitution.sh (移除旧版本兼容) - scripts/powershell/constitution.ps1 (移除旧版本兼容) - templates/commands-claude/constitution.md (更新执行说明) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	11 months ago
novel-sdd.md	chore: 重构命令体系,完善跨平台支持和追踪系统 - 新增 clarify、expert、track-init 命令 - 删除冗余的 story、style、outline、chapters 命令 - 同步 Bash 和 PowerShell 脚本 - 移动脚本到 .specify 目录统一管理 - 完善 Gemini 命令模板 - 添加追踪系统和验证规则 - 更新文档和工作流程说明 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	11 months ago
package.json	feat: v0.20.0 - Interactive startup interface ## 🎯 主要更新 ### 交互式启动界面 - ✨ 添加 spec-kit 风格的交互式选择界面 - 🎨 箭头键选择 AI 助手（13个平台） - 📚 箭头键选择写作方法（6种：三幕结构、英雄之旅、故事圈、七点结构、皮克斯公式、雪花十步） - 🔧 箭头键选择脚本类型（sh/ps） - 👨‍🏫 交互式确认专家模式 - ⚡ 保持向后兼容：CLI 参数仍然有效 ## 📝 详细变更新增文件: - `src/utils/interactive.ts` - 交互式选择工具修改文件: - `src/cli.ts` - 集成交互式模式 - `package.json` - 版本更新到 0.20.0 ## 🚀 使用方式 ```bash # 交互式模式（新功能） novel init my-story # 参数模式（兼容） novel init my-story --ai cursor --method hero-journey --with-experts ``` ## 📂 目录结构保持使用 `.specify/` 目录（与 article-writer 的 `.content/` 不同） 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	10 months ago
tsconfig.json	Initial commit: Novel Writer - AI驱动的中文小说创作工具 - 基于 TypeScript 构建的 CLI 工具 - 6个核心命令支持完整创作流程 - 中文优化的模板和界面 - 支持多种 AI 助手集成 - 结构化的创作工作流	11 months ago

Novel Writer - AI 驱动的中文小说创作工具

🚀 基于规格驱动开发（SDD）的 AI 智能小说创作助手

在 Claude、Cursor、Gemini 等 AI 助手中直接使用斜杠命令，系统化创作高质量小说

✨ 核心特性

📚 斜杠命令 - 在 Claude、Gemini、Codex、Cursor、Windsurf、Roo Code 等 AI 助手中直接使用
🎯 七步方法论 - 基于规格驱动开发（SDD）的系统化创作流程
🤖 智能辅助 - AI 理解上下文，提供针对性创作建议
📝 中文优化 - 专为中文小说创作设计，支持字数统计、多线索管理
🔄 跨平台 - 支持 13 个 AI 工具，Windows/Mac/Linux 全平台
🔌 插件系统 - 可扩展功能，如真实人声、翻译、风格模仿等
✅ 质量保障 - 情节追踪、时间线管理、角色一致性验证

📖 详细特性说明：查看 CHANGELOG.md 了解各版本的完整更新

🚀 快速开始

1. 安装

npm install -g novel-writer-cn

2. 初始化项目

# 基本用法
novel init my-novel

# 推荐：预装真实人声插件
novel init my-novel --plugins authentic-voice

# 指定 AI 平台
novel init my-novel --ai claude    # Claude Code
novel init my-novel --ai gemini    # Gemini CLI
novel init my-novel --ai codex     # Codex CLI
novel init my-novel --ai cursor    # Cursor

3. 开始创作

在 AI 助手中使用斜杠命令：

/novel.constitution    # Claude Code 格式
/novel:constitution    # Gemini CLI 格式
/novel-constitution    # Codex CLI 格式
/constitution          # 其他平台格式

七步方法论流程：

/constitution → 2. /specify → 3. /clarify →
/plan → 5. /tasks → 6. /write → 7. /analyze

📚 详细安装说明：docs/installation.md 📖 完整工作流程：docs/workflow.md 🎯 AI 平台命令对照：docs/ai-platform-commands.md ⭐ 必读

📦 升级现有项目

# 升级到最新版本
npm install -g novel-writer-cn@latest
cd my-novel
novel upgrade

# 或指定 AI 平台
novel upgrade --ai claude

📚 完整升级指南：docs/upgrade-guide.md - 包含版本兼容性、迁移说明、回滚方法

📚 斜杠命令

命名空间说明

AI 平台	命令格式	示例
Claude Code	`/novel.命令名`	`/novel.write`
Gemini CLI	`/novel:命令名`	`/novel:write`
Codex CLI	`/novel-命令名`	`/novel-write`
其他平台	`/命令名`	`/write`

💡 下表使用通用格式，实际使用时请根据您的 AI 平台添加相应前缀 📖 详细命令对照：docs/ai-platform-commands.md

七步方法论

命令	描述	何时使用
`/constitution`	创作宪法	项目开始，定义核心创作原则
`/specify`	故事规格	像 PRD 一样定义故事需求
`/clarify`	澄清决策	通过 5 个问题明确模糊点
`/plan`	创作计划	制定章节结构和技术方案
`/tasks`	任务分解	生成可执行的任务清单
`/write`	章节写作	基于任务清单进行创作
`/analyze`	综合验证	智能双模式：框架分析/内容分析

追踪与验证

命令	描述	何时使用
`/track-init`	初始化追踪	首次使用（只需一次）
`/checklist`	质量检查清单 ⭐	规格验证（写作前）+ 内容扫描（写作后）
`/track`	综合追踪	每完成一章后
`/plot-check`	情节检查	每 5-10 章定期检查
`/timeline`	时间线管理	重要事件后
`/relations`	关系追踪	角色关系变化时
`/world-check`	世界观检查	新设定出现后

📖 详细命令说明：docs/commands.md - 包含每个命令的详细用法、参数和最佳实践

📁 项目结构（点击展开）

my-novel/
├── .specify/          # Spec Kit 配置
│   ├── memory/        # 创作记忆（constitution.md等）
│   └── scripts/       # 支持脚本
├── .claude/           # Claude 命令（或 .cursor/.gemini 等）
│   └── commands/      # 斜杠命令文件
├── spec/              # 小说规格数据
│   ├── tracking/      # 追踪数据（plot-tracker.json等）
│   └── knowledge/     # 知识库（world-setting.md等）
├── stories/           # 故事内容
│   └── 001-故事名/
│       ├── specification.md    # 故事规格
│       ├── creative-plan.md    # 创作计划
│       ├── tasks.md            # 任务清单
│       └── content/            # 章节内容
└── scripts/           # 支持脚本
    ├── bash/          # Unix/Linux/Mac
    └── powershell/    # Windows

🤖 支持的 AI 助手

AI 工具	说明	状态
Claude Code	Anthropic 的 AI 助手	✅ 推荐
Cursor	AI 代码编辑器	✅ 完整支持
Gemini CLI	Google 的 AI 助手	✅ TOML 格式
Windsurf	Codeium 的 AI 编辑器	✅ 完整支持
Roo Code	AI 编程助手	✅ 完整支持
GitHub Copilot	GitHub 的 AI 编程助手	✅ 完整支持
Qwen Code	阿里通义千问代码助手	✅ TOML 格式
OpenCode	开源 AI 编程工具	✅ 完整支持
Codex CLI	AI 编程助手	✅ 完整支持
Kilo Code	AI 编程工具	✅ 完整支持
Auggie CLI	AI 开发助手	✅ 完整支持
CodeBuddy	AI 编程伙伴	✅ 完整支持
Amazon Q Developer	AWS 的 AI 开发助手	✅ 完整支持

💡 使用 novel init --all 可以同时为所有 AI 工具生成配置

🛠️ CLI 命令

详细选项（点击展开）

`novel init [name]`

novel init my-novel [选项]

常用选项：

--here - 在当前目录初始化
--ai <type> - 选择 AI 平台（claude/gemini/cursor等）
--with-experts - 包含专家模式
--plugins <names> - 预装插件（逗号分隔）
--all - 生成所有 AI 平台配置

`novel plugins`

novel plugins list                # 列出已安装插件
novel plugins add <name>          # 安装插件
novel plugins remove <name>       # 移除插件

`novel upgrade`

novel upgrade [--ai <type>]       # 升级项目到最新版本

`novel check`

novel check                       # 检查项目配置和状态

📖 文档索引

核心文档

命令详解 - 所有斜杠命令的详细用法、参数和最佳实践
工作流程 - 完整的创作流程说明
写作方法 - 6种经典写作方法详解
最佳实践 - 实战经验和高级技巧

进阶文档

实战指南 - 基于真实案例的 SDD 应用
升级指南 - 版本升级说明和迁移指南
安装指南 - 详细安装步骤
字数统计 - 中文字数统计最佳实践

插件与扩展

真实人声插件 - novel plugins add authentic-voice
- 编辑 .specify/memory/personal-voice.md 配置个人语料
- 使用 /authentic-voice 创作，/authenticity-audit 自查
翻译插件 - novel plugins add translate
风格模仿插件 - 路遥、王钰等作家风格

💡 使用 novel plugins list 查看所有可用插件

📈 版本历史

查看完整的更新日志：CHANGELOG.md

最新版本亮点：

v0.15.0 - 多平台命令格式优化
v0.14.2 - 中文字数统计修复
v0.12.2 - Claude Code 增强层
v0.12.0 - 多线索管理系统
v0.10.0 - 七步方法论体系

🤝 贡献

欢迎提交 Issue 和 Pull Request！

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

📄 许可证

MIT License

🌐 项目矩阵

WordFlowLab 围绕 AI 辅助小说创作展开多维度探索，采用不同方法论和技术栈的开源项目组合：

方法论探索系列

项目	方法论	技术特点	适用场景
Novel-Writer ⭐	Spec-Kit	寄生斜杠命令，七步方法论	适合多平台用户，跨 13 个 AI 工具
Article-Writer 🆕	Spec-Kit	九步写作流程，工作区管理	公众号/自媒体文章创作，降低 AI 味
Novel-Writer-OpenSpec	OpenSpec	寄生斜杠命令，规格分离管理（specs/ + changes/）	适合需要 OpenSpec 规格化管理
Novel-Writer-Skills	Spec-Kit + Agent Skills	寄生斜杠命令，支持 Claude Code Agent Skills	专为 Claude Code 优化

工具实现系列

项目	类型	技术基础	说明
WriteFlow	CLI 工具	模仿 Claude Code 架构	独立 CLI，为技术型作家设计
NovelWeave	VSCode 扩展	Fork: Cline → Roo Code → Kilo Code → NovelWeave	可视化小说编辑器，星尘织梦

技术演进路径

Spec-Kit 方法论分支:
  Novel-Writer (主线) ──┬─→ Novel-Writer-Skills (Claude Code 专版)
                       └─→ WriteFlow (CLI 独立版)

OpenSpec 方法论分支:
  Novel-Writer-OpenSpec (探索版)

VSCode 扩展分支:
  Cline → Roo Code → Kilo Code → NovelWeave (小说定制版)

选择建议

根据您的经验背景选择合适的工具：

用户类型	推荐项目	理由
🌟 新手入门	NovelWeave	可视化编辑器，VSCode 扩展，最易上手
💻 有编程基础无小说经验	Novel-Writer Novel-Writer-Skills	七步方法论引导创作流程 Skills 版适合 Claude Code 用户
📚 有编程基础有小说经验	Novel-Writer-OpenSpec	OpenSpec 规格化管理适合系统化创作和团队协作
🚀 技术探索者可贡献 PR	WriteFlow	CLI 工具开发探索欢迎贡献代码和想法

快速决策：

完全新手 → NovelWeave（可视化最友好）
用 Claude Code → Novel-Writer-Skills（深度集成 Agent Skills）
跨多个 AI 工具 → Novel-Writer（支持 13 个平台）
追求规格化 → Novel-Writer-OpenSpec（OpenSpec 方法论）
喜欢命令行 → WriteFlow（纯 CLI 体验）

💡 多矩阵、多方法论组合开源：探索 AI 写作的不同可能性，欢迎根据需求选择合适的工具！

🙏 致谢

本项目基于 Spec Kit 架构设计，特此感谢！

Novel Writer - 让 AI 成为你的创作伙伴！ ✨📚

Introduction