Skip to content

CLAUDE.md

Latest commit

 

History

History
99 lines (85 loc) · 7.53 KB

CLAUDE.md

File metadata and controls

99 lines (85 loc) · 7.53 KB
Raw

{{项目名 例：my-articles}}

个人文章本地写作工作目录。每篇文章一个子目录，已发布文章可推送到 GitHub repo {{GitHub 用户名}}/articles。

新用户先读 README-START.md，把所有 {{占位符}} 改成你自己的信息。

目标

  • 高效产出中英双语文章 + 配图 + 各平台推广文案
  • 严格控制 Claude 上下文消耗，避免无谓的目录扫描和文件读取

关键约束（硬性）

  • 写新文章时不得读取任何已有文章文件（article.md、article-en.md 等）。风格规范以 WRITING.md 为唯一参考。
  • 不得扫描项目目录结构。每篇文章目录结构固定（见下），无需 ls/glob 探索。
  • 写作前必须先读 WRITING.md。
  • promotion.md / xhs.md 永远不推到 GitHub（已在 .gitignore）。
  • 配图默认全部走 baoyu skills——按需求选最合适的 skill，禁止自己撸 SVG 模板 + rsvg/ImageMagick 合成（已踩过坑，一定是重新发明轮子）：
    • 小红书图卡系列 / 微信图文系列 / 任何"一组多张、版式统一"的卡片：用 baoyu-image-cards（项目本地已装在 .claude/skills/）。12 种风格、8 种 layout、3 种调色盘、--ref 锁首图风格
    • 单张文章封面：baoyu-cover-image
    • 正文单张配图 / 任意自由出图：baoyu-imagine
    • 结构化关系图 / 流程图：baoyu-diagram
    • 纯信息图（单张密集信息）：baoyu-infographic
    • 除非用户明确说"自己画"，否则一律走 skills。
  • 配图文字规则（基于 Seedream 5.0 实测）：
    • 首选 Seedream 5.0（doubao-seedream-5-0-260128）出带文字的图——目前唯一能稳定写对中文短句的主流模型，其它（GPT Image / Imagen / Jimeng / 老 Seedream）一律按"会出错字"假设
    • 可以放结构化短文字：标题 + 副标题 + 一句钩子 + 小标签，单行 ≤ 10 个汉字、整图总字数 ≤ 40 字为安全区
    • 仍然禁止：代码块、长段 prompt 文本、英文 ALWAYS/NEVER 长列表、超过 2 行的连续句子——任何模型都会崩
    • prompt 必须显式约束字形：写明 "Chinese glyphs must render correctly, no garbled characters, no fake-looking CJK, kerning correct"，错字率能压一半
    • 图本身仍以视觉为主：强概念隐喻 + 大量留白，文字是辅助标注，不是画面主体
  • 配图默认风格：Notion 插画风（flat illustration、柔和 pastel 配色、手绘感不规整描边、简单几何图形、大量留白、轻微纸张颗粒纹理、温暖友好、editorial 风格）。避免：摄影写实、cyber 霓虹、紫色渐变、3D 卡通、营销 hero 风。
  • 配图配色：优先用品牌色（详见 BRAND.md，自行替换为你的品牌色板）。文字 + 视觉一致性：文章里的加粗色 = 配图里的强调信号点；H1/H2 标题色 = 配图标题色——读者从公众号 → 配图 → 落款应该是同一套色觉系统
  • 配图必须带「{{品牌名/笔名}}」水印（cover、正文图、小红书图、所有对外配图）：
    • 位置：右下角，距边缘留出小留白（约 3-4% 边距）
    • 字号：小号（占图宽 ~6-8%），不抢主视觉
    • 颜色：辅助灰色，~60-70% 透明度
    • 字体：和图内主标题同款 sans-serif，无装饰、无图标、无边框
    • 优先用 prompt 让 Seedream 渲染（短 6 字、字形稳定）；如果出错字，回退到 post-process（ImageMagick 叠加文字）保证正确
  • 正文外部链接必须给全地址（GitHub：https://github.com/xxx/yyy），不要只用 [显示文字](url) 把 URL 藏起来。公众号 / 知乎 / 小红书等渠道经常剥离超链接，读者只能看到显示文字。
  • 品牌色：参见 BRAND.md。发公众号必须 --theme simple --color "{{你的主色 hex}}"（不要用 default 主题，会把 H2 染绿块）。所有配图 prompt 必须用品牌色板。

