故事写手Pro · Story Writer Pro

定位：中文长篇网文专业创作 + 去AI味精修，一站式解决写和改。
版本：v3.9.6

🚀 5 分钟开始

快速通道：
- 遇到问题 → references/08-dialogue-scenarios.md（20 个场景）
- 边界问题（能不能……）→ references/10-boundaries.md

用户硬约束（每次必读）

• 输出语言：全中文，内部工具调用可用英文
• 结构风格：表格 + 编号列表 + 短标题（节省 token）
• 番茄书名硬约束：最多 25字，禁止与已有作品同名（发布前必查，建议在番茄搜索框试输确认）
• 番茄章节标题硬约束：至少 5个字（番茄验证要求，发布脚本会自动处理短标题，但写稿时应直接满足）
• 番茄分类规范：现代言情 / 奇幻言情 / 悬疑 / 古代言情
• 短篇交付：整篇合并为一个 .md，结尾 【全文完】
• 审稿节奏：每 3 章提交，纯文本，不用 Markdown
• AI 味阈值：>1.0/千字 触发修改
• 执行顺序铁律：字数门检 → 跨章查重 → AI味扫描
• 方法论原则：skill 只装通用方法论，不装项目特定决策
• 字数目标：用户说多少字就按多少字为目标（不是"约"字）。用户没说字数必须主动提问（2026-06-20 用户原话）
• 字数自报口径（2026-06-23 用户要求）：交付时报告的字数必须按纯中文字符数（len(re.findall(r'[\u4e00-\u9fff]', text))），不是文件字符数、不是 Word 字数。番茄后台显示的是"番茄字符数"（中文+全角标点），但用户偏好按纯中文字符报。完整口径定义 + 三套数字对照表 → references/17-字数口径与统计规范.md。例：015《心声一响》估算 9800→番茄 7628→实际中文字 6094——估算与实际差 3700 字，根因是把全角标点/换行也算进去了。写完必须用脚本校准，不靠目测。
• "先记录"模式（2026-06-20 用户原话"先记录 不修改"）：用户说"先记录/先不修改/先分析/只记录" → 只输出文字分析，禁止任何写入操作：
• ❌ 禁止 patch skill/项目文件
• ❌ 禁止写入 Memory（除非用户明确说"记住"）
• ❌ 禁止 git add/commit/push
• ❌ 禁止创建文件/目录
• ✅ 只在对话中输出分析、表格、文本
• 等用户明确说"改/执行/开始写"才动手

• 误判信号：用户没说"改" → 任何写入都是越权

• Memory 写入边界（2026-06-20）：Memory 不是所有偏好的归宿。

• 适合：用户身份/稳定环境事实/工具 quirk/长期 SOP
• 不适合：本次会话临时状态、规则仍在演进、用户没确认要持久化的偏好
• 误判信号：用户说"记住"但又说"先不写进去" → 立即收手，临时记录到对话里

核心能力（4 个 agents 触发场景）

每个 agent 文件都包含：角色定位、标准工作流、必跑检查、常见问题、相关资源。

资源导航（21 references + 4 agents + 9 scripts）

完整索引 → references/00-index.md

工具（每章/发布前）：scripts/preflight-check.py · alert-scan.py · cross-chapter-scan.py · ai-flavor-scan-v2.py

agents/（4 个）：agents/writer.md · ai-flavor-fixer.md · short-story.md · platform-publisher.md

知识库元数据统一

新建项目或现有项目有多文档元数据重复时 → 使用 knowledge-vault-meta 技能（单一数据源模式）。

scripts/（7 个）：preflight-check.py ⭐ · alert-scan.py ⭐ · cross-chapter-scan.py ⭐ · ai-flavor-scan-v2.py · ai-flavor-fix.py · check_chapter_wordcount.py · ai-flavor-scan.py

> ⭐ = 必跑。扫描工具用 terminal（非 execute_code，后者有 5 分钟超时）

