人工智能AI 技能/插件提示工程【免费下载链接】garden-skillsConardLis open-source Skills collection, featuring web design, knowledge retrieval, image generation, and more.项目地址https://gitcode.com/GitHub_Trending/we/garden-skills点击查看免费下载导读longform是 beautiful-article 技能体系中默认的文章类型面向完整长文、归档、深度阅读场景当源材料是连贯的论证 / 叙事 / 综述且用户要求原文级保留时它是最佳结构决策。本文以 article-types/longform.md 为骨架结合仓库中的类型路由、组件协议、Raw 政策与工作流源码完整讲解 longform 的典型结构、组件取舍、Raw 边界、配图与主题倾向、自检清单以及何时不要用 longform让读者既能按类型清单直接套用也能理解它为何是 beautiful-article 的默认策略。1. 什么是 longform默认类型的定位与适用前提在 beautiful-article 中文章类型是结构决策主题是审美决策两者完全解耦见 article-types.md。longform是十种已注册类型longform / full-report / tutorial / explainer / dialogue / review / essay / briefing / interactive-explainer / visual-essay中的第一种也是 SKILL.md 声明的默认文章类型默认策略输出 single HTML文章类型longform信息保留 100%。它的适用前提非常明确源材料是连贯的论证 / 叙事 / 综述用户要原文级保留即不打算压缩或删减信息密度。从 information-density.md 的信息密度表看100% 保留对应 longform表达特征是长文为主Raw 增强完整章节和细节适合完整归档、原文级深度阅读。需要特别注意一个事实longform 与 100% 信息保留在实践上是绑定的。article-types.md 顶部明确警告longform 20%这类组合是伪选项——要么类型变形要么内容空洞longform 写出 8 章每章 2 段。因此 Phase 2 规划阶段在 plan-template.md 中只要求记录类型与标配保留比例只有用户明确想精修如longform 但只要 60% 一篇被深度编辑的长文时才作为非标配组合写入plan/plan.md的 Brief 段并由主 Agent 在写每节时手动调整正文 / 视觉比例。2. 核心参数100% 信息保留意味着什么longform 的推荐信息保留为100%其执行标准是原文关键内容不丢只允许删除明显的重复段落和无信息的过场句。这定义了两个操作边界必须保留原文的关键论证、数据、结论、引用、代码与表格允许删除明显的重复段落、无信息的过场句如正如我们前面提到的……这类纯粹衔接性废话。从 SKILL.md 的成功标准可以进一步看到这条原则的验收口径40% 信息时读起来像被编辑过的文章而非缩水摘要100% 信息时像被精修过的长文而非原文搬运。也就是说100% 保留不等于照抄原文——它要求用 beautiful-article 的结构与视觉手段对原文做精修让信息量一点不少但阅读体验从线性的 Markdown 变成有节奏、可定位、可交互的网页文章。这是 longform 自检清单见第 7 节中100% 信息是否读起来像被精修过的长文而非原文搬运这条的根本原因。3. 典型结构Hero → Lead → Summary → Sections → Raw → Conclusionlongform 的典型结构来自 article-types/longform.mdHero → Lead导语框定主题→ 可选 SummaryTL;DR / 结论先行 → 多个 Section必要时 Subsection→ 关键概念处 Raw 增强 → Conclusion逐段的职责如下模块职责Hero标题气质 / 副标题 / meta日期、来源、作者见 component-policy.mdLead导语用 1–2 句框定主题、交代文章要解决什么Summary可选TL;DR / 结论先行帮助读者快速定位长文强烈建议Section/Subsection正文主体承载全部论证与信息Raw增强在关键概念、数据趋势、机制处插入自由层给长文节奏与呼吸Conclusion收束全文TOC 的开启条件也是 longform 特有的当长文超过 10 个小节、或预估阅读时间超过 15 分钟时开启TOC。这与 layout.md 中本 Skill 默认开启 TOC长文有导航更易读的策略一致——Article toc会渲染左侧目录从Section/Subsection自动派生最多三级、带滚动高亮窄视口1000px自动回落为单栏。在 section-build.md 中可以看到这一结构的落地形态每个 Section 必须是独立组件文件article/sections/NN-*.tsxArticle.tsx只做组装assembler例如Article toc widthregular Hero ... /Lead…/Lead SectionOpening / SectionContext / Conclusion…/Conclusion /Article4. 组件选择正文是绝对主体别把连贯段落拆成卡片堆longform 的组件策略第一条是正文段落为绝对主体应占文章绝大部分篇幅。其余语义组件只在内容确实是那个结构时才用component-policy.md 的 litmus test若一句话 / 一个列表 / 一张表 / 一块 Raw 读起来更好就用那个Aside点出关键直觉 / 历史注 / 反方观点Quote引用名言或原话Table承载二维数据CodeBlock/Formula技术内容专用写代码只用CodeBlock不直接用其底层HighlightedCodeRaw自由层任意 HTML / CSS / JS / React。longform 最常见的走样形态在文档中被明确定义为卡片堆——把连贯段落拆成一堆Aside/ 卡片式的视觉块让论证断裂、文章变得零碎。规避方法就是坚持 prose-first普通段落写成Section的 children组件是点睛而非装饰。从仓库的默认主题档案也可以印证这条纪律tufte.mdData-Ink 主题longform 技术 / 证据型的首选要求页面上每一滴墨水都承载信息去除卡片、填色、阴影、圆角、装饰色knuth.md学术 / 论文型同样禁止卡片、面板、填色块、投影、圆角。两个主题的禁止项恰好与卡片堆是 longform 最常见的走样形态形成互证。5. Raw 边界增强而非主体用--ra-*token 约束longform 对 Raw 的使用给出了清晰的边界在关键概念、数据趋势、机制处插入 Raw 自由层轻交互 / 自定义排版 / 动效 / 按需 SVG给长文节奏与呼吸每块服务具体段落用--ra-*token。Raw 是增强而非主体——如果开始让 Raw 承载主要信息说明你应该考虑explainer或interactive-explainer。结合 raw-policy.md 可以理解这一边界的执行细则Raw 是完整的 Web 平台不是画 SVG。可以写任意 HTML / CSS / JS / React选择标准只有一个哪种媒介最能讲清这一段——例如交互拖动条 / 切换 / 折叠 / 步进器 / 计算器 / 小型可调模型布局排版并排对比、时间线、卡片网格、分栏、引文大字动效CSS transition /keyframes/ 滚动揭示数据可视HTML/CSS 条形与热度、canvas、需要时才用svg折线 / slopegraph嵌入与组合表格 控件 文本拼成的一次性小工具。自由但一致用 token。Raw 内部的颜色 / 字体 / 间距必须取自主题变量var(--ra-color-accent)、var(--ra-font-body)、var(--ra-space-4)…这样每块都独一无二却又随主题切换。示例来自 raw-policy.md// 需要曲线时才为这个数据点手画一条内联 SVG Raw title构建体积走势 svg viewBox0 0 300 80 width100% polyline points{pts} fillnone strokevar(--ra-color-accent) strokeWidth2 / /svg /Raw禁止项包括复杂表单、拖拽工作台、完整 dashboard、产品原型、和文章无关的动画、独立于主题的配色、复用固定小组件冒充自由表达。Raw 自检四问raw-policy.md结尾这块 Raw 删掉后文章理解是否会变差它服务哪一个段落 / 论点它是否使用--ra-*token是否符合主题 md它是否让文章更像应用如果是砍掉或收敛成服务阅读的解释性视觉 / 排版在 longform 中Raw 是给密集文本节奏与呼吸的手段是点亮关键概念的局部增强而不是信息的主要载体。6. 配图与主题倾向none/placeholders优先tufte / knuth / press / bodoni配图倾向longform 的配图倾向为none/placeholders优先技术 / 证据型可用真实数据图tufte风叙事型可加少量press风氛围图。这与 asset-policy.md 定义的四种配图来源none/user-assets/placeholders/ai-generated对应。注意一个关键正交关系配图与 Raw 正交不是二选一——Raw始终默认存在、照常使用Image是否使用、用哪种来源由 Plan Checkpoint 的配图策略决定。选配图none只表示不用外部图片Raw不受影响。主题倾向longform 的主题倾向来自 article-types/longform.md主题适用场景tufte技术 / 证据型长文Data-Ink数据墨水比优先knuth学术 / 论文型长文Computer Modern 衬线、编号小节、公式优先press叙事 / 综述型长文bodoni专栏 / feature 型长文这与 SKILL.md 的默认策略一致技术 / 证据优先tufte叙事 / 评论优先press。版式上longform 默认配合regular阅读宽度约 46rem 开 TOC见 layout.md 的宽度表。7. 自检清单longform 的验收口径longform 自检article-types/longform.md包含五个问题可以作为 Section Reviewer 与终审的引用依据正文是否仍是绝对主体没有把段落拆成卡片堆章节衔接是否自然读者读完一节会自然想读下一节Raw 是点亮关键概念还是打断阅读节奏100% 信息是否读起来像被精修过的长文而非原文搬运长文有没有TOCSummary帮助读者定位从 review-checklist.md 可以看到这条清单如何落到质检流程中Phase 5 的每个 Section 都要过 Section Reviewer以消息返回 pass/fail不写文件检查完成 outline 任务 / 符合信息保留比例 / 与前后衔接 / 不过度组件化 / 正文充足 / Raw 与配图有明确目的 / 本节序号自洽Phase 6 终审的 Technical Reviewer 还要核查章节序号全篇自洽01 / 02 / 03 …连续单调Subsection序号前缀对齐父Section——这些在并行开发模式 B 下尤其容易出错因为 subagent 看不到自己在全篇的位置。8. 何时不要用 longform类型路由的关键判据longform 文档明确给出了四类不要用的判定这正是 article-types.md 类型路由的实战判据源材料特征应改用的类型理由消化后的报告执行摘要 风险 建议四件套full-report已有完整分析结构不需要原文级保留要解释一个机制 / 概念可以删 20%explainer信息保留降到 ~80%正文解释为主论文 / 长文但想做成交互学习页interactive-explainerRaw 交互为主载体原文摘录约 25%其余 75% 是 AI 围绕核心知识点全新创作给忙人看 / 要决策briefing结论先行信息保留 ~40–60%选择 longform 的核心判据article-types.md 选型提示源材料信息密度高、要完整归档 → longform。其它类型各有定位tutorial是教学上手、review是工程审阅、essay是观点叙事、dialogue是对话整理、visual-essay是图文传播展示。9. 在完整工作流中的位置从 Phase 2 选型到 Phase 5 落地longform 不是孤立的一个文档它嵌在 beautiful-article 的 8 阶段 harness 流程中SKILL.mdPhase 0 Intake → Phase 1 Source→Markdown → Phase 2 Editorial Planning → Phase 3 Plan Checkpoint★必须停→ Phase 4 First Spread → Phase 5 Full Article Build → Phase 6 Final Review → Phase 7 Repair → Phase 8 Deliverylongform 在其中的具体作用Phase 2读article-types.md完成类型路由后若选中 longform就读article-types/longform.md拿结构 / 组件 / Raw 边界 / 配图倾向 / 自检写入 plan-template.md 四段式plan/plan.mdBrief / Outline / Theme / Assets。Phase 3 Checkpoint 1文章类型含标配保留比例 100%作为五个独立决策项之一让用户确认且比例已绑进类型选项不再单独成题——避免出现longform 20%伪选项。Phase 4 First Spread首屏Hero / Lead写进article/Article.tsx第一个 Section 写成独立组件article/sections/01-*.tsx。Phase 5按一个 Section 一个组件文件铁律顺序或并行生成全部 Section每节过 Section Reviewer。Phase 8构建为自包含单页article/article.htmlCSS JS 内联断网可打开这是主交付物PDF 导出为可选用户明确选择时运行bash skill/scripts/html-to-pdf.sh。整条流程的质检协议强调Plan 自查用主 Agent 内联禁开 SubAgent、不写文件First Spread 与 Final 用 SubAgent 并写 review 文件Section 用 SubAgent 但只以消息返回——这是 beautiful-article 的性能纪律longform 作为默认类型同样遵守。10. 落地建议把 longform 用对的四个要点综合以上全部内容在 garden-skills 的 beautiful-article 技能下实践 longform 时最值得记住的四条确认源材料形态连贯论证 / 叙事 / 综述 用户要原文级保留才选 longform否则按第 8 节的判据换类型。守 100% 信息保留只删明显重复与无信息过场句其余全部保留但要用结构、组件与 Raw 把原文精修出网页文章的阅读节奏而不是搬运。正文主体、组件点睛、Raw 增强别拆卡片堆Raw 只服务具体段落且用--ra-*token一旦 Raw 开始承载主要信息就考虑换explainer/interactive-explainer。长文必备定位手段10 小节或预估阅读 15 分钟时开TOC并给出Summary帮助读者定位技术 / 证据型配tufte/knuth叙事 / 综述型配press/bodoni。若想继续深入可对照阅读仓库中的 article-types.md全部十种类型路由、component-policy.md组件协议与最小骨架、raw-policy.mdRaw 允许 / 禁止 / 示例、section-build.md一节一文件与并行模式以及 SKILL.md 的完整工作流即可在任意一次把长文做成网页文章的任务中稳定复现 longform 的正确形态。赞分享人工智能AI 技能/插件提示工程【免费下载链接】garden-skillsConardLis open-source Skills collection, featuring web design, knowledge retrieval, image generation, and more.项目地址https://gitcode.com/GitHub_Trending/we/garden-skills点击查看免费下载相关推荐Beautiful Article 信息密度指南用信息保留比例决策正文与视觉块的配比Beautiful Article 信息密度指南用信息保留比例决策正文与视觉块的配比 信息密度information density是 garden人工智能AI 技能/插件提示工程Lightdash Autopilot 图表工作流用 Agent 工具链创建与修复图表的完整指南Lightdash Autopilot 图表工作流用 Agent 工具链创建与修复图表的完整指南 导读 本文基于 Lightdash 仓库中 Autopilo人工智能AI 技能/插件提示工程TeslaMate 安全模型与加固实践理解网络即信任边界并安全部署自托管特斯拉数据记录器TeslaMate 安全模型与加固实践理解网络即信任边界并安全部署自托管特斯拉数据记录器 TeslaMate 是一个自托管的特斯拉数据记录器其官方安全策人工智能AI 技能/插件提示工程上一篇老番救星计划用Index-AniSora把90p模糊视频拉回1080p整套流程一次讲透下一篇RxJS Join Patterns 模块用 join calculus 编排多个 Observable 的协同触发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考