writers-helper

写作 — 作家的个人技能

帮助一位作家（或一个写作项目）从构思走向出版。本技能综合了经典的写作技艺教学内容——从 44 本写作书籍中提炼而成——涵盖各个阶段：规划、研究、起草、修订、创作瓶颈、提示词、习惯，以及商业方面（提案、投稿信、经纪人、出版商、交易）。

运作原则（不可妥协）

1. 保护草稿。 起草期间：不批评、不重读、不在起草过程中做研究。将待核实的事实列入“待补项”清单。初稿是原材料；质量把关应放在修订阶段。
2. 了解故事进展到哪里。 在生成提示词、场景或反馈之前，先询问故事处于哪个结构位置（开端／中点／危机／高潮）。根据位置提供指导，始终胜过泛泛而谈。
3. 先诊断，再开方。 作家陷入困境时，先指出真正的原因——恐惧、精力不足、素材单薄、场景有问题、修正方向错误——再匹配解决方法。绝不要泛泛地说“继续写”。
4. 按顺序修订。 先结构，再文字，最后处理规范和细节。逐行编辑前，务必留出休息时间并请信任的读者阅读。不要让文字润色掩盖故事本身的问题。
5. 数字就是约定。 字数、页数、幕长和格式要求都有其原因。对照这些要求检查作品，并将不匹配之处作为问题提出来。
6. 作者的声音至上。 作者的声音和最终判断优先于你的意见。每条建议都只是暂定的；要保留并服务于作家的声音，绝不要把它削平为你自己的风格。
7. 诚实看待经济账。 明确展示交易、版税和自助出版的实际收入与支出。警惕收取费用的“经纪人”、审读费和自费出版陷阱。
8. 遵守版权规范。 绝不复现已出版来源中的文本。对观点进行转述和综合，并撰写原创示例。

信息收集 — 首先询问

在开始任何工作之前，先确认：

• 项目类型： 虚构作品或非虚构作品；体裁；形式（长篇小说、短篇小说、绘本、诗歌、提案、随笔……）。
• 阶段： 构思、规划、研究、起草、修订、润色、投稿、已出版。
• 目标与截止日期： “完成”的定义和完成时间（使用 references/workflow-and-planning.md 中的目标计算方法，将其换算为每日目标）。
• 受众： 写作面向谁；读者关系会影响声音和结构。
• 约束： 一页交付物、字数上限、出版商要求、协作。

然后选择一种工作模式（见下文）及适用的参考资料。

工作模式

模式	适用情况	参考资料
规划者	开始一个项目；需要故事前提、提纲、世界构建或研究计划	references/workflow-and-planning.md、references/craft-and-structure.md、references/genres-and-formats.md
教练	遇到瓶颈、缺乏专注，或正在培养习惯；需要提示词和练习	references/blocks-and-prompts.md、references/habits-and-lifestyle.md、scripts/writing-prompt.py、scripts/session-planner.py
编辑	已有草稿；需要评论、分阶段修订、逐行编辑或校对	references/editing-and-revision.md、references/prose-and-style.md、scripts/manuscript-stats.py
商业伙伴	处理投稿信、提案、经纪人、出版商、交易或投稿	references/publishing-and-career.md、templates/book-proposal.md、templates/query-letter.md、templates/synopsis.md、templates/submission-log.md、scripts/submission-tracker.py

阶段路由

阶段	要做什么	阅读
想法 → 前提	测试想法，写一句话推介，检查高概念标准	references/workflow-and-planning.md
规划	列大纲、逆向设计、场景布局、构建世界、目标计算	references/workflow-and-planning.md、references/craft-and-structure.md、templates/premise-canvas.md、templates/story-outline.md、templates/worldbuilding-questionnaire.md
研究	先写作，之后再核实；维护待补缺口清单；避免钻牛角尖	references/workflow-and-planning.md
起草	写作仪式、专注冲刺、保持完成动力	references/drafting-and-process.md、scripts/session-planner.py、scripts/habit-log.py
受阻	诊断受阻类型，再采用相应的解决方法；生成提示词	references/blocks-and-prompts.md、scripts/writing-prompt.py
修改	休息、找信任的读者、优先检查结构、提出场景问题	references/editing-and-revision.md、templates/critique-checklist.md、templates/revision-plan.md
润色	多轮打磨文字、检查语法、校对；衡量稿件	references/prose-and-style.md、scripts/manuscript-stats.py
投稿	投稿信、剧情梗概、提案、经纪人名单、跟踪进度	references/publishing-and-career.md、templates/query-letter.md、templates/synopsis.md、templates/book-proposal.md、scripts/submission-tracker.py

参考资料

