naruto-author

name	naruto-author
description	火影忍者同人长篇小说全流程创作技能。支持自然语言触发，例如“帮我打磨大纲”“改纲推演”“确认采用这个改纲”“查看剧情债”“继续写下一章”“查一下神威”“审核这一章”；用于开书初始化、人物卡、蝴蝶效应推演、资料库查询、章节续写、暗部审核、修稿和百万字连载一致性维护；适配轻松快乐向、二创向、系统文，重点防止角色底层动机断裂、战力崩坏、设定魔改、注水剧情、无脑黑原著、情绪空转和伏笔遗忘。

Naruto Author - 火影同人长篇创作技能 v1.5.0

本 Skill 面向 Claude Code / Codex / 其他本地代码代理 通用。.claude/commands/*.prompt 是 Claude 风格快捷入口；Codex 或其他代理可直接读取 AGENTS.md，并调用 scripts/ 下的同一套 Python 工具。

0. 自然语言优先触发

用户不需要记命令。只要用中文描述意图，代理应自动映射到底层脚本和工作流；只有在会写回正式记忆时才要求人工确认。

用户自然语言	应触发的流程
“帮我打磨大纲”“优化主线”“这段大纲不对，帮我重构一下”	读取 00_memory，运行 outline_manager.py propose，生成改纲提案包，不直接写回
“改纲推演：如果让带土活下来”“推演纲手提前入场的影响”	执行 /改纲推演 逻辑，列出失效原著锚点、人物动机变化和下游剧情债
“确认采用这个改纲”“按这个方案写入大纲”	先修改 novel_plan.md / story_graph.json / novel_state.md，再运行 outline_manager.py record 留痕
“查看剧情债”“现在大纲版本是多少”“还有哪些改纲没偿还”	运行 outline_manager.py status，必要时读取 story_graph.json.downstream_obligations
“继续写下一章”“续更”“按当前大纲写第 N 章”	执行 /继续连载 闭环，生成 Beat、写作包、正文和审核包
“查一下神威”“这个忍术能这么用吗”“第八班相关设定”	使用 query_db.py search 或 query_db.py mentions
“审核这一章”“看看有没有毒点”	运行 orchestrator.py audit --mode auto，由 DeepSeek 暗部审核官优先生成毒点报告

默认策略：自然语言触发优先；命令行只作为可审计、可复现的底层执行方式。

⚔️ 忍界铁律 (Style Guardrails)

本书是轻松快乐向、二创向、系统文。审核时守住底层逻辑，不把所有喜剧化偏移都判成毒点。详细标准以 prompts/anti-patterns.md 为准，摘要如下：

⛔ 第一铁律：守住角色根子，允许有限风格化

• 禁的不是“偏”，而是角色底层欲望、长期执念、行为逻辑断裂，或为了服务主角而降智。
• 允许鸣人更会耍宝、卡卡西更黑色幽默、三代更像老油条管理者、佐助更早显出别扭、自来也保留好色取材外壳。
• 口头禅和称呼可以少量保留或中文化处理；毒点是机械堆砌罗马音/日式尾巴，或把角色写成单一标签。

⛔ 第二铁律：系统可以爽，但战力不能失控

• 系统奖励可以离谱、反差可以好笑，但必须有条件、代价、冷却、误用风险或成长门槛。
• 外挂提供优势和新解法，不能代替查克拉基础、战斗经验、情报判断和现场选择。

⛔ 第三铁律：跨体系能力要接进忍界规则

• 外来能力可以先用后解释，通过旁人观察、误判、研究和拆解分步揭示。
• 最终必须能与查克拉、自然能量、封印术、血继、忍具、灵魂或时空间规则接轨，不能无视忍界法则硬覆盖。

⛔ 第四铁律：每章必须有有效内容，不要求每章强推主线

• 有效内容包括主线推进、关系变化、世界观信息自然揭示、伏笔埋设、角色形象强化、笑点与情感记忆点。
• 日常、小任务、误会、制度梗都允许，只要写完后留下变化或后续回收点。

⛔ 第五铁律：少讲说明书，多让信息从互动里长出来

• 设定信息可以拆进对话、误会、战斗反馈、任务文书、暗部报告或系统提示。
• 不要连续贴百科式旁白，也不要让主角在心里背资料库。

⛔ 第六铁律：玩梗是资产，但必须从处境里长出来

• 允许人物关系梗、制度梗、误会梗、信息差梗和主角内心现代吐槽。
• 禁止在生死场面硬插段子、让原著角色说现代网络流行语、或一章反复靠同一个梗撑场面。

⛔ 第七铁律：情绪轻量、具体、别空转

• 情绪由事件、互动、误会和选择推动；少说抽象情绪，多写动作、物件、视线、停顿和对话潜台词。
• 不机械用“500 字几次”判高压线；真正要打回的是同一情绪无新事件支撑地反复重说。

1. 核心命令表

命令	功能描述	适用场景
/一键木叶	引导用户完成“开书五要素”，自动生成大纲锚点和初始知识图谱，并关联 naruto_fanfic_db 原著锚点。	第一次开项目
/忍界推演	根据主角设定，结合 pre_main_timeline 和 canon_plot 推演原著锚点、主角介入线、反派修正线。	确定大纲主线
/打磨大纲	AI 生成“时间线-势力-场景链”八层改纲提案，人工打磨确认后再写回 novel_plan.md、story_graph.json 并记录版本。	人工精修主线、卷结构、人物关系
/改纲推演	推演某个剧情变动造成的蝴蝶效应、势力响应树、失效原著锚点和下游剧情债。	大幅偏离原著或重构主线前
/构建人物卡	严格根据战力铁律，并校验 jutsus.json 与 characters.json，生成主角或配角档案。	设计主角/配角
/查询资料库	快速检索 naruto_fanfic_db 数据库中的人物状态、忍术代价或崩溃风险。	写作遇到设定模糊时
/继续连载	自动执行单章生产闭环（检索 -> Beat生成 -> 正文撰写 -> 图谱回写）。	日常推进章节
/暗部审核	DeepSeek 暗部审核官对当前章节进行毒点扫描（角色根子、战力溢出、资料库一致性、情绪空转、设定说明文检测）。	写完单章后强制执行
/幻术解除	修复未通过 /暗部审核 的章节，重新生成符合铁律的正文。	审核失败后

1.1 脚本工具入口

优先用脚本处理可重复、可审计的动作，避免每次靠口头记忆重写流程：

# 初始化项目骨架
python .claude/skills/naruto-author/scripts/init_project.py --root .

# 查询资料库
python .claude/skills/naruto-author/scripts/query_db.py risk "卡卡西"
python .claude/skills/naruto-author/scripts/query_db.py jutsu "螺旋丸"
python .claude/skills/naruto-author/scripts/query_db.py search "神威"
python .claude/skills/naruto-author/scripts/query_db.py mentions "鸣人在木叶学习螺旋丸并发现神威痕迹"

# 大纲打磨与改纲版本管理
python .claude/skills/naruto-author/scripts/outline_manager.py --root . propose --request "让纲手提前进入第一卷主线"
python .claude/skills/naruto-author/scripts/outline_manager.py --root . record --summary "纲手提前入场" --request "人工确认采用" --affected-characters "tsunade" --obligation "后续三章承接纲手第一印象" --target-volume "第一卷" --active-from-chapter 4 --due-chapter 6 --blocking
python .claude/skills/naruto-author/scripts/outline_manager.py --root . scope-obligation --id "obligation_id" --target-volume "第二卷" --status deferred --nonblocking
python .claude/skills/naruto-author/scripts/outline_manager.py --root . status --chapter 4

# 生成章节写作包与暗部审核包
python .claude/skills/naruto-author/scripts/orchestrator.py --root . prompt --chapter 12 --beat-file 04_editing/gate_artifacts/chapter_12_beat.md
python .claude/skills/naruto-author/scripts/orchestrator.py --root . context --beat-file 04_editing/gate_artifacts/chapter_12_beat.md
python .claude/skills/naruto-author/scripts/orchestrator.py --root . audit --chapter 12 --chapter-file 03_manuscript/第012章_标题.md --mode auto
python .claude/skills/naruto-author/scripts/orchestrator.py --root . audit --chapter 12 --chapter-file 03_manuscript/第012章_标题.md --mode prompt

# 单章自动修稿最多 2 次，超过后必须人工裁决
python .claude/skills/naruto-author/scripts/revision_loop.py --root . --chapter 12 status
python .claude/skills/naruto-author/scripts/revision_loop.py --root . --chapter 12 bump --reason "暗部审核打回后自动修稿"

# 检查 skill 框架是否仍可用
python .claude/skills/naruto-author/scripts/smoke_test.py

2. 三位一体创作流水线 (The Shinobi Editorial Team)

本技能采用严格的职责分离机制，确保文章逻辑严密且文笔地道：

1. 主笔作家 (Claude Code / Codex)：
   • 每次写前必须加载并读取 naruto_fanfic_db 中的锚点文件（角色生死、忍术代价、尾兽状态）。
   • 负责宏观剧情把控、知识图谱（人物关系/时间线）维护。
   • 负责生成 Beat Sheet (分镜头剧本)，并亲自撰写高质量的中文正文。
   • 擅长画面感描写、高燃战斗分镜描写，彻底消除 AI 翻译腔。
2. 情报顾问 (DeepSeek API)：
   • 专职“中文质询”与脑洞拓展，也是暗部审核的外部模型底座；质询是可选增强能力，审核是长章门禁优先路径。
   • 当遇到复杂的中文语境设定、忍术推演、或需要查阅模糊设定的资料时，可通过项目根目录 .env 中的 DEEPSEEK_API_KEY 调用 DeepSeek 进行快速质询和灵感发散。
   • .env 必须被 .gitignore 忽略；只提交 .env.example 模板。禁止把 API key 写入 Skill 文件、脚本、prompt 或正文产物。
   • 代码使用 python-dotenv 读取 .env。若环境缺少该库，先安装：pip install python-dotenv。
3. DeepSeek 暗部审核官 (DeepSeek API)：
   • 专职“毒点清道夫”与“设定校对”，用于替代 Codex/Claude 对 4000-5000 字长章的完整人工审稿，降低本地代理超时风险。
   • 通过 orchestrator.py audit --mode auto 调用：有 DEEPSEEK_API_KEY 时直接生成 deepseek_audit_report_chapter_*.md；没有 key 时生成 deepseek_audit_payload_chapter_*.md，供人工复制到 DeepSeek 或配置 key 后重跑。
   • 根据《忍界铁律》与 naruto_fanfic_db 原著库扫描正文。提前剧透带土身份、死人复活无逻辑、查克拉消耗不对、角色底层动机断裂、情绪空转压过事件推进、正文不足 4000-5000 字等属于高压线；口头禅略生硬、笑点略密等灰区只给小修建议。
   • Codex/Claude 只负责调度脚本、读取报告和执行修稿，不再默认承担整章长文本审核。
   • 自动修稿最多 2 次。两次后仍不通过，停止重写，输出人工裁决清单。

3. 300万字长篇核心架构 (Million-Word Engineering Architecture)

写几百万字的长篇，单纯靠 Prompt 绝对会崩盘。本技能复刻了顶级长篇流水线的物理级持久化架构。执行 /一键木叶 开书后，必须在当前目录下建立以下绝对结构：

<project-root>/
  ├── 00_memory/                # 动态内存区（每章必读/必写，记录蝴蝶效应）
  │   ├── novel_plan.md         # 全局大纲与锚点进度条
  │   ├── novel_state.md        # 当前最新状态（时间、地点、主角查克拉/受伤状态）
  │   └── story_graph.json      # 知识图谱（记录人物生死、蝴蝶效应节点、忍术开发进度）
  │   └── outline_changelog.md  # 人工确认后的改纲版本记录
  ├── 03_manuscript/            # 小说正文区（第NNN章_标题.md）
  └── 04_editing/gate_artifacts/# 门禁产物区（记录每一章的五步质检报告）
  
# 静态原著数据库：
# - Skill 内置只读源：.claude/skills/naruto-author/naruto_fanfic_db/
# - /一键木叶 会复制一份到项目根目录 naruto_fanfic_db/，后续写作优先读项目副本，且初始化不会覆盖已存在文件。

4. 强制章节闭环：五步质量门禁 (The 5-Step Quality Gate)

单章写作绝不是“一键生成”，而是多步流水线。每次执行 /继续连载，必须严格按顺序执行以下子流程，任何一步失败，⛔ 绝对禁止进入下一章：

• 0. /大纲版本检查：写新章前检查 outline_changelog.md 与 story_graph.json.downstream_obligations。只处理当前卷/当前章节已经到期的剧情债；未来卷、未到期或未归档剧情债不得作为本章打回理由。
• 0.1 /人工打磨大纲：任何主线、卷结构、人物关系、金手指限制或原著锚点的大改，都必须先生成改纲提案，人工确认后再写回正式记忆。禁止 AI 直接覆盖大纲。
• 0.2 /剧情债范围标注：记录剧情债必须写明 target_volume、active_from_chapter、due_chapter 或 status=deferred。没有范围的旧债只作为待归档提醒，不是当前硬约束。
• 1. /剧情检索 (RAG & DB Check)：写前必做。根据本章大纲，从 00_memory 检索当前状态，并从 naruto_fanfic_db 核对本章将出现的角色、忍术和物品是否越界。
• 1.1 /资料库锚点注入：生成章节写作包时，orchestrator.py prompt 会自动把 Beat 与 00_memory 中命中的资料库记录插入【资料库命中锚点】。正文必须逐条遵守这些锚点；若未命中但本章涉及具体设定，先用 query_db.py mentions 或 query_db.py search 补查，改 Beat 后重跑写作包。
• 2. /多步流水线写作：
  • 第一步：从当前小篇章与场景链生成 Beat Sheet (分镜头剧本)，不要用章号硬切代替因果链。
  • 第二步：扩写 Beat (加入火影本土化画面感、低密度情绪呈现与梗，保证 Show, Don't Tell)。
  • 第三步：串联合成 4000-5000 字正文。
• 3. /更新记忆 ⚠️：将本章发生的位置转移、生死判定、查克拉消耗、蝴蝶效应偏移分数提取，写入 novel_state.md 和 story_graph.json。
• 4. /节奏、情绪呈现与一致性审查 ⛔：核对大纲锚点与 DB 原著时间线。死人复活不符合原理、角色知晓了不该知道的情报（如过早得知黑绝）、角色底层动机断裂、情绪空转压过事件推进属于高压线；口头禅略生硬、笑点略密等灰区只给小修建议。
• 5. /校稿与去AI化：消除翻译腔和生硬说教，并确立 📝 作者的话 互动玩梗区。若审核失败，最多自动修稿 2 次；超过后交给人工裁决。

5. 长篇大纲系统：时间线-势力-场景链 (Long-Form Outline Spine)

本 Skill 的大纲系统不以“第几章发生什么”为核心，而以 原著锚点时间轴、势力响应、小篇章弧光、场景链因果 为骨架。章节只是发布包装；幕/场景才是最小推进单位。

5.1 八层大纲输出结构

每次 /忍界推演、/打磨大纲、/改纲推演 必须按以下层级组织方案：

1. 核心故事摘要：一句话主线、50 字摘要、200-300 字摘要、最终主题句。
2. 原著切入与变数定义：精确切入节点、第一处违背原著的关键选择、主角优势/限制/最怕暴露的东西。
3. 原著锚点时间轴：原著锚点、主角知道什么、能做什么、做了什么、没来得及做什么、发酵期、世界线偏移。
4. 蝴蝶效应传播图：直接结果、延迟结果、谁受益、谁受损、谁起疑、谁误判、谁修正计划。
5. 势力博弈图与反派响应树：木叶高层、宇智波、晓组织、黑绝/带土/斑、大蛇丸、外村必须同步推演。
6. 三卷总纲：每卷写卷目标、卷对手、卷中段误判、卷中点逆转、卷末代价、卷后余波，并拆成 3-5 个小篇章。
7. 小篇章纲：每个小篇章写起点状态、当段目标、升级冲突、中点反转、关系变化、阶段性得失、结束状态、收尾钩子。
8. 场景链/幕纲与连载节奏：关键小篇章展开 8-15 个场景；每场写目的、人物、时空、行动、冲突、结果、下一场钩子，并标注爆点、伏笔、误导、反转、追更钩子和情绪承接点。

5.2 时间轴硬约束

• 火影同人必须同时维护三条线：原著时间线锚点、主角介入线、反派修正线。
• 所有重大事件必须落在明确时间锚点上，并标注与原著的偏离方式。
• 若某事件提前或推迟原著节点，必须说明原因、发酵期和后果。
• 不允许第一卷只改一个点、第二卷突然大偏离；中间必须有蝴蝶发酵链和势力响应链。

5.3 场景链优先于章号

• 规划时以“幕/场景”为最小推进单位，而非以章号硬切。
• 小篇章可使用 3-8 章弹性窗口，具体章数由事件复杂度、战斗长度、关系戏密度决定。
• 禁止写“第 N 章必须发生 X”的机械配额；只能写“在某个阶段性篇章窗口内完成对应功能”。
• 前一场的结果必须成为后一场的动机、压力、误判或行动条件。

5.4 情绪链嵌入场景卡

情绪弧线不能只当审查口号。每个关键场景必须显式给出：

• 触发事件：角色看见、听见、失去或误判了什么。
• 外显反应：身体动作、物件处理、停顿、视线、环境注意点或对话潜台词。
• 即时决定：角色当场做了什么选择。
• 结果余波：这个选择造成了什么新局面。
• 余震场景：是否需要在下一场或后续小篇章承接。

5.5 反派响应树

每个重大变动必须同步生成反派与势力响应：

• 最直接受影响者。
• 最晚察觉者。
• 最快反应者。
• 最可能误判者。
• 最大的次生危机。
• 对主角最危险的反制手段。
• 若反派智商在线，下一步最合理行动。

5.6 连载节奏层

每个小篇章都要输出：

• 开局钩子。
• 中段黏性点。
• 至少两次局势升级。
• 一次误判或信息反转。
• 小高潮位置。
• 结尾悬念类型。
• 下一段最想看的问题。

连载钩子必须有信息量，服务场景因果链，不做无意义断章。