deai-write

# `deai-write` — 文章写作（母稿生成） ## When to Use - 已完成大纲（和研究报告），需要生成完整文章初稿 - 按照人设基线写一篇有个人风格的文章 ## Input - `drafts/{日期}/{选题名}/大纲.md`（必需——写作蓝图，包含段落规格、钩子类型、过渡指令、金句植入地图、转发触发器、完读率检查） - `research/{选题名}/研究报告.md`（强烈建议——提供按标签编号的素材库，含信源等级） - `.github/instructions/persona-product-manager-shrimp.instructions.md`（人设基线） ## Output - `drafts/{日期}/{选题名}/草稿-{标题}.md`（含素材溯源表。标题从 `标题方案.md` 排名第 1 的候选标题提取，不可用则使用选题名作为标题） --- ## 核心方法论 deai-write 不是"写文章"，也不是"大纲的执行引擎"，而是**大纲的规格执行器**。大纲不是参考建议——每一条段落的规格（钩子类型、第一句模板、情绪定位、字数占比、金句位置、过渡方式、转发触发器位置、评论区钩子位置）都是必须兑现的硬约束。 write 的任务只有一件：把大纲的规格逐段翻译为可读的正文，每翻译一段就用规格验证卡逐项核验，核验不通过就不进入下一段。 ### 规格执行 vs 自由写作的区别 | 维度 | 自由写作 | 规格执行（本 Skill） | |:---|:---|:---| | 大纲的角色 | 参考建议，可以偏离 | **硬约束，必须逐项兑现** | | 钩子选择 | 觉得什么好就用什么 | 必须用大纲指定的钩子类型 | | 情绪控制 | "这段大概要写这种感觉" | 大纲指定什么情绪，就制造什么情绪 | | 字数控制 | "差不多就行" | 每段目标字数 = 大纲总字数 × 大纲占比，偏差 ≤ ±20% | | 金句位置 | "看情况放在合适的地方" | 大纲指定在哪段哪句，就放在哪段哪句 | | 验证方式 | 写完全篇再检查 | **每段写完后用规格验证卡核验，不通过不进入下一段** | ### 写作的铁律：体感、节奏、取舍 AI 味不是"用 AI 生成才有的"，而是一组文体特征。write 在生成草稿时就要主动避开这组特征。记住三条铁律： | 铁律 | 什么意思 | write 怎么做 | |------|----------|-------------| | **体感优先于信息** | 读者读完一段，先感受到的应该是"一种体验"，不是"一条信息" | 每个段落的第一个句子，不说事实，说感受。数据放在感受之后 | | **节奏优先于结构** | 段落之间的过渡靠语序和停顿完成，不靠"首先/其次/此外" | 全文禁用显式路标词。段间过渡用"不过话说回来""说完了这个，再聊一个"等口语来接 | | **取舍优先于完备** | 该停就停。不说的话比说出来的更有力 | 每个段落写完问自己：删掉最后一句，段落是更好了还是更差了？更好了就删 | --- ## Procedure ### Step 0：确定文章标题（用于输出文件名） 在读取输入文件之前，先确定文章的标题用于命名输出文件： 1. 检查 `drafts/{日期}/{选题名}/标题方案.md` 是否存在（由 `deai-title` 产出） 2. 如果存在： - 解析标题方案的评分表，提取排名第 1 的标题候选 - 从候选标题行提取标题文本（表格第 2 列） 3. 如果不存在或解析失败： - 回退使用 `{选题名}` 作为标题 4. 对标题做文件名安全处理（`{标题}`）： - 替换 Windows 非法字符：`\ / : * ? " < > |` 为 `-` - 替换全角问号 `？`、全角冒号 `：` 为 `-` - 替换全角引号 `""`、空格为 `-` - 连续多个 `-` 合并为单个 - 首尾 `-` 去除 - 截断至 50 个字符（超出部分截断） 5. 将安全处理后的标题存入变量 `{标题}`，后续输出文件名均使用此变量 > **示例**：标题"为什么 OpenAI 急了？Kimi K3 开源戳到了哪根神经" → 安全文件名 `为什么-OpenAI-急了-Kimi-K3-开源戳到了哪根神经` ### Step 1：读取输入文件 从大纲中提取每个段落的**执行规格**（段落骨架章节）： - 钩子类型 + 第一句模板（段1） - 目的 + 情绪定位 - 素材编号（研究报告的标签编号） - 写作提示 - 插入点（精确位置 + 内容 + 作用 + 篇幅） - 过渡指令（段间） 从大纲中提取**质量要求**： - 转发触发器（位置 + 内容 + 预期反应） - 完读率检查项（5 个关键位置） - 金句植入地图（每个金句的位置 + 角色） - 差异化策略（确保写作中不偏离） 从研究报告中提取： - 素材库（按标签编号）：`[钩子]` `[论证]` `[讨论]` `[展望]` `[故事]` `[金句]` - 每条素材的内容摘要 + 信源等级 从个人数据源中提取（动态人设）： - **个人文章库**（`my-articles/`）：扫描所有文章，提取风格指纹—— - 句长指纹：平均句长及分布（用于 Step 3 校准） - 词频指纹：高频词 Top 50（用于 Step 4 人话转换的目标） - 钩子指纹：最常用的钩子类型（用于 Step 2 段落执行时优先选择） - 情绪指纹：情绪温度基线（用于控制全文情绪强度） - 结尾指纹：最常用的结尾模式（用于末段写作） - **灵感笔记本**（`notebook/`）：搜索与当前话题标签匹配的笔记—— - `[story]` 类型：优先作为个人经历插入点 - `[analogy]` 类型：优先用于 Step 5 比喻生成 - `[opinion]` 类型：用于校准全文观点立场 - **个人简历**（`resume.md`）：提取与话题相关的真实信息—— - 公司名、岗位、时间段、项目名称——写入个人经历时用真实信息，不编造 - 具体的数字和成果——可作为 `[论证]` 素材的补充 - 如果 `notebook/` 中 `[story]` 类型笔记不足，用简历中的经历补充 从人设基线中提取： - 禁用词库、常用口头禅、个人经历库、语言风格指南 **⚠️ 人设使用红线（硬约束）**： 1. **不以岗位身份开头**：全文禁止出现"作为一个产品经理""作为PM""做产品的人都知道"等将读者身份限定的句式 2. **经历展示而非身份声明**：个人经历通过故事自然流露（"我在电商行业做了十年"），不通过身份标签声明（"我做了十年产品经理"） 3. **目标读者是"关注科技和商业的人"而非"产品经理"**：写作时假设读者是有商业好奇心的普通人，不是岗位同行。需要解释的概念就解释，不预设背景知识 4. **允许的自然表达**：可以写"我做了个产品""这个设计的问题在于"——因为这些是经历和观察，不是身份标签。判断标准：去掉"产品经理"四个字后，句子是否依然成立？ ### Step 1.3：🧠 作者观点主脑（2026-08-22 确立——正文写的必须是作者的观点） **这是本技能的灵魂约束：正文 = 作者观点 + 证据链，不是网上观点 + 转述。** 执行顺序： 1. **先取主脑**：从研究报告「作者观点底座」章节取核心观点、观点金句、论证偏好、作者语气——这些是**全文的立意原点**。从大纲「作者观点对齐」的段落立论点直接消费。 2. **再配证据**：网络调研的 `[论证]`/`[案例]`/`[数据]` 素材只能用来**支撑作者观点**，不得反过来定义观点。写作时数据服务于立场，立场不被数据带跑。 3. **立场一致性**：正文的任何判断句（特别是段落结论、全文结论、金句）必须能在「作者观点底座」中找到出处或谱系。若某段写出来的结论明显是"网上主流说法"而非作者底座里的立场——**回炉重写该段**。 4. **讨论段原则**：出现"有人说…其实…"时，"其实"后面的才是作者观点，且必须来自底座；网上的"有人说"只作靶子。 5. **作者语气贯穿**：全文语气（毒舌/冷静/愤慨/克制）按底座的"作者语气"统一，不因素材来源而漂移。 6. **notebook 无匹配观点时**：禁止凭空捏造作者立场，先向作者确认（与 deai-daily-pipeline 末尾提问机制联通），确认后再写对应段落。 > **成稿自检**：写完正文逐段问——"这段的立场是作者的吗？删掉网络素材它还成立吗？" 任一"否"→ 重写该段。全文读完应能回答"作者对这件事的真实看法是什么"。 ### Step 1.4：✍️ 作者文风铁律（2026-08-26 确立——观点决定说什么，文风决定"听起来像不像作者"） **灵魂约束：正文不只是"作者的观点"，还得是"作者说出来的话"。** 写作前 Read `notebook/作者风格画像.md`（作者风格数据；方法模板与六层结构定义见 `deai-write/references/作者风格画像卡.md`），按研究报告「作者观点底座·风格画像」与本卡逐项执行。作者人格 = **一个会算账的毒舌老江湖——用数据拆穿叙事、用口语砸实结论、站在弱者一边、嘲讽装腔作势**。 **句级写法规矩（每段写作时对照）**： 1. **反问收束**：每个主要段落/章节结尾，优先用反问句砸实观点（"对得起自己是特斯拉脑残粉的人设吗？""企业凭什么老老实实发薪？"）。反问主体 = 具体名号/利益方，不是抽象的"大家"。 2. **设问-自答**：论证展开处先替读者发问（"为什么敢？"）再自答（"因为毁约成本太低"）——一次一答，不连珠炮。 3. **口语长句一口气说完**：逻辑链完整时允许 40-100 字口语长句（逗号串接），**长句后必须跟一句短断言砸底**（"微软苹果不都量产了吗，最后还是都死了"）。口语连接词用"说白了""结果呢""其实""倒是"，禁用"然而/由此可见/综上所述"。 4. **判断句定章**：关键章节用"XX 不是 YY，是 ZZ"收底（"这不是算法问题，是物理问题"）——这是作者论证的指纹。 5. **毒舌不骂娘**：讽刺用具体名号+俚语（"特斯拉脑残粉""给极客的玩具""吹牛逼"），不脏话、不感叹号轰炸。 6. **敢于点名**：论证落到具体品牌/机构/人物，用公开可核验事实支撑（红线：不情绪化指控）。 7. **清单化归纳**：涉及多维分析时用"X 笔账/X 把尺子/X 个提醒"把账算清楚（三笔账=车企算法账/保险精算账/车主认知账）。 8. **逆向拆解主流**：先立靶"主流说 X"再拆穿"但真相是 Y"——作者永远站在主流叙事的对立面冷静拆解，不跟风不捧场。 9. **反例证伪**：下判断前在心里问"如果我是错的，最可能错在哪？"——用反例（HoloLens/Vision Pro 量产也死）自检后才写定。 10. **第一人称判断**：关键结论用"我的判断/我偏量产派/等订单披露再欢呼"式第一人称表态，不用无主语客观腔。 **🔫 弹药包强制使用（2026-08-26 确立——作者原话是"最短路径"，写进正文才算真用了）**： - **先清点后动笔**：写作前从研究报告「风格画像·风格弹药包」取全弹药（金句/句式/点名/论证四类），逐条确认"这条原话准备放哪段、怎么用（直引/改造/仿写）"——列在草稿写作笔记中 - **硬性用量**：**金句弹药 ≥1 条必须落地**（直引或改造后嵌入正文，禁止整包闲置）；句式弹药 ≥1 条化用；点名/论证弹药在命中段位化用 - **落地方案**：①直引——作者原话直接作段落金句（标注出自作者判断）②改造——替换主语/数字/对象，保留句式与语感（如把"企业凭什么老老实实发薪？"改造为"{本选题利益方}凭什么{本选题动作}？"）③仿写——弹药为空时按画像卡金句模式造新句，标注"仿写待作者确认" - **金句植入**：金句必须口语、比喻贴生活、反共识；**结尾金句强制用作者模式**（对仗如"发布会音量与交付能力成反比" / 判断式如"低价不是原罪，低价里的停滞才是" / 反问式如"对得起人设吗"），**禁止用网感鸡汤/名人名言做结尾**。**结尾金句优先从弹药包取**（样本库里"可引用金句候选"可直接进文章，比凭空造句更"像作者"）——作者自己说过的话，是作者味道最浓的原料。 **情绪姿态**：全文情绪按风格画像「情绪姿态」统一——克制中的愤怒（理性推演承载不满）、怀疑姿态（"兑现前都是假设"，落观察窗口不写定论）、站在弱者一边（"这条规则挪到没资源的人身上，还公平吗？"）。 **文风自检（成稿后逐项过）**：①每章 ≥1 次反问或设问-自答？②每个关键章节用判断句收底？③≥1 处具体点名 + 数据锚点？④有"主流说 X → 真相是 Y"的逆向拆解段？⑤有可带走的口语金句且放段落尾巴？⑥语气像"会算账的毒舌老江湖"而非教科书/新闻稿？⑦结尾金句是作者模式不是网感鸡汤？⑧**弹药包金句 ≥1 条已落地正文**（直引/改造，对应研究报告「风格弹药包」逐条核销）？——任一"否"→ 回该段重写，**不得带着"网上腔"合格通过**（这是 2026-08-22 作者反馈"部分像作者、部分偏好通用说教"的根治措施）。 ### Step 1.5：个人素材就绪检查（强制——缺素材必须标注） 写之前先确认个人素材是否到位。如果研究报告素材库中 `[故事]` 标签为空，或大纲中个人经历匹配结果为无匹配，则必须在此处标注： ```markdown ## 个人素材就绪检查 | 素材来源 | 状态 | 影响 | |----------|:----:|------| | [故事] 标签素材 | ✅ 有 N 条 / ⚠️ 无 | 决定全文人味基线 | | resume.md 匹配经历 | ✅ 有 N 条 / ⚠️ 无 | 决定个人经历真实性和细节 | | notebook 匹配笔记 | ✅ 有 N 条 / ⚠️ 无 | 决定类比自然度 | 如果 [故事] 标签为空：每段写作时必须主动插入至少 1 句个人视角（我注意到、我经历过类似的事），弥补无真实故事的缺陷。 如果 resume.md 无匹配：在涉及行业经验时使用"一个朋友""之前团队"等替代，不可编造公司名和项目名。 ``` --- ### Step 2：段落执行引擎 对大纲中每个段落，按以下流程逐段执行。这是**规格执行**，不是自由写作——大纲中每个段落的每一项规格（钩子类型、第一句模板、情绪定位、过渡方式、金句位置、占全文字数比、转发触发器位置、评论区钩子位置）都是必须兑现的约束，不是建议。 每段执行流程分两个阶段：**写作 → 验证**。验证不通过则不进入下一段。 #### 段落执行流程（写作阶段） ``` 输入：段落规格表（从大纲提取的本段所有约束） │ ├──① Hook 执行：按大纲指定的钩子类型写第一句（段1专用） │ - 钩子类型必须匹配（如大纲说"反常识数据"，就不能改成"个人故事"） │ - 第一句按大纲第一句模板写（如大纲说"以惊人数据开头"，第一句必须是数据） │ ├──② 素材装配：从研究报告取素材（按大纲指定的素材编号） │ - 只能用大纲指定的素材编号，不能自行替换为其他素材 │ - 执行人话转换（Step 4） │ ├──③ 情绪校准：按大纲该段的情绪定位控制全文语气 │ - 大纲说段3情绪=😰焦虑 → 整段措辞制造焦虑感，不能写成"客观分析" │ - 写完问：读者读完这段感受到的情绪是否 = 大纲目标的情绪？ │ ├──④ 内部结构：执行大纲段落内部结构（如"亮观点→说现象→做分析→下结论"） │ ├──⑤ 字数控制：本段目标字数 = 大纲总字数 × 大纲本段占比 │ - 写完后比对实际字数与目标字数的偏差 │ - 偏差超过 ±20% → 增删至达标再进入下一段 │ ├──⑥ 金句植入：如果本段末尾有大纲金句植入地图指定的金句 → 放入并加粗 │ ├──⑦ 转发触发器：如果本段是大纲指定的转发触发器位置 → 写入触发器句子 │ ├──⑧ 评论区钩子：如果本段有大纲指定的评论钩子位置 → 预埋钩子 │ └──⑨ 过渡句：按大纲过渡指令写段末过渡句，衔接下一段 ``` #### 段落执行流程（验证阶段——每段通过后才能进入下一段） 每段写完后，逐项检查下方"规格验证卡"。**规格验证卡中任何一项为 ❌，该段不回炉重写，不进入下一段。** ``` ## 第 X 段 规格验证卡 | # | 大纲规格 | 实际执行 | 判定 | |---|----------|---------|:----:| | 1 | 钩子类型（段1）：{大纲指定} | {实际写的钩子类型} | ✅/❌ | | 2 | 第一句模板：{大纲指定} | {实际第一句} | ✅/❌ | | 3 | 情绪定位：{大纲指定} | {实际情绪} | ✅/❌ | | 4 | 字数：{目标字数}（占全文 {X}%） | {实际字数}（偏差 {X}%） | ✅/❌ | | 5 | 金句：{有/无} → 位置 {X} | {是否到位} | ✅/❌ | | 6 | 转发触发器：{有/无} → 位置 {X} | {是否到位} | ✅/❌ | | 7 | 评论区钩子：{有/无} → 位置 {X} | {是否到位} | ✅/❌ | | 8 | 内部结构：{大纲指定} | {实际结构} | ✅/❌ | 全部 ✅ → 进入下一段 存在 ❌ → 修复本段中对应规格后重新验证，直到全部 ✅ ``` **全篇写完后**：对全文层面做规格验证（在 Step 8 质量自检中执行），包括：总字数偏差、段落数匹配、过渡连贯性、情绪曲线连续性、差异化不偏离。 #### 各体裁段落执行细则 **快讯评点体段3（点评）**： - 写 2-3 句，第一句直接给判断，不用铺垫 - 语气锋锐：敢用"我直说了吧""说白了就是" - 不用"值得关注""有待观察"等暧昧表达 **观点评论体段1（立靶）**： - 必须用断言句开头（≤15 字） - 立场要锋利，不怕争议——"这句话可能得罪人，但我还是要说" - 不用"我认为""个人觉得"等弱化表达 **观点评论体段3（反方论据）**： - 开头必须承认反方："确实，{反方核心论点}有道理" - 但 3 句内必须转到："但问题是…" - 反方论据要有真实来源，不能是稻草人 **清单体每条清单项**： - 每个清单项 = 观点(1句) + Problem→Agitate→Solution(3-4句) + 小结(1句) - 清单项之间不留过渡，直接用数字分隔 - 每个清单项 200-300 字，不膨胀 **深度分析体段1（钩子）**： - 按大纲指定的钩子类型执行（见下方 Hook 写作规则） - 150 字内钩子必须出现 - 第一句决定了读者是否继续——多写几个版本，选最有力那个 **深度分析体段5（争议讨论）**： - 先呈现正方："有人说…"（有来源） - 再呈现反方："但也有人说…"（有来源） - 最后我的判断："说实话，两边都有道理，但…" - 不要和稀泥——即使两边都认，也要给出你的倾向 **故事体段3（低谷）**： - 必须写具体细节：几点？在哪？什么感受？ - 用现在时态写，让读者觉得正在发生 - 心理活动直接引用内心独白："我当时脑子里只有一个念头——完了" ### Step 2.5：金句写作规则 大纲指定了金句位置，但金句的质量由 write 决定。一个"值得划线"的金句不是靠灵感，是有方法的。 #### 金句的四种结构 | 结构 | 公式 | 示例 | 适用位置 | |:----:|------|------|----------| | **反转型** | "你以为{X}，其实{Y}"（非"不是…而是…"变体——用顺叙） | "你以为用户要的是功能，其实他们要的是安心感。" | 段3-4末尾 | | **类比型** | "{复杂概念}就像{生活事物}" | "预算审批就像你妈管你零花钱——无论你要多少，都要打折。" | 段5争议讨论后 | | **数据冲击型** | "{数字}，比{意料之外的参照物}还{高/多/强}" | "23%的用户流失率——比你家楼下奶茶店的月回头客还低。" | 段3论证段 | | **断言型** | "{锋利判断}。{引申}。" | "大厂的微创新不是不想做，是不敢做。因为KPI不答应。" | 段1/段6末尾 | #### 金句三要素检查 每条金句写完后过三关： 1. **脱离上下文能独立传播吗？** — 把金句单独拿出来发朋友圈，别人能看懂并觉得有道理吗？ 2. **控制在 30 字以内了吗？** — 超过 30 字的句子不能作为"划线句" 3. **包含具体名词了吗？** — "PM的薪酬逻辑"好过"职场价值"（太抽象的金句没人划线） #### 金句放置规则 - 金句独立成段时，前后留空行——让它在视觉上被"框出来" - 金句不独立成段时，加粗（`**{金句}**`）——读者扫描时会先看到它 - 一段最多 1 个金句——多了变成金句集锦，反而失去了冲击力 --- ### Step 3：句子级写作规则 不同目的的句子有不同的写法和位置。 #### 七种句子类型 | 句子类型 | 规则 | 放在哪里 | 错误示例 → 正确示例 | |----------|------|----------|---------------------| | **断言句** | ≤15 字，句号结尾，无修饰词 | 段1 开头、段落末句 | "我个人认为这个现象值得关注。"→"这不对。" | | **反问句** | 段尾，制造推动力，不回答 | 段尾、过渡句 | — | "你觉得呢？" | | **数据句** | 数据先行，口语解说后置。禁止"根据XX数据，XX%的…" | 分析段 | "根据报告显示，用户流失率达23%。"→"23%的用户流失了。什么概念？每4个人就有1个走了。" | | **转折句** | 用"但""然而""问题是"开头，≤20 字 | 段中、段间过渡 | — | "但问题不在这。" | | **比喻句** | 用生活事物类比，≤30 字，比喻后跟一句"说白了就是…" | 分析段开头或末尾 | — | "这就像用筷子吃西餐。" | | **设问句** | 先问后答，用于节奏切换 | 段落中段 | — | "为什么会这样？原因不复杂。" | | **口语过渡** | 模拟真人说话的语气词 | 段间、观点切换处 | — | "说实话""你细品""不过话说回来" | #### 禁用的句式（AI 味重灾区） 以下句式和写法在草稿阶段就严格禁用——不要指望 polish 来擦屁股。这些模式是 AI 味的"文体指纹"，用一次就露馅： | # | 禁用句式 | 说明 | |:--|----------|------| | 1 | "不是…而是…"及所有变体（"不只是…更是…""与其说是…不如说是…"等） | 中文 AI 写作最高频句式。顺着说，不要翻过来说 | | 2 | "首先…其次…最后…综上"全套 | 人类不会在每段前先报站名。砍掉所有路标词 | | 3 | 廉价比喻："像一把无形的刻刀""一条令人心碎的轨迹"等 | 比喻是想了半天才找到的，不是随手批发的 | | 4 | 伪俗语："稳稳的接住了""不崩、不爆""从头就跑偏了" | 说不出哪个社群在用 → 禁用 | | 5 | 装出来的松弛感：书面框架中突然蹦出"说白了""扎心""绝了" | 要么全文口语，要么全文书面。不混搭 | | 6 | "很A，也很B"式假深刻收尾 | 真正的深刻不需要形容词 | #### 长短句配比规则 - **每个段落至少 1 句 ≤10 字的极短句**（制造冲击力） - **至少 20% 的段落只有 1-2 句**（制造呼吸感，避免密集文字墙） - **数据密集的段落**：每放 1 个数据，紧接 1 句 ≤15 字的口语化解说 - **故事段**：长短交替——长句铺细节（30-50字），短句给感受（≤10字） - **结尾段**：最后一句 ≤15 字，给人"一拳打在心口"的感觉 --- ### Step 4：人话转换系统