十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

小红书笔记体裁契约(Genre Contract)在飞书 CLI 中的实战解析:从定位约束到成稿检查

小红书笔记体裁契约(Genre Contract)在飞书 CLI 中的实战解析:从定位约束到成稿检查 CLIAI 技能【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址https://gitcode.com/gh_mirrors/cli414/cli点击查看免费下载导读本文围绕飞书 CLIlark-cli的 lark-doc Skill 中「小红书笔记」体裁契约Genre Contractplatform.xiaohongshu展开逐条拆解该契约的硬约束、适用消歧规则、五大笔记主任务的内容脊柱、成稿要求与交付前检查清单。你将理解在飞书文档里写「小红书风格」内容稿时如何与官方正式体裁区分、如何按任务类型组织内容骨架、如何落实首屏与结尾的写法以及如何借助docs script parse的 Draft Profile Check 做交付前校验。全文同时给出仓库内的实现路径与命令示例可直接用于 Agent 或开发者日常创作。契约在创作链路中的位置先路由、再生成、后校验xiaohongshu.md位于 skills/lark-doc/references/genres/ 目录属于 lark-doc Skill 的体裁契约Genre Contract文件。在 lark-doc 创作工作流 中从零创作一篇文档必须依次执行 Step 1理解读者任务与硬约束→ Step 2选择 genre contract→ Step 3收集资料→ Step 4提交 Presentation Decision 并初始化草稿→ Step 5生成 release candidate→ Step 6Draft Profile Check→ Step 7创建文档→ Step 8交付。契约文件正是在 Step 2 被选中、在 Step 5/6 约束实际写作与校验的。契约入口有一个专门的路由文件 route-platform.md仅当最终交付物是小红书笔记、微信公众号文章或邮件成稿时进入该 Router按目标平台选择且只读取一个 leaf。其中关键词XHS、小红书命中 xiaohongshu.md微信、wechat命中 wechat.md邮件、email、e-mail命中 email.md。多平台成稿必须分别路由和生成不混写。这一「Router → Leaf」结构决定了本契约的使用前提只有用户明确要“小红书笔记、小红书写法、小红书 style、红书感、XHS 风格”时才触发且与内容保存在哪里无关。核心定位硬约束交付物边界与视觉基线契约开篇用「硬约束」划清了交付物的性质边界这四条是全文写作的前提优先级最高交付物是飞书文档中的“小红书风格”内容稿不代表实际发布也不执行小红书平台审核、禁词、流量或商业规则。也就是说契约只管内容与结构的“像”不管平台侧的合规与分发。视觉策略默认使用rich偏爱图文并茂和清晰轻松的阅读体验但装饰不能代替内容。在 lark-doc-create-workflow.md 的 Step 3 中presentation_mode三档为formal正式克制不用高亮块、emoji 或装饰组件、normal按内容需要使用组件、rich主动利用图片、画板、HTML 等飞书组件每个组件须有明确目的不设全局数量配额。小红书契约直接锁定rich因此在 Step 4 提交 Presentation Decision 时presentation_mode应填rich。写作风格鲜活、有节奏、有画面感可使用符合语境的 emoji。这与 wechat.md公众号形成对比公众号要求“自然、可交流的书面语”小红书则明确允许更积极的 emoji 用于导航、语气和停顿——但禁止连续堆叠。一篇只解决一个主要问题标题、封面、首屏和正文围绕同一获得感并真正兑现。不编造亲历、身份、数字、效果或用户反馈材料不足时用第二人称、场景化讲解或中性叙述。最后一条硬约束在飞书 XML 层面有一个具体落点飞书源稿禁止使用callout高亮块lark-doc-xml.md 定义了callout语法callout emoji background-colorlight-* border-color*p…/p/callout子块仅支持p/ol/ul/checkbox及行内标签。生成后要通过 Draft Profile Check 的profile.blocks检查其他 block 按真实信息关系选择——即不要为了“像小红书”而堆砌高亮块。适用与消歧什么时候触发、什么时候绝不触发触发条件用户明确要“小红书笔记、小红书写法、小红书 style、红书感、XHS 风格”时使用本契约内容保存在哪里不影响本合同生效。例如内容最终落在飞书文档、本地 Markdown 或其他位置只要表达意图是“小红书风格稿”契约就适用。不触发场景消歧规则仅把小红书作为研究对象、数据源或业务渠道时不触发小红书运营方案 → 走 Workplace对应 route-workplace.md平台数据或竞品分析 → 走 Report对应 route-report.md规则说明 → 走 Knowledge对应 route-knowledge.md。若同时要小红书风格稿和正式体裁分别生成不混写。这条规则与 Router 的“多平台成稿分别路由和生成”一致也呼应 lark-doc-create-workflow.md 中“最多各读取一个 contract/adapter”的要求。笔记主任务五大内容脊柱与选择方法契约用一张表定义了五种常见的“笔记主任务”及其对应内容脊柱。写作前必须先确定笔记属于哪一类再按对应的骨架推进避免结构散乱| 主任务 | 内容脊柱 | |-|-| | 教程 / 攻略 / 知识 | 痛点场景 → 核心判断 → 分步做法 → 易错点 / 限制 → 马上可做的一步 | | 体验 / 测评 / 探店 | 使用场景 → 具体观察 → 亮点与槽点 → 适合谁 / 不适合谁 → 选择建议 | | 观点 / 热点 | 争议或反差 → 核心判断 → 理由与例子 → 另一面 / 边界 → 留给读者的问题 | | 个人经历 / 成长 | 真实困扰 → 转折瞬间 → 做过什么 → 可观察变化 → 可迁移认识 | | 推荐 / 种草 / 活动 | 目标人群与场景 → 核心价值 → 具体理由 / 体验 → 使用条件与取舍 |这张表的共性在于每一条脊柱都以“场景/冲突”开头、以“可执行的收束或开放的互动”结尾中间是判断 证据 边界。与公众号契约的「内容模式」表知识/方法、观点/解释、资讯/热点、案例/故事、品牌/行动相比小红书的脊柱更短、更口语化、更强调“马上可做的一步”和“适合谁/不适合谁”这类种草决策信息。成稿要求从标题到结尾的七条写作纪律1. 标题三选一只兑现最强的一个先钉住具体读者、场景与获得感内部比较以下 3 个标题方向成稿只输出正文能兑现的最强一个搜索清晰型信息直达利于检索如“XX 的 3 个方法”痛点共鸣型直击读者具体困扰反差好奇型制造认知反差引发点击。核心主题词要自然出现在标题或首屏相关表达按需进入小标题和正文。2. 首屏1—3 个短段落完成“场景/冲突 → 核心判断 → 内容预告”首屏不从宏大背景或自我介绍讲起而是用具体场景或冲突开场紧接着给出核心判断再预告本篇内容。这是全文是否“活”的关键帧。3. 正文短段落 有意义的小标题按信息增量推进每节必须新增动作、观察、例子、判断或限制。“活人感”来自具体细节、选择和取舍不靠强塞网感词。这与 wechat.md 中“用具体细节、例子、转折和取舍形成作者声音不靠网络热词、排比口号制造爆文感”的纪律同源。4. 视觉一个视觉中心图片就近服务内容围绕一个视觉中心设计封面图片 / 截图 / 示意图就近服务对应内容无可用图片时给出简短配图建议正文仍须独立可读。飞书 XML 中图片用img path./photo.png/本地、img hrefURL/公开网络图响应须为 PNG/JPEG/GIF/WebP单图不超过 20MiB或img srctoken/复制原图表达详见 lark-doc-xml.md。5. emoji积极但克制emoji 可比正式体裁用得更积极用于导航、语气和停顿但不连续堆叠。在 lark-doc-create-workflow.md 的约束栈事实 用户硬约束 读者任务 内容 组件样式下emoji 属于“组件样式”层不得反向改变内容判断。6. 话题标签少而相关话题标签少而相关不为覆盖关键词而复读。核心主题词只需自然出现在标题或首屏一次小标题与正文按需呼应即可。7. 结尾一句记忆点收束结尾用一句记忆点收束互动问题可选且至多一个不要求固定收尾动作。这与公众号契约“结尾回扣开头问题或中心判断留下结论、影响或自然的下一步”类似但更短、更轻。交付前检查Draft Profile Check 与返工触发条件检查清单自检维度确认以下几点全部满足读者能一眼判断“这和我有关”标题或首屏指向具体读者标题承诺已兑现首屏、正文确实交付了标题承诺的获得感每节都有实质信息没有空泛段落手机上容易扫读短段落、短句、小标题层级清晰emoji 与图片确实帮助理解不是装饰堆砌。出现公文腔、长铺垫、文字墙、题文错配、空情绪或虚构事实时返工。如何在 CLI 中执行校验契约要求“生成后通过 Draft Profile Check 的profile.blocks检查”。在 lark-doc-script.md 中docs script提供两个脚本init-draft创建带 Presentation Decision 基线的独占工作区并预留 XML 路径Step 4 使用parse解析本地或在线文档返回画像并检查决策与资源Step 6 使用。初始化草稿的命令Step 4其中 JSON 需按 Step 1–3 的实际结论填写不得照抄示例lark-cli docs script --command init-draft --presentation-decision 完整 JSON --format json小红书笔记的 Presentation Decision 示意presentation_mode取richgenre_contract/adapter记录 Step 2 命中结果{ audience: 想快速掌握某类方法的普通用户, reader_task: 看完能直接上手并避开常见坑, genre_contract: platform.xiaohongshu, adapter: null, presentation_mode: rich, visual_plan: { reason: 小红书风格需要图文并茂的轻松阅读体验, blocks: [] } }Draft Profile CheckStep 6lark-cli docs script --command parse --content ./draft_path --format json返回的data.assessment.status只有passed才算通过失败时按data.diagnostics[]局部修复每条 diagnostic 提供severity、稳定code、msg、可选expected/actual和suggested。注意parse不是 XML/SDK schema validator成功且无 warning 也不保证服务端接受写入前仍须按 lark-doc-xml.md 复查标签、属性和值。与 Callout 禁令的联动由于契约明令禁止callout而 lark-doc-xml.md 又定义了完整的callout语法与配色规则背景支持gray、light-{色相}、medium-{色相}text-color/border-color使用基础色相两者结合意味着写小红书笔记时即使想用高亮块突出“易错点”也应改用普通段落、列表或图片承载并把这一决定通过 Draft Profile Check 的profile.blocks复核。契约允许的 block 范围p/h1-h9/blockquote/hr/img/b/em/u/del/br/span/ol/ul/pre/checkbox/table/grid等完全足够支撑小红书式排版不依赖 callout。与其他体裁契约的边界对比快速参考| 维度 | 小红书本契约 | 微信公众号wechat.md | |-|-|-| | 触发关键词 | XHS、小红书 | 微信、wechat | | 视觉策略 | 默认rich| 默认rich但强调“不是加长版小红书” | | emoji | 积极使用不堆叠 | 按需使用不要求固定收尾动作 | | 标题策略 | 搜索清晰 / 痛点共鸣 / 反差好奇三选一 | 信息清晰 / 问题冲突 / 观点浓缩三选一 | | 正文推进 | 短段落 小标题信息增量 | 一条逻辑线段落长短随内容变化 | | 结尾 | 一句记忆点互动至多一个 | 回扣开头或中心判断留下自然下一步 | | 共同禁区 | 不编造亲历、身份、数据、效果禁 callout不混写多体裁 | 同左 |结语契约即创作基线Check 即质量闸门从本仓库的 lark-doc-create-workflow.md 看契约文件不是“参考文档”而是每次从零创作时 Step 2 必须选定、Step 5/6 必须执行的硬性基线xiaohongshu.md 作为platform.xiaohongshu的 leaf 契约把“像小红书”拆解成了可执行的定位约束、任务脊柱、写作纪律与交付检查。对使用飞书 CLI 的开发者或 Agent 而言掌握这套契约意味着从路由消歧不混写、不误触发到视觉策略rich 禁 callout再到成稿检查docs script parse的 Draft Profile Check整条链路都有明确的判断依据最终产出的是“内容真实、结构清晰、手机易扫读”的小红书风格飞书文档草稿而非浮于表面的模板仿写。赞分享CLIAI 技能【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址https://gitcode.com/gh_mirrors/cli414/cli点击查看免费下载相关推荐Patch-NetVLAD的PCA降维魔法add_pca.py完整工作流128/512/4096维如何选择Patch NetVLAD的PCA降维魔法add_pca.py完整工作流128/512/4096维如何选择 Patch NetVLAD 是 CVPR 202CLIAI 技能自动切换明暗主题moe-theme-switcher.el 日出日落智能适配指南自动切换明暗主题moe theme switcher.el 日出日落智能适配指南 moe theme.el 是一款为 Emacs 用户打造的多彩养眼主题而CLIAI 技能Lark 飞书文档 AI 创作中的消费决策体裁契约route-consumer 规则解析与实战指南Lark 飞书文档 AI 创作中的消费决策体裁契约route consumer 规则解析与实战指南 导读 本文解析 Lark/飞书 CLI 项目 lark dCLIAI 技能上一篇OpenInCode 项目教程下一篇Lighthouse 开源项目指南在 Laravel 中构建强大的 GraphQL API创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表