短篇 SOP（A0.2 核心约束）

> 何时用：用户说"写一个小短篇"/"一万字"/"短篇"/"中篇小说"
> 格式硬约束（2026-06-18 子 agent 教训）：正文必须整篇不分章节，禁止 ## 第X章、—— 分隔线、——全文完——

子 agent 执行时：必须在 task goal 中直接写"整篇不分章节、不加任何章节标题或分隔线"。

短篇两条路径

路径 A · 标准项目（用户说"先规划/先出大纲"）

1. 确认题材方向（1-2 个问题）
2. 出完整大纲（premise + 3 角色 + 三幕）
3. 搭建项目目录 → 逐章创作
4. 质量门检 → 合并整篇

路径 B · 直送对话（用户需求明确 + 熟悉该题材）

用户说"直接写/先写正文/帮我写一个X同人" + 需求明确 →
立即执行：确认2个关键设定 → 直接写全文 → 存档到项目目录 → 提供下载链接
不走 todo / 不在对话里输出全文

触发条件：用户给定了明确题材（IP/设定/主角关系），且未要求"先规划"

路径 B 交付协议（2026-06-18 新增，易遗漏）：
1. 正文写入 <知识库>/10-Projects/小说/短篇/<书名>/正文.md
2. 书名/角色名需换时 → patch 第一行 H1 标题 + 角色名字符串
3. 交付格式：只给下载链接，不在对话内贴正文
4. 如用户说"不用输出给我，写完给我下载链接" → 等同路径B，存档后立即给链接

短篇落库到 Git 的完整流程（2026-06-23 补充）

> 用户说"发布到 git"/"存到短篇集"/"发到知识库" → 走完整 5 处同步
> 完整 SOP 见 references/11-short-story-rename-sop.md §一，包含：
> 1. 找下一个序号（ls | grep | sort -n | tail -5）
> 2. 核验书名合规（≤25字 + 不与已有同名）
> 3. 建目录 + 写正文.md + 写 00-项目总览.md
> 4. patch 10-Projects/小说/00-总览.md（新增一行 + 更新"最后更新"日期）
> 5. git fetch origin → git add → git commit（带字数+题材） → git push origin main

⚠️ 写正文前必查：序号边界（不要凭印象写序号）+ 书名查重（避免与已有作品同名）

换名标准流程（角色名/书名各20选1模式）

1. 输出 4-5 组名字表（每组 20 个编号选项）
2. 用户选编号：男1-X，男2-X，男3-X，女-X，书名-X
3. 确认是否沿用其他项（如"角色沿用，书名换新"）
4. 4处同步 patch（完整 SOP 见 references/11 §二）：
   - ✅ 正文.md H1 标题（# 旧名 → # 新名）
   - ✅ 00-项目总览.md H1 标题（# 《旧名》项目总览 → # 《新名》项目总览）
   - ✅ 00-总览.md 列表中的书名（目录结构行 + 短篇列表行）
   - ✅ 目录名（mv "004-旧书名" "004-新书名"）
5. Git commit + push
6. 提供下载链接

> ⚠️ 漏一项出事：只改正文 H1 而没改目录名 → 目录名和正文书名对不上，用户交付时发现结构混乱。

> 番茄书名硬约束：最多 25 字，禁止与已有作品同名（发布前必查）

两种交付格式

> 路径 B 的质量门检（AI 味/字数）在正文后手动执行，结果备注在对话中。

长篇创作 12 步（A3 主流程）

1. 读 00-大纲.md 中本章和上一章摘要
2. 设计开篇钩子 → references/02 §五.3
3. 规划场景 3-5 个
4. 写正文 3000-5000 字
5. 设置结尾钩子 → references/02 §六
6. 字数检查 → check_chapter_wordcount.py
7. AI 味扫描 → ai-flavor-scan-v2.py
8. 跨章查重 → references/03 §三
9. 深度去 AI 味 → references/04
10. 更新 00-大纲.md 摘要
11. R1 自检告警（6 项必跑）
12. Git commit