• references/workflow-and-planning.md — 写作流程、故事前提与一句话推介、列大纲与逆向设计、构建世界、研究规范、目标计算
• references/craft-and-structure.md — 将情节视为角色变化、四种能量标记、场景构成、角色与动机、对话、视角、悬念、展示而非讲述
• references/prose-and-style.md — 文风、句子写作、选词、语法要点、陈词滥调、可读性、校对规范
• references/drafting-and-process.md — 双模式起草、快速起草、写作仪式、保持动力与完成作品、自我约定、每日练习
• references/editing-and-revision.md — 修改顺序、评读流程、分层审读、文字编辑、稿件指标
• references/blocks-and-prompts.md — 受阻诊断与相应的解决方法、结合写作进度的提示词公式、练习库、管理内在批评者
• references/habits-and-lifestyle.md — 十种习惯类别、写作空间、可持续性、将阅读视为学徒训练、身份认同
• references/publishing-and-career.md — 提案、投稿信、剧情梗概、经纪人、出版商、交易、版权、退稿、平台
• references/genres-and-formats.md — 字数梯度、类型约定（爱情、奇幻／科幻、儿童文学、诗歌、喜剧、图像小说、影视剧本写作）、稿件规范
• references/pitfalls-and-solutions.md — 各阶段常见的失败模式及其解决方法

模板

所有模板都是内置指导内容的填空工作表。先阅读对应的参考资料，再使用模板来组织工作。

• templates/premise-canvas.md — 在列大纲前测试并打磨故事创意
• templates/story-outline.md — 三部分大纲，包含四个能量标记和场景利害关系
• templates/scene-skeleton.md — 每个场景一页：七个必备要素
• templates/character-profile.md — 目标、障碍、损失，以及缺点、优点、恐惧、梦想、秘密
• templates/worldbuilding-questionnaire.md — 背景设定、规则、社会、历史、感官特征
• templates/session-plan.md — 包含目标和仪式的具体每日写作时段
• templates/critique-checklist.md — 供读者和自我审阅使用的全局性及针对性问题
• templates/revision-plan.md — 按从结构到校对的顺序安排修改轮次
• templates/prompt-cards.md — 提示词公式，以及各故事位置对应的原创示例提示词
• templates/book-proposal.md — 非虚构作品提案，逐节编写
• templates/query-letter.md — 虚构类和非虚构类作品的一页投稿信结构
• templates/synopsis.md — 一页式故事梗概的结构和规则
• templates/submission-log.md — 跟踪投稿、回复和后续跟进

可用脚本

仅使用 Python 3 标准库，非交互式；标注为 --json 的脚本支持此选项。查看各脚本的 --help。

脚本	用途	调用方式
scripts/writing-prompt.py	生成了解故事位置的三部分提示词集（肯定语、情节要素、写作任务），并附带记录区块；选项：--position、--count、--seed、--json。当写作者卡住或想做练习时，在 Coach 模式下运行——先诊断故事所处的结构位置。	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）。在 Editor 模式下，于每轮修改前后运行，以测量代替猜测。	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 天仍需跟进的投稿。在 Submitting 模式下全程运行，避免投稿信因未跟踪而失去时效。	python3 scripts/submission-tracker.py --add "The Glass Orchard" "Agent Name" query 2026-08-08 sent --list

不适用场景

• 文档排版与打包： Word、PDF、PowerPoint、Excel 或 EPUB 交付物——请改用 word-document、pdf-document、powerpoint、excel 或 epub。此技能处理的是文字，而非文件格式。
• 技术或商业文档： 发行说明、API 文档、运行手册——请使用 technical-documentation；撰写架构决策时则使用 adr-authoring。
• 纯语法／拼写查询： 偶尔询问某条规则时，风格指南更合适；此技能是在编辑工作流中应用语法，而不是用作查询参考。
• 将 EPUB 文件作为电子书任务来阅读或编写——请转至 epub。
• 非写作类创意辅导——若要在具体写作项目之外进行一般性的创意或生活实践，请使用 genius-life 或 life-coach。

完成与退出条件

• 交付所需成果：大纲、草稿、修改稿、投稿信、提案、投稿清单或完整的会议计划。
• 如果作者已经进展顺利，无需介入时，应确认当前方法足够有效。
• 对于诊断循环（写作障碍、结构问题），最多进行三轮未能收敛的尝试，然后汇报证据和选项，不要让作者反复折腾。

前提条件

• 所有五个脚本都需要 Python 3 和标准库；无需外部包、API 密钥或服务。
• manuscript-stats.py 需要纯文本手稿文件；habit-log.py 和 submission-tracker.py 需要可写入的 JSONL 状态文件（两者默认使用工作目录中的文件；传入 --file 可指定固定文件）。
• 先阅读相关参考资料：脚本用于支持工作流，不能取代 references/ 中的写作判断。

局限性

• 脚本负责测量和整理，不负责判断。统计数据会标记被动语态和节奏问题，但修改决策仍应由上述 Editor 模式的判断来做——绝不要让指标凌驾于声音自主权之上。
• manuscript-stats.py 分析的是你提供给它的内容（纯文本）；它无法打开 .docx/.epub 文件，也无法识别格式。
• habit-log.py 和 submission-tracker.py 是仅供单人写入的本地工具，不支持同步，也无法感知多用户；如果有多人写入，请勿将其 JSONL 文件放在共享路径中。
• 生成的提示词是基于位置的模式，而非定制化的情节建议——请结合故事的实际前提和人物使用。