{
  "markdown": "# Novel Writer Skills - Claude Code 专用小说创作工具\n\n[![npm version](https://badge.fury.io/js/novel-writer-skills.svg)](https://www.npmjs.com/package/novel-writer-skills)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> 🚀 专为 Claude Code 设计的 AI 智能小说创作助手\n>\n> 深度集成 Slash Commands 和 Agent Skills，提供最佳创作体验\n\n## ✨ 核心特性\n\n- 📚 **Slash Commands** - Claude Code 斜杠命令，七步方法论完整支持\n- 🤖 **Agent Skills** - AI 自动激活的知识库和智能检查系统\n- 🎯 **类型知识库** - 自动提供言情、悬疑、奇幻等类型创作惯例\n- 🔍 **智能质量检查** - 自动监控一致性、节奏、视角等问题\n- 📝 **写作技巧增强** - 对话、场景、角色等专业技巧自动应用\n- 🔌 **插件系统** - 可扩展功能，如真实人声、翻译等\n\n## 🚀 快速开始\n\n### 1. 安装\n\n```bash\nnpm install -g novel-writer-skills\n```\n\n### 2. 初始化项目\n\n```bash\n# 基本用法\nnovelwrite init my-novel\n\n# 在当前目录初始化\nnovelwrite init --here\n\n# 预装插件\nnovelwrite init my-novel --plugins authentic-voice\n```\n\n### 3. 在 Claude Code 中开始创作\n\n在 Claude Code 中打开项目，使用斜杠命令：\n\n```text\n/constitution    # 1. 创建创作宪法\n/specify         # 2. 定义故事规格\n/clarify         # 3. 澄清关键决策\n/plan            # 4. 制定创作计划\n/tasks           # 5. 分解任务清单\n/write           # 6. AI 辅助写作\n/analyze         # 7. 质量验证分析\n```\n\n## 🎨 Agent Skills 自动激活\n\n### 类型知识库（Genre Knowledge）\n\n当你提到特定类型时，相应的知识库会自动激活：\n\n- 💕 **Romance** - 言情小说惯例和情感节奏\n- 🔍 **Mystery** - 推理悬疑技巧和线索管理\n- 🐉 **Fantasy** - 奇幻设定规范和世界构建\n\n### 写作技巧（Writing Techniques）\n\n写作过程中自动应用最佳实践：\n\n- 💬 **Dialogue** - 对话自然度和角色声音\n- 🎬 **Scene Structure** - 场景构建和节奏控制\n- 👤 **Character Arc** - 角色弧线和成长逻辑\n\n### 智能检查（Quality Assurance）\n\n后台自动监控，主动提醒问题：\n\n- ✅ **Consistency Checker** - 一致性检查（角色、世界观、时间线）\n- 🧭 **Workflow Guide** - 引导使用七步方法论\n\n## 📚 Slash Commands\n\n### 七步方法论\n\n| 命令 | 功能 | 输出 |\n|------|------|------|\n| `/constitution` | 创建创作宪法 | `.specify/memory/constitution.md` |\n| `/specify` | 定义故事规格 | `stories/[name]/specification.md` |\n| `/clarify` | 澄清模糊点（5个问题） | 更新 specification.md |\n| `/plan` | 制定创作计划 | `stories/[name]/creative-plan.md` |\n| `/tasks` | 分解任务清单 | `stories/[name]/tasks.md` |\n| `/write` | 执行章节写作 | `stories/[name]/content/chapter-XX.md` |\n| `/analyze` | 质量验证分析 | 分析报告（双模式：框架/内容） |\n\n### 追踪与验证\n\n| 命令 | 功能 |\n|------|------|\n| `/track-init` | 初始化追踪系统 |\n| `/track` | 综合追踪更新 |\n| `/plot-check` | 情节一致性检查 |\n| `/timeline` | 时间线管理 |\n| `/relations` | 角色关系追踪 |\n| `/world-check` | 世界观验证 |\n\n## 🔌 插件系统\n\n### 安装插件\n\n```bash\n# 列出可用插件\nnovelwrite plugin:list\n\n# 安装插件\nnovelwrite plugin:add authentic-voice\n\n# 移除插件\nnovelwrite plugin:remove authentic-voice\n```\n\n### 官方插件\n\n- **authentic-voice** - 真实人声写作插件，提升原创度和生活质感\n- 更多插件开发中...\n\n## 📖 项目结构\n\n```text\nmy-novel/\n├── .claude/\n│   ├── commands/       # Slash Commands\n│   └── skills/         # Agent Skills\n│\n├── .specify/           # Spec Kit 配置\n│   ├── memory/\n│   │   └── constitution.md\n│   └── templates/\n│       ├── scripts/    # 命令行脚本工具\n│       │   ├── bash/\n│       │   └── powershell/\n│       ├── commands/\n│       ├── knowledge/\n│       └── ...\n│\n├── stories/\n│   └── 001-my-story/\n│       ├── specification.md\n│       ├── creative-plan.md\n│       ├── tasks.md\n│       └── content/\n│           ├── chapter-01.md\n│           └── ...\n│\n├── spec/\n│   ├── tracking/       # 追踪数据\n│   │   ├── plot-tracker.json\n│   │   ├── timeline.json\n│   │   ├── character-state.json\n│   │   └── relationships.json\n│   │\n│   └── knowledge/      # 知识库\n│       ├── characters/\n│       ├── worldbuilding/\n│       └── references/\n│\n└── README.md\n```\n\n## 🆚 与 novel-writer 的关系\n\n| 特性 | novel-writer | novel-writer-skills |\n|------|-------------|-------------------|\n| **支持平台** | 13个AI工具（Claude、Cursor、Gemini等） | Claude Code 专用 |\n| **核心方法论** | ✅ 七步方法论 | ✅ 七步方法论 |\n| **Slash Commands** | ✅ 跨平台命令 | ✅ Claude 优化命令 |\n| **Agent Skills** | ❌ 不支持 | ✅ 深度集成 |\n| **智能检查** | ⚠️ 手动执行 | ✅ 自动监控 |\n| **类型知识库** | ⚠️ 需手动查阅 | ✅ 自动激活 |\n| **适用场景** | 需要跨平台支持 | 追求最佳体验（Claude Code） |\n\n**选择建议**：\n\n- 如果你使用多个AI工具 → 选择 **novel-writer**\n- 如果你专注 Claude Code → 选择 **novel-writer-skills**\n\n## 🛠️ CLI 命令\n\n### 项目管理\n\n```bash\n# 初始化项目\nnovelwrite init <project-name>\n\n# 检查环境\nnovelwrite check\n\n# 升级项目\nnovelwrite upgrade\n```\n\n### 插件管理\n\n```bash\n# 列出已安装插件\nnovelwrite plugin:list\n\n# 安装插件\nnovelwrite plugin:add <plugin-name>\n\n# 移除插件\nnovelwrite plugin:remove <plugin-name>\n```\n\n## 🔧 命令行脚本（可选）\n\n除了 Claude Code 中的 Slash Commands，项目还包含命令行脚本工具：\n\n### 脚本位置\n\n初始化项目后，脚本位于：`.specify/templates/scripts/`\n\n```text\n.specify/templates/scripts/\n├── bash/          # macOS/Linux 脚本\n└── powershell/    # Windows 脚本\n```\n\n### 使用场景\n\n- ✅ **命令行替代** - 在终端中直接执行七步方法论\n- ✅ **自动化工作流** - 集成到 CI/CD 或批处理脚本\n- ✅ **批量操作** - 处理多个故事或批量检查\n- ✅ **独立使用** - 不依赖 Claude Code 的场景\n\n### 快速示例\n\n**macOS/Linux:**\n\n```bash\n# 创建宪法\nbash .specify/templates/scripts/bash/constitution.sh\n\n# 定义规格\nbash .specify/templates/scripts/bash/specify-story.sh\n\n# 追踪进度\nbash .specify/templates/scripts/bash/track-progress.sh\n```\n\n**Windows:**\n\n```powershell\n# 创建宪法\n.\\.specify\\templates\\scripts\\powershell\\constitution.ps1\n\n# 定义规格\n.\\.specify\\templates\\scripts\\powershell\\specify-story.ps1\n\n# 追踪进度\n.\\.specify\\templates\\scripts\\powershell\\track-progress.ps1\n```\n\n### 可用脚本\n\n所有 Slash Commands 都有对应的脚本版本：\n\n| 脚本 | 功能 | 对应命令 |\n|-----|------|---------|\n| `constitution` | 创建创作宪法 | `/constitution` |\n| `specify-story` | 定义故事规格 | `/specify` |\n| `plan-story` | 制定创作计划 | `/plan` |\n| `track-progress` | 追踪进度 | `/track` |\n| `check-consistency` | 一致性检查 | - |\n| 以及更多... | 查看 `.specify/templates/scripts/README.md` | - |\n\n📖 **详细文档**：[scripts/README.md](templates/scripts/README.md)\n\n### 何时使用脚本 vs Slash Commands\n\n| 场景 | 推荐方式 |\n|-----|---------|\n| 日常创作、需要 AI 协助 | ✅ Slash Commands (优先) |\n| 批量处理、自动化 | ✅ 命令行脚本 |\n| CI/CD 集成 | ✅ 命令行脚本 |\n| 快速检查验证 | ✅ 命令行脚本 |\n\n## 📚 文档\n\n- [入门指南](docs/getting-started.md) - 详细安装和使用教程\n- [命令详解](docs/commands.md) - 所有命令的完整说明\n- [Skills 指南](docs/skills-guide.md) - Agent Skills 工作原理\n- [脚本工具集](templates/scripts/README.md) - 命令行脚本使用指南\n- [插件开发](docs/plugin-development.md) - 如何开发自己的插件\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n项目地址：[https://github.com/wordflowlab/novel-writer-skills](https://github.com/wordflowlab/novel-writer-skills)\n\n## 📄 许可证\n\nMIT License\n\n## 🙏 致谢\n\n本项目基于 [novel-writer](https://github.com/wordflowlab/novel-writer) 的方法论，专为 Claude Code 深度优化。\n\n---\n\n**Novel Writer Skills** - 让 Claude Code 成为你的最佳创作伙伴！ ✨📚\n",
  "bytes": 6064,
  "sha": "115d2432f9672a129504b03939816ffc7d74fac4374b73d1329dcd6709d0e26c",
  "repo_slug": "wordflowlab/novel-writer-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_wordflowlab_novel_writer_skills_novel_wr_54e77611/readme"
}