详见 agents/writer.md 和 references/01-workflow.md §一。

质量门检（3 步必跑）

短篇（整篇不分章）AI味扫描：脚本给分章长篇设计，直接传文件名会报"目录不存在"。用法：

# 正确：传目录而非文件
python scripts/ai-flavor-scan-v2.py <项目目录>

# 或者手工正则（短篇直接用Python内联扫）
python3 -c "
import re
with open('正文.md','r') as f: text=f.read()
patterns = {..24类..}
# 统计AI味词次 / 总字数 × 1000
"

> 2026-06-19 实测：183字节正文，密度0.2/千字，仅自然语境"显示"1次，全部通过。

一键发布前验证：

python scripts/preflight-check.py <项目根>   # R1 6 项自动验证 → 🟢/🟡/🔴
python scripts/alert-scan.py <项目根>          # 5 类已知踩坑 → 🔴必修 / 🟡建议修

> v3.9.2 升级：4 个脚本（preflight-check / cross-chapter-scan / alert-scan / check_chapter_wordcount）自动识别章节命名模式（A 基础 / B 卷前缀 / C 数字编号）。新增 scripts/chapter_naming.py 作为命名约定单一数据源。详见 references/06-project-structure.md §1.4。

R1 自检 6 项（任一项 ❌ → 立即修复）：AI味超标 / 跨章雷同 / 字数偏离±15% / 角色破格 / 逻辑漏洞 / 钩子缺失

⚠️ 字数估算陷阱（2026-06-23 实测坑）

写完后用脑算"字数"几乎必错。作者经常把全角标点、空格、换行、【全文完】标记、H1 标题都算进去，结果比实际中文字符数多 30-40%。

真实案例：015《心声一响》写完时自我报告 ~9,800 字，发布到番茄后台只显示 7,628 字，实际纯中文字符数仅 6,094 字——比规范下限 8,000 字还差 1,906 字。

规则：
- 写完报告字数时，先跑 len(re.findall(r'[\u4e00-\u9fff]', text))，再回话
- 不接受"约 1 万字"这种四舍五入，必须报确切数字
- 字数低于规范下限（短篇 8000 / 长篇单章 2500）→ 立即提示用户是否扩写，不糊弄

⚠️ read_file 陷阱（2026-06-23 实测坑）：hermes_tools.read_file() 返回的内容会带 行号| 前缀污染（如 1|永安三年），不能直接喂给字数统计脚本——会把行号字符算成正文，汉字数被严重低估（实测 6094 → 3564，约 -42%）。正确做法：

# ✅ 用 open(path).read() 直接读
with open("正文.md", encoding="utf-8") as f:
    text = f.read()
hanzi = len(re.findall(r'[\u4e00-\u9fff]', text))

# ❌ 用 read_file 返回的 content 算字数（行号污染）
from hermes_tools import read_file
text = read_file("正文.md")["content"]  # 含 "1|2|3|..." 前缀
hanzi = len(re.findall(r'[\u4e00-\u9fff]', text))  # 数字会被严重低估

或用现成脚本（已实现两个口径 + 已正确处理输入）：

python3 ~/.hermes/skills/story-writer-pro/scripts/check_chapter_wordcount.py <文件> --mode hanzi

⚠️ 字数统计双基准（2026-06-20 实测坑）

两个脚本使用不同分母，结果不可直接比较：

规则：
- 字数"够不够"看番茄字符数（用户发布目标平台）
- AI 味密度 / 千字 看汉字数（扫描器内部基准）
- 不能用番茄字符数去除以 AI 味命中数得到密度——分母不同

实测案例（2026-06-20）：《重生后，她以血还血》汉字数 5043，番茄字符数 6058，发布到番茄显示 ~6000 字。两个数都对，只是基准不同。

