--- name: flexfox-writer description: > Write or make targeted revisions to a FlexFox WeChat long-form article after its Brief, evidence table, and outline are ready. Produces only article.md. Use for tools, hands-on tests, event explainers, and trend or opinion pieces; do not use for topic selection, research, title generation, layout, or WeChat drafts. --- # 灵动狐正文写作 ## 输入、输出与边界 先按以下顺序阅读: 1. 当前 Profile:项目根目录存在 `flexfox-profile.md` 时读它;否则读 `profiles/ai-feishenglu.md`。两者都不存在时停止并要求补 Profile。 2. `过程/brief.md`、`过程/evidence.md`、`过程/outline.md`。 3. [长文结构合同](../../references/article-contract.md)。其中的字数、小标题、语义块、加粗、图片与门禁数值是唯一事实源,本 Skill 不另行定义或覆盖。 - 只修改 `article.md`;大纲、来源编号、质检过程不得混进成稿。 - 只写正文。标题由 `flexfox-title` 在审稿通过后锁定;若 `article.md` 已有标题,保留它,不在本 Skill 中生成或改题。 - 选题、查证、排版、转发词、封面与草稿箱不归本 Skill 管。 - 收到 `过程/review.json` 的 `needs_revision` 时,只修复点名位置及其必要上下文;不借审稿名义重写整篇。修改后必须交回独立 reviewer,不能自行宣称通过。 ## 写作心法 你是在把一件让读者不淡定、又确实有用的事讲给人听。 读者在手机信息流里随时会划走。具体信息要先于解释出现,标题承诺必须在前 100 字开始兑现。 ### 四条最高指令 1. **可读性极强**:外行能一路顺下来;技术硬料用最笨的人话讲。 2. **ADHD 友好**:每个语义块有明确推进;短段落、长短句交错,不碎成一句一段,也不堆成文字墙。 3. **乙方别开枪式排版**:标题、留白、证据图和加粗服务阅读,不靠花哨样式抢戏。 4. **活人感有据可查**:开头让读者被认出来,站位像同伴,摩擦来自已核验证据里的卡点、价格、限制和值不值。没有亲历证据时用观察者视角,绝不补造现场、对话或报错。 ### 动笔前的四个问题 答不出来就回到 Brief 和大纲,不要靠文笔硬撑: 1. 读者凭什么点进来? 2. 读者凭什么读下去? 3. 读者读完能拿走什么? 4. 读者会转给谁,为什么? ## 执行顺序 1. 确认 Brief 主线、材料关系和每个 `[必写] E##` 都已在大纲中有位置;用户已确认时直接沿用,不重复索要确认。 2. 按大纲逐节写:先开场,再展开,最后收束。不要为套模板重排真实材料。 3. 初稿后按“交付前自检”修正,再运行结构门禁。 4. 门禁失败时只按报告修复;最多两轮,仍失败则停止并请求人工决定。 ## 开场:先让读者认出自己 开场三句内必须同时做到两件事:读者认出普遍处境;事件、利益、数字或反常事实落地。 - 第一句写读者天天会碰到的处境,或事件中最荒诞但已核验的事实;短,不热身。 - 第二、三句立刻落到本篇事件、数字或利益。 - 不写“大家好”“今天给大家分享”“最近有个很火的……”,也不用“在 AI 飞速发展的今天”起手。 - 可写“接到一件模糊的 AI 任务、订阅费又涨了、教程看完还是不会装”这类普遍处境;不虚构某位领导、读者或群聊真实说过的话。 - 场景接不上本篇利益就删,不能为了共鸣硬造。 ## 全文推进 推进方式由材料决定: - **叙事、实测、事件稿**:按真实发生顺序或场景切换推进。只有真实转折才写时间锚点。 - **观点、趋势、解释稿**:走问题链;每段回答上一段留下的具体问题,不把材料强塞进 A vs B 冲突。 - **教程、工具、开源稿**:先讲为什么要做、解决什么麻烦、读者能拿它做什么、门槛/成本/风险在哪;只有事实需要时才写步骤与 FAQ。 无论哪种,时间、对象、动作、结果、价格或限制必须完整落在 `过程/evidence.md` 与大纲中。热闹只负责降低门槛,不能替代事实节点。 ## 句子与节奏 ### 短句瀑布,不是碎句堆叠 - 一句话只承担一个信息、动作、转折或包袱;一个语义块只完成一个小推进。 - 一个语义块通常 1–3 句;可在块内自然换行,也可连写两三句。不要一句一行,不规定固定行数或行宽。 - 用一个空行分隔语义块。不要按编辑器中的“行”机械计数;检查的是每个语义块是否带来新事实、解释、判断、后果或动作。 - 连续两个语义块没有新收获时,删减或重写其中一个。 - 解释概念时,用一句大白话加一个生活例子;不用三个抽象名词解释另一个名词。 - 约 80% 让外行看懂,剩下的篇幅留给真正关键的技术与判断。 ### 推进、判断与气口 - 先给细节、数字、价格、限制或实际动作,再给判断。 - 读者连续读过一小段仍没有荒诞事实、具体账本、真实反转或可执行收益时,补信息或收紧,不硬造金句。 - 同一个好句式只用一次;不用连续对称排比、段尾硬升华或“先说三点”预告。 - 允许粗糙、直接和自我打断;不把每段磨成满分作文。口癖只能少量自然出现,不能打卡式塞满。 - 省略号全文不超过 3 处,叠词不超过 2 处。 ### 比喻四查 专业动作讲不明白时,换成读者手边的东西,例如把“限流”讲成“食堂只开两个窗口”。写完逐个检查: 1. 删掉比喻后,事实仍完整吗?不完整则先补事实。 2. 比喻中的物件是读者常见的吗?外卖、群聊、打印店、停车场可以,行业黑话不行。 3. 一个概念只配一个比喻,全文不超过 3 个。 4. 比喻不长成虚构情节;不要写成“就像你昨天……”。 ## 同伴口吻 站位是“和读者站一边的懂行朋友”,不是老师,也不是客服。 - 用“你”“大家”“咱们”把读者带入现场,少用“用户”“使用者”“笔者”。 - 可用反问带出读者此刻真的会问的问题,随即用事实回答;全文最多 2 处。 - 吐槽只对准现象、厂商话术、定价页或反人类文档;不人身攻击,不对证据外的事下判断。 - 自嘲只在与读者共同吐槽被吐槽对象时使用;不虚构熬夜、翻车、被老板骂等作者经历。 ## 事实、人味与合规红线 - 数字、版本、价格、功能、时间和亲历只使用 `过程/evidence.md` 已核验内容;缺证据就删,或留在过程文件标为待核验。 - 真实摩擦沿用证据归属:只有本账号确实跑过且有记录,才能写“我试了”;来源作者的体验要注明“原文作者实测”;其余使用观察或判断口吻。 - 开场的读者场景是普遍处境,不是亲历,不能写得像真实发生过的具体事件。 - 价格、额度、版本、活动期等时效信息写具体日期,避免“最近”“目前”。 - 引用他人内容要说明出处;不整段搬运,也不贴近原文改写。 - 不写“愣了一下、后背发凉、回过味来、心里一紧、好家伙、我陷入沉思”。 - 不写“首先/其次/总而言之/值得注意的是/说白了/说实话”,不写“不是 X 而是 Y”,不用长破折号解释。 - 商业合作按 Brief 披露合作关系;不承诺收益、效果或必然结果;涉及他人产品的负面判断必须有证据支撑。 ## 结尾与转发动机 - 回到读者现实,给一个具体开放收束,不做总结陈词或硬升华。 - 至少给读者一个可以立刻执行的下一步:能不能用、先试哪步、要花多少钱/额度、卡在哪绕开。内容只来自 evidence。 - 福利、征集或活动要说清谁能参加、得到什么、多少份、什么时候;缺一项如实标待核验。 - 互动引导只留一个动作;不写诱导分享或诱导关注话术。 - 最后使用 Profile 的固定 CTA;固定 CTA 外不另造栏目名、口头禅或签名档。 文章至少应有一个真实转发动机:可转给正好需要的人、账本清楚可省时省钱、荒诞但真实的谈资,或替读者说清了一个真实感受。它必须来自事实,不能硬凑金句。 ## 交付前自检 1. 开场三句内既有读者处境,也有事件、利益、数字或反常事实。 2. 每个 `[必写] E##` 已在对应章节完整说清;标题若已锁定,其承诺已在前 100 字开始兑现。 3. 每个语义块都在推进,连续两个语义块没有新收获的地方已经处理。 4. 比喻过四查;没有虚构亲历、人物、对话或报错;时效事实带具体日期。 5. 结尾有证据支持的下一步,活动信息齐全,固定 CTA 已按 Profile 使用。 6. 已按长文结构合同核对结构、图片、加粗与版式要求。 ## 门禁 ```bash python3 scripts/validate_article.py \ --article articles/YYYY-MM-DD-主题/article.md \ --sources articles/YYYY-MM-DD-主题/过程/来源/index.json ``` 通过前不能调用排版、草稿箱,也不能把 `过程/review.md` 写成通过。