内容：规划与创建
规划品牌的内容并端到端制作：一个经过研究的叙事、一个能吸引注意力的钩子、没有AI痕迹的文案、符合品牌设计的构建，以及针对每个渠道的发布表。所有品牌特定的内容都存放在品牌包中；此处的方法适用于任何品牌。框架在Figma中构建，或编写为HTML并渲染为PNG，具体取决于品牌在设置时选择的渲染方式。
文案决定了人们是否会停下脚步。 大部分精力应投入研究和写作，然后再打开Figma或相机。在写任何内容之前，请阅读 references/writing-craft.md 和两个工作示例：references/examples/linux-7.4-carousel.md（新闻记录）和 references/examples/ai-cost-js-carousel.md（他人的实验）。每个示例都列出了被拒绝的草稿及其原因；模仿其方法，而非句子本身。
从这儿开始，每次运行
指向 scripts/、references/、templates/ 和 brands/ 的路径都在此技能的文件夹内；content/ 在你工作的项目中。从项目根目录运行命令，带上技能的路径，例如 python3 <skill>/scripts/new_item.py content ...（<skill> 是此文件所在的文件夹）。使用 Pillow 的脚本（contact_sheet.py、slides_to_pdf.py、artefact_marks.py、ref_sheets.py）运行时无需添加 python3 -I。
- 设置检查。 阅读项目中的
content/setup.md。如果该文件不存在，说明这是第一次运行：请先运行 setup-content 技能（已一并安装；在此仓库的../setup-content/SKILL.md中；调用它或手动执行）。它询问品牌名称，在获得许可后从品牌网站和资料收集自有资产，选择渲染器（Figma 或 HTML → PNG），并写入品牌包。 - 找到品牌包 (
brands/README.md)：项目中的content/brand/，否则是本技能中的brands/<name>/。阅读brand.md、design.md和content/brand/assets/README.md（如果存在，品牌的照片和logo优先于库存素材）。任何标记为(proposed)的内容尚未确定；在计划依赖它之前先询问。 - 盘点工具，并利用每一个能帮助的工具 (
references/research-tools.md)：网络搜索、页面获取、真实浏览器 (ego-browser)、社交媒体 MCP 或内置的 X 访问权限、Figma MCP 以及图像生成：首先使用你自己的图像工具（如果有的话，如 Grok Bot 的 Grok Imagine、Codex、ChatGPT、Antigravity），然后使用python3 <skill>/scripts/gen_image.py detect（agy、OpenAI、Gemini、xAI 密钥）。记录缺少哪些工具。 - 创建工作空间 (
templates/workspace.md)：content/包含plan/、items/、reviews/、ideas.md、design-log.md。首次使用时创建。 - 选择下面的一种模式。
| 用户想要 | 模式 |
|---|---|
| 计划、日历、"rencana konten bulan ini" | 计划 |
| 单个作品：轮播图、单帖、线程、Reels脚本、LinkedIn帖子、文章 | 创建 |
| 从一个来源制作多个作品 | 复用 |
| 了解哪些有效以及需要更改哪些 | 审查 |
| 设置新品牌、更改渲染器或刷新资产 | 设置（setup-content 技能） |
计划
- 阅读输入 (
references/planning.md第1部分)：品牌包、上次审查、ideas.md、当月的关键时刻（核实日期）、内容制作容量、所有者的目标。 - 根据
templates/plan-month.md编写content/plan/YYYY-MM.md：核心支柱及其占比、系列及其发布频率、大约四分之一的位置留给反应型/即兴内容、每个强项内容拆分为3-5种形式并安排在不同的日期。 - 运行
python3 <skill>/scripts/check_plan.py content/plan/YYYY-MM.md --brand <pack>/brand.md直至没有 FAIL；对于你保留在计划注释中的任何警告进行解释。 - 报告：用三行概述本月，需要确认哪些提议内容，存在哪些空缺。
创建
- 项目文件夹：运行
python3 <skill>/scripts/new_item.py content <date> <slug> <format>。 - 研究 (
research-tools.md)：主要来源、深入一层链接、发布后的更正、指定人物的原话、本地视角、每个数字的第二个来源。 - 叙事 写在
brief.md中 (writing-craft.md第1-4部分)：五个问题、转折点、框架（新闻、实验、参考列表、或来自copy-playbook.md的规则）、值得保存的幻灯片或帖子、至少三种形式的五个钩子（经过门控和决斗）、一个隐喻家族及其Verbs:行。 - 文案 按照格式 (
references/formats/：carousel.md、single-post.md、x.md、threads.md、linkedin.md、reels-tiktok.md、long-form.md) 写在copy.md中，每个数字、姓名和引用的下方都要有>来源注释。每个标题都要通过“然后呢？”（lalu kenapa？）测试，并且隐喻至少出现在其中三个标题中；注意事项按照writing-craft.md第7b节的要求放置；行动指令要通过“谁、用什么、何时”测试。然后运行python3 <skill>/scripts/lint_copy.py <item>/copy.md --format <format> --brand <pack>/brand.md，必须返回退出码0（new_item.py会打印正确的--format：thread作为x进行 lint 检查，document作为linkedin进行 lint 检查）。阅读其警告和仅标题的阅读版本；将该阅读版本写入brief.md，并将文案大声朗读一遍。 - 图片 (
image-sourcing.md)：证据框架使用真实素材图像；隐喻框架优先使用品牌自己的照片，如果没有合适的，则自动生成图像（首先使用你自己的图像工具，然后使用agy，仅当content/setup.md允许时才使用付费 API），最后使用 Unsplash；保持一个视觉线索，保留来源清单中的署名。所有者可以随时切换图像工具或停止生成。 - 选择配色方案和布局 (
design-variety.md)：该系列的配色方案，或者对于单个作品，选择前一个作品未使用过的配色方案；然后根据每个幻灯片的功能以及content/design-log.md中最近使用的情况，为每个幻灯片选择变体，确保没有两个作品看起来相似。将它们写入brief.md的“Design”表格中，并注明一个标题标记样式和一个打破规律的幻灯片。品牌包的画册页面（Figma）或content/setup-gallery/*.jpg（HTML），以及refs/（如果品牌包中有）展示了可选项。 - 使用
content/setup.md中指定的渲染器进行构建 (design-system.md)；当它同时列出两项时，遵循其关于哪些作品去哪里的规则，否则询问：- Figma (
figma-mechanics.md)：scripts/figma-helpers.js中的布局函数，由scripts/figma_bundle.py --brand <pack>/design.md --page "<name>" --scheme <scheme> --n <frames>与品牌包的BRAND块打包在一起（该工具接受50,000个字符），放置在品牌 Figma 文件的新页面中；切勿触碰其他页面。上传图片，然后使用配色方案的对偶色进行第二次调色调用 (duotone(id, 'light' | 'dark'))。 - HTML → PNG (
html-render.md)：scripts/new_html.py使用工具包和品牌的 CSS 设置项目的html/文件夹；使用工具包的布局编写slides.html，并将选定的照片和生成的图片复制到html/img/中；scripts/render_slides.py将每个幻灯片渲染成一个 PNG 文件。 Reels：storyboard.md+ 一个 1080×1920 的封面框架（Figma，或按照html-render.md第4节的说明作为单独的 HTML 页面）。
- Figma (
- 廉价验证：首先进行布局检查（Figma 中使用
layoutCheck()，HTML 中检查render_slides.py打印的问题）并修复报告的问题；然后查看封面、数据框架以及更改的内容（Figma 中一次一张截图；HTML 中查看 PNG 文件）。如果用户停止截图，则停止并说明哪些框架未被检查。 - 发布表：
publish.md包含每个渠道的文本、限制内的标签、替代文本、时间、链接、署名；向content/design-log.md添加一行。发布是所有者的步骤，除非他们明确要求通过已连接的工具发布特定作品；先确认。 - 报告：内容的位置、两行概述方向、选择的布局、哪些已验证哪些未验证、您拥有和缺少哪些研究工具、以及说明文字。
复用
一起规划拆分方式 (planning.md 第6部分)，一个项目文件夹，计划中每个拆分一行。每个拆分都为其格式 (references/formats/) 进行重写，独立表达完整意思，并链接回原文。轮播框架可以同时作为 LinkedIn 文档 (scripts/slides_to_pdf.py) 和 Threads/TikTok 图片帖子使用。
审查
根据 templates/review-month.md 编写 content/reviews/YYYY-MM.md：仅使用平台或所有者提供的数字，并注明日期；将每个作品与品牌在其格式上的中位数进行比较；为每个系列决定继续、修改或停止；将决定带入下个月的计划。如果没有共享数字：列出需要收集的内容，然后停止。
最重要的写作规则
完整方法见 writing-craft.md，规则见 copy-playbook.md，语言见 language/<lang>.md。
- 钩子 = 精确数字 + 场景 + 利害关系，或
writing-craft.md第3b节中六种形状之一。用三种形状写出五个，进行门控（≤30字、简洁、无条件、诚实、保留答案、制造张力），对幸存者进行决斗，并写出每个失败者失败的原因。不要打分：自我打分会导致平局。 - 标题是带有后果的主张：每个标题都要通过“然后呢？”（lalu kenapa？）测试。主题词放在小标题中。标记承载主张的一两个词。
- 一个隐喻家族，只说一次，然后至少在三个标题的动词中使用它。
- 故事后期的一个转折点；一个值得保存的框架或帖子。
- 回归本质：观众自己的价格、日期、地点、公司或行动。
- 数字公平比较，图表从零开始，对冲措辞从来源复制，第一人称仅用于品牌所做的事。
- 对冲措辞保留在句子中；提醒事项有预算：封面或标题中没有，数据幻灯片上有一个，观点幻灯片上有一个，其余在说明中。
- 观点需标注，并以一个通过“谁、用什么、何时”测试的行动结束。
- 一个 CTA 来自品牌包；承诺描述该作品刚刚完成的事情。
- 使用品牌包中的语言；只有当用户为某个作品明确要求使用其他语言时，才使用其他语言。
- 不要使用陈词滥调的开场白，不要出现 AI 痕迹；lint 检查会捕获大部分。
质量门控
- 已阅读品牌包；没有将任何
(proposed)的内容不经询问就当作已确定使用。 - 所有可用的研究工具都在需要的地方使用了；报告了缺失的工具。
- 五个故事问题均已回答，并包含本地视角；转折点已放置。
- 钩子工作坊已完成，包括门控和决斗；封面 ≤30字，无提醒事项，且能独立发挥作用。
- 仅标题的阅读版本已写入
brief.md，并能讲述故事；隐喻至少出现在三个标题中；已命名一个值得保存的作品。 - 行动指令通过了“谁、用什么、何时”测试。
-
lint_copy.py对相应格式退出码为0；每个数字、姓名和引用都有注释。 - 遵守平台限制 (
formats/specs.md)：标签、字符数、安全区域。 - 每个幻灯片的布局已在
brief.md中选择；封面和标题标记与content/design-log.md中的前一个作品不同；有一个幻灯片打破规律。 - 应用了一种配色方案；在合适的地方使用了品牌自己的照片；照片已调色；屏幕截图保持彩色、未经修改、已署名、并使用高亮标记标注。
- 布局检查干净（Figma 中的
layoutCheck()，HTML 中的render_slides.py）；或者已解释每个注释；已查看封面和数据框架（或已报告缺失）。 - 结尾：一个 CTA，所有来源和署名；生成的图片标记为插图。
-
publish.md已完成，并向content/design-log.md添加了一行；未经明确同意，未发布、点赞或关注任何内容。 - 计划通过了
check_plan.py。
文件映射
| 文件 | 何时阅读 |
|---|---|
brands/README.md、brands/<brand>/brand.md、design.md | 每次运行 |
../setup-content/SKILL.md、references/brand-onboarding.md | 第一次运行（无 content/setup.md）、新品牌、新渲染器 |
references/planning.md | 计划、复用、审查时 |
references/writing-craft.md、references/examples/*.md（两个带有被拒绝草稿的工作轮播示例） | 在任何写作之前 |
references/copy-playbook.md | 框架、copy.md 格式、CTA、说明 |
references/language/id.md、en.md | 品牌的语言 |
references/formats/*.md | 正在制作的格式；specs.md 用于限制 |
references/design-system.md、design-variety.md、design-references.md | 在构建框架之前：角色、布局变体及如何选择、其他账户的模式 |
references/figma-mechanics.md | 在第一次使用 use_figma 之前；上传、双色调、截图 |
references/html-render.md、templates/html/ | HTML → PNG 渲染器：设置、类参考、渲染、检查 |
references/image-sourcing.md、research-tools.md | 研究和图片 |
references/patterns-from-data.md | 规则为何如此 |
references/prerequisites.md | 安装配套工具和可选工具 |
templates/ | 工作空间、设置、计划、brief、发布、审查、创意、设计日志；html/（幻灯片工具包和示例） |
scripts/ | lint_copy.py、check_plan.py、new_item.py、figma-helpers.js（布局、配色方案）、figma_bundle.py、figma-gallery.js + figma-gallery-2.js、figma-gallery-schemes.js、brand_css.py、new_html.py、render_slides.py、crawl_site.py、capture_profile.sh、artefact_marks.py、ref_sheets.py、slides_to_pdf.py、capture_artefact.sh、x_post.py、scan_site_tokens.sh、unsplash_search.py、gen_image.py、agy_image.sh、contact_sheet.py、export_oss.sh |
何时不应使用此技能
不适用于幻灯片演示（请使用幻灯片技能），不适用于构建网站，也不适用于对现有帖子进行一个词的修改（直接编辑它）。