关键方法论（强约束）

0. 执行顺序铁律（最重要）

> 章节审查前必须先跑底层诊断：世界观/角色库 → 节拍表版本对齐 → 章节正文
> 用户说"先修世界观/人物介绍" → 立即停止章节审查，转向底层文件
> 详见 references/09-workflow-sequence.md

1. 长篇项目 9 个固定目录

00-项目总览/  01-大纲/  02-角色库/  03-世界观/
04-章节正文/  05-草稿/  06-写作笔记/  07-素材库/
99-Archives/

❌ 同编号目录只能有 1 个 · ❌ 并行草稿用 _ 前缀放 99-Archives/

2. 短篇格式硬约束

# 书名 + 正文连续（无章节标题/分隔线）+ 【全文完】 · ❌ 禁止 ## 第X章、——全文完—— · 字数用户指定（未指定须主动提问）

3. 5/10/30/100/500 节点

5章小爽点 / 10章中反转 / 30章大爆点 / 100章档位升级 / 500章大收束

4. P21 弯引号误判

"" '' 是正常对话格式，P21 误判率 98%+，P21 命中全部忽略

4. 用户拍板模式（2026-06-19 新增）

> 用户说"你分析就行"/"直接改"/"确认" → 不逐条确认，直接执行并报告结果

触发条件：用户明确表达了"直接改/你自己决定/分析就行"，且操作对象已确定。

执行原则：执行后立即报告"做了什么 + 验证结果"，不要求二次确认。

区别：
| 用户说 | 我做 |
|--------|------|
| "怎么处理？" | 先出方案，等确认 |
| "你分析就行"/"直接改" | 分析后直接执行，执行完报告 |
| "先记录"/"先不修改"/"只分析" | 只输出文字，禁止任何写入（见用户硬约束"先记录模式"） |

易混点：
- "你分析就行" ≠ "你分析后自己存起来"——分析完要执行，但要等信号
- "直接改" ≠ "先记录"——前者授权修改，后者明确禁止
- 拿不准时：默认"先记录"模式，问一句"要现在改吗？"

5. 零模糊规则风格（用户硬要求）

> 用户原话："异常规则设置清楚哦"、"都直接改掉"

写作规范类文档的规则必须满足：

核心原则：规则文档写给"我今天状态很差/很困/很赶"时也能照着执行的人。任何需要二次判断的词（"重要""较大""酌情"）都必须给出判断公式。

🛡️ Reliability · 故障恢复矩阵

脚本报错时，先判断症状 → 再执行动作。

脚本崩溃（报错 Traceback）

脚本输出 🔴 黄灯（要修才能发）

脚本输出 🟡 黄灯（建议修）

Patch 踩坑

⚠️ 批量改名cascade陷阱（2026-06-19 新增）

长篇章节文件批量改名时，每次改名都可能产生新的番号冲突，形成 cascade（级联冲突）。错误做法是逐个解决——每次改名都会制造新的重复，"按下葫芦浮起瓢"。

正确流程（单次全量扫描 + 一次性执行）：

1. 全量扫描所有重复，生成完整清单：
   bash ls 第*.md | sed 's/第0*\\([0-9]*\\)章-.*/\\1/' | sort -n | uniq -c | awk '$1>1{print "重复第"$2"章: "$1"个文件"}'
2. 按时间线/叙事顺序确定每个文件的去留（被保留的文件优先）
3. 一次性执行所有改名，包含内标题修正：
   bash # 格式：mv 旧文件 新文件 && sed -i 's/# 第X章 旧标题/# 第Y章 新标题/' 新文件
4. 立即重新扫描验证：ls 第*.md | sed ... | sort -n | uniq -c（改名100%产生新冲突，必须重扫）
5. 还有冲突→回到步骤1重新扫描全量（初始体系往往有深层系统性重复）