每篇文章目录结构（固定）

  • article.md — 中文正文（推送）
  • article-en.md — 英文原稿（推送，可选）
  • cover.png 或 cover.svg — 封面图（推送）
  • image/ — 正文配图（推送）
  • promotion.md — 各平台推广文案（仅本地，不推送）
  • xhs.md — 小红书图卡发布包（仅本地，不推送）

参考 _article-template/ 目录。

推广文案规范（promotion.md）

  • 每篇文章完成后同步创建
  • 默认覆盖渠道：小红书、抖音、微信朋友圈（按需调整）
  • 每个渠道包含：标题、正文/转发语、标签
  • 末尾附转发检查清单（checkbox 格式）

小红书图卡发布包（xhs.md）— 固定动作

触发条件：任何小红书图卡系列（如 11 张图卡、9 宫格等）出图完成后，自动在该文章目录下写 xhs.md，不用等用户提醒。 文件位置：<article-dir>/xhs.md（仅本地，不推送 GitHub）。

小红书硬性字数限制（写 xhs.md 必须严格遵守）

  • 标题 ≤ 20 字（含标点、空格、英文字母——所有可见字符），写完 Python len(s) 数一遍确认
  • 正文 ≤ 1000 字（含标点、空格、emoji、换行——所有可见字符），目标压到 ≤ 900 字留缓冲
  • 字数超标 = 小红书发布器直接截断或拒绝，不要赌

小红书反引流硬规则（图卡 + caption 都适用）

  • 绝对禁止任何把流量引到外部（尤其是微信公众号）的字眼：
    • 禁词：公众号、微信公众号、品牌名（在 XHS 上下文中作为公众号名）、关注公众号、扫码关注、加微信、私信加 v、B 站、抖音同名、X / Twitter、Telegram、二维码图、外站完整 URL
    • 这条对图卡内容也生效：任何卡片正文、CTA、水印之外的可读文字都不能出现公众号名 / 引流话术
    • 唯一例外：右下角小水印（≤6% 宽、~60% 透明）——这是品牌签名不是引流
  • 替代 CTA（小红书允许）：收藏、点赞、评论区聊、评论区扣 1 / 扣完整版、关注我、下篇见
  • Why：小红书风控对站外引流（特别是微信生态）封号/限流极敏感

xhs.md 必含字段

  1. 标题 2-3 选一（每条标注精确字数，≤20）
  2. 完整正文 caption（前言 + 10 条短钩子 + 收束，≤900 字，标注精确字数）
  3. 话题标签（小红书上限 10 个）
  4. 发布顺序（按文件名列出，明确封面）
  5. 检查清单（checkbox：字数复核 / 上传顺序 / 封面 / 标题 / caption / 标签 / 定时 / 预览）
  6. 备注（图来源 / 模型 / 风格锚点 / prompt 路径）

关键文件

  • WRITING.md — 写作风格规范（写文章前必读）
  • BRAND.md — 品牌视觉规范（配图前必读）
  • plan.md — 当前迭代计划（可选）
  • progress.md — 进度流水（可选）
  • decision.md — 选型/规则决策记录（可选）
  • bug.md — 已知问题（可选）
  • handoff.md — 会话交接（可选）

文档维护规则（无需提醒，主动执行）

触发即更，改完直接 commit 不要问：

  • 修完 bug → bug.md：OPEN → FIXED
  • 完成阶段性进展（如发布一篇文章） → progress.md：追加一条（日期、做了什么、结果、下一步）
  • 做了规则/选型决策 → decision.md：追加一条（决策 + Why + 代价 + 日期）
  • 新任务/scope 变化 → plan.md
  • 会话结束 / 用户说"交接" → 刷新 handoff.md
  • 发现 bug 未当场修 → bug.md OPEN 区追加

日期用真实当天日期。