writers-helper 是一个写作辅助技能，旨在帮助一位写作者或一个写作项目从想法走向出版。它是对经典写作技法教学的整合，覆盖写作的各个阶段：规划、研究、起草、修订、创作瓶颈、写作提示、习惯养成，以及商业层面（提案、查询信、经纪人、出版商、交易）。
用途
该技能适用于小说或非虚构写作，帮助写作者完成从构思到提交出版的完整生命周期。它不处理文档格式转换或打包（如 Word、PDF、PowerPoint、Excel、EPUB），也不用于技术或商业文档写作、纯语法拼写查询、EPUB 电子书任务，或与具体写作项目无关的通用创意/生活辅导。
主要能力
技能提供四种工作模式：
- 规划者：用于启动项目，需要前提、大纲、世界构建、研究计划。
- 教练：用于遇到瓶颈、注意力分散或建立习惯时，提供提示和练习。
- 编辑：已有草稿，需要批评、修订轮次、行编辑、校对。
- 商业伙伴：处理查询信、提案、经纪人、出版商、交易、投稿。
技能还提供阶段路由，覆盖从创意到前提、规划、研究、起草、受阻、修订、润色、提交的各个阶段，并指向相应的参考文档和模板。
参考文档包括：工作流与规划、技法与结构、散文与风格、起草与过程、编辑与修订、瓶颈与提示、习惯与生活方式、出版与职业、体裁与格式、陷阱与解决方案。
模板均为可填写的工作表，内置指导，包括：前提画布、故事大纲、场景骨架、角色档案、世界构建问卷、会话计划、批评清单、修订计划、提示卡、图书提案、查询信、梗概、投稿日志。
使用方式
技能通过参考文档、模板和脚本协同工作。使用前需先阅读相关参考文档，脚本支持工作流但不替代参考文档中的技法判断。
五个 Python 3 脚本（仅标准库，非交互式，部分支持 --json）：
- scripts/writing-prompt.py：生成位置感知的三部分提示集（肯定、情节元素、写作任务），支持 --position、--count、--seed、--json。在教练模式下，诊断故事所处结构位置后使用。示例：python3 scripts/writing-prompt.py --position halfway --count 3
- scripts/session-planner.py：规划定时写作会话，包括区块、休息、每区块字数目标、流冲刺节奏，支持 --target-words/--minutes/--words-per-hour 和 --json。在起草会话开始时使用。示例：python3 scripts/session-planner.py --minutes 90 --target-words 1200
- scripts/manuscript-stats.py：分析稿件文件，提供编辑信号：字数、句子统计、被动语态、副词密度、填充词、可读性、每章节奏，支持 --chapter-regex、--json。在编辑模式下，修订轮次前后使用。示例：python3 scripts/manuscript-stats.py manuscript.txt --json
- scripts/habit-log.py：记录每次写作会话（日期、字数、分钟、精力，通过 --log），并通过 --report 报告日/周/月进度和连续记录；状态保存在 JSONL 日志中（--file）。在建立可持续写作习惯时，每次会话后使用。示例：python3 scripts/habit-log.py --log 2026-08-08 850 45 4 --report week
- scripts/submission-tracker.py：追踪查询和提案（标题、目标、类型、发送日期、状态、备注，通过 --add；字段编辑通过 --update），并通过 --list/--status 报告管道，标记超过 --follow-up-days 的跟进。在提交模式下全程使用。示例：python3 scripts/submission-tracker.py --add "The Glass Orchard" "Agent Name" query 2026-08-08 sent --list
适用场景
适用于单个写作者或单个写作项目的全流程管理，包括构思、规划、研究、起草、修订、润色、提交和出版商业事务。也适用于遇到创作瓶颈、需要写作提示或练习、建立写作习惯、追踪投稿进度等场景。
限制
- 脚本仅测量和结构化，不做判断。统计会标记被动语态和节奏，但修订决策仍取决于编辑模式的判断，不能让指标凌驾于作者声音之上。
- manuscript-stats.py 只能分析纯文本，无法打开 .docx/.epub 文件或查看格式。
- habit-log.py 和 submission-tracker.py 是单用户本地工具，无同步或多用户感知；如果多人共用路径，需将 JSONL 文件移出共享路径。
- 生成的提示是位置感知模式，不是定制情节建议，需结合故事的实际前提和角色使用。
- 诊断循环（瓶颈、结构问题）最多进行三次不收敛的尝试后停止，并报告证据和选项，而不是让写作者空转。
- 前提条件：Python 3 标准库（五个脚本均无需外部包、API 密钥或服务）；manuscript-stats.py 需要纯文本稿件文件；habit-log.py 和 submission-tracker.py 需要可写的 JSONL 状态文件（默认在工作目录，可通过 --file 指定）。
- 完成和退出条件：交付所请求的产物（大纲、草稿、修订轮次、查询信、提案、投稿列表或完成的会话计划）；当写作者已在无干预下成功时，确认当前方法足够；诊断循环最多三次不收敛后停止并报告。