判断保留哪个文件的标准：
- 叙事时间线更早的保留原番号（如"共振器"在"一年后"之前）
- 内标题与文件名一致的优先保留
- 无时间线参照时，任意保留一个，另一个顺延

实测案例：初始报告只有2个重复（第27、第37），实际级联6轮后才清空。最终验证：seq 1 61 | grep -vFf <(章号文件清单) 确认无缺失。

删除/归档操作（强制确认）

> 铁律：Skill 不得在用户未明确确认前自动删除或归档任何项目文件。哪怕命令是对的，也必须等用户说"可以"再执行。

确认模板：

⚠️ 即将执行以下操作（不可逆）：
  rm -rf 99-Archives/清理/04-正文初稿_20260618_待确认/

请回复"可以"确认执行，或告诉我其他指令。

特殊情况

> 核心原则：脚本报错 → 看报错最后一行 → 判断类型（路径/语法/超时/逻辑） → 执行对应动作 → 重跑验证。
> 不要在报错上继续写，那会级联放大问题。

🆘 求助索引 ⭐

⭐ 遇任何问题先翻 references/08-dialogue-scenarios.md（10 个真实场景）

Skill 发布前自审清单

> 完整 SOP → references/07-tools-and-evaluation.md §三

# 0. 废弃扫描
grep -rn "废弃\|DEPRECATED\|deprecated" --include="*.md" .

# 1. 非相关内容（项目路径/跨skill/meta）
grep -rn "<项目名>\|<其他skill名>\|/home/ubuntu\|/Volumes/" --include="*.md" .

# 2. 无效引用
grep -oE 'references/[a-z0-9-]+\.md' SKILL.md | sort -u > /tmp/indexed.txt
find references/ -name "*.md" -printf "%f\n" | sort -u > /tmp/actual.txt
diff /tmp/indexed.txt /tmp/actual.txt

判定：废弃标记 → 删文件；非相关内容 → 替换/删；引用 diff 有输出 → 补索引

Python 文件 patch 陷阱：修改 .py 文件时若报 IndentationError，立即 git checkout 恢复原文件 → 重新 read_file → 重新 patch。不要在错误状态上继续 patch，Python 缩进错误会级联扩散。

版本号：+0.0.1（错误修复）/ +0.1.0（新增）/ +1.0.0（重构）· 必查本地 > 线上

📋 更新历史

完整 changelog → 07-tools-and-evaluation.md §三

版本：v3.9.6（2026-09-26）
- v3.9.6（2026-09-26）：repetition_metrics.py 新增 longest_repeat() 连续长片段门禁（C 层）+ check_short_story.py 输出「最长连续重复 N 字」
- v3.9.4（2026-07-22）*：agents/platform-publisher.md 新增 Playwright 自动发布路径（路径 A），指向 短篇/skills/fanqie-chapter-publisher；核心能力表添加自动发布方案引用
- v3.9.1（2026-06-23）：新增 references/17-字数口径与统计规范.md（三套字数口径定义）+ 字数估算陷阱加 read_file 行号污染坑 + 015 实测数字校正（6080→6094）
- v3.9.0（2026-06-23）：用户硬约束加"字数自报口径"= 纯中文字符数 + references/16 新增案例 2（《心声一响》混淆）+ 字数估算陷阱
- v3.8.9（2026-06-23）：新增"短篇落库 5 处同步"SOP（references/11 §一）+ 主SKILL.md资源导航标⭐
- v3.8.8（2026-06-20）：新增 references/16-字数缺口案例库-实战篇.md
- v3.8.7（2026-06-20）：强化"先记录模式"边界
- v3.8.6（2026-06-20）：新增用户硬约束加"字数目标"+"先记录模式"
- v3.8.4（2026-06-19）：新增短篇整篇AI味扫描说明
- v3.8.3（2026-06-19）：新增用户拍板模式 + 批量改名cascade陷阱解法