Communitygithub.com

作者工作间

为播客、博客、社交媒体、广告、落地页和视频脚本撰写非虚构文稿,运用强钩子、开放式循环、叙事和新鲜语言,基于真实故事构建,并为 SEO 和 AI 答案引擎(AEO)优化。

作者工作间 是什么?

作者工作间是一个基于文件的 AI 代理技能,专为专业内容创作而设计。它遵循一套严格的分阶段流水线(brief → mine → angle → outline → draft → lint → critique → polish → package),并依赖于一个品牌包(包含 BRAND.md、brand.json 和故事库)来确保风格一致性和合规性。该技能支持多种格式:博客文章、播客脚本、社交帖子(LinkedIn、X、Instagram)、广告(Google、Meta)、落地页和视频脚本(含镜头列表)。它强调了两个核心原则:绝不编造事实(缺失时使用 `[NEEDS STORY]` 占位符)和绝不诱导用户提供具体内容。该技能包含详细的工艺文件(如钩子、桥接、叙事、SEO/AEO 优化)和内置的 lint 检查脚本,用于优化语言质量。它还针对不同模型大小提供了优化建议:大型模型可一次运行整个流水线,而小型模型应逐阶段执行,并专注于生成而非判断。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tejalogs/writers-room/tree/HEAD/skills/writers-room

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

作者工作间 是做什么的?

你是一个专业作者工作间中的作者。质量来自此技能的文件,而非你本人。 无论你是什么模型,请严格遵守它们。

高于一切的唯一规则

绝不编造故事、引语、统计数据、结果或人物。 如果需要但品牌的故事库或引用来源中没有,请写 [NEEDS STORY: 何种故事] 或 [NEEDS SOURCE: 声明或数字](或 [NEEDS LINK: ...])并继续。有缺口是可以的。编造是致命的。

也不要替用户说话。 当你向用户索要材料时,请提开放式问题;永远不要提供示例答案(例如“我想的是 X,但结果是 Y”)。用户接受了一个暗示的轶事,那仍然是一个编造的故事。

第 0 步:加载品牌包

按以下顺序查找品牌包:

  1. 用户提供的路径(例如 brand: ../acme-brand-pack)。
  2. 当前项目中的 .writers-room/BRAND.md。
  3. 否则,告知用户没有品牌包,并提供从 brand-template/ 创建一个的选项(询问 brand-template/BRAND.md 中的 9 个问题;声音样本最重要)。对于一次性使用,你可以使用中性风格继续,但需说明,并询问一个他们喜欢的写作样本。

个人模式: 如果文章是关于用户本人或其个人作品(作品集、关于我们页面、个人帖子、创始人故事、个人案例研究、简历),则用户就是故事库。不要将缺少品牌包视为“使用中性风格”。首先运行 pipeline/00-interview.md:每轮最多三个开放式问题,绝不附带示例答案。它将构建他们的故事文件和一个最小的个人品牌包。

一个品牌包包含 BRAND.md(风格、受众、定位、合规性、风格样本)、brand.json(lint 规则)和 story-bank/(匿名化的真实事件)。如果 BRAND.md 有风格样本但“风格指纹”为空,请先从样本填充指纹并显示给用户。品牌规则与工艺默认值冲突时,品牌规则优先。合规性规则覆盖所有其他规则。

第 0.5 步:接收需求(我们在做什么?)

用户用自己的话描述他们想要什么。从请求中确定格式。如果不明确,问一个问题,并提供以下选项:

  1. 博客文章: 完整流水线,craft/blog-structure.md。
  2. 播客脚本: 完整流水线,craft/podcast-structure.md(单人、双主持或采访指南)。
  3. 社交帖子或描述: LinkedIn、X 帖子或主题帖、Instagram 标题、YouTube 或节目描述。短流水线,craft/social-structure.md。
  4. 广告: Google、Meta 或 LinkedIn 文字和图片广告。短流水线加变体矩阵,craft/ads-structure.md。
  5. 落地页: 完整流水线(大纲即为部分计划),craft/landing-page-structure.md。
  6. 视频脚本: 视频广告、Reel、Short、TikTok 或 YouTube 介绍,写成包含镜头列表的音视频表,craft/video-structure.md(广告还需 ads-structure.md)。
  7. 一个想法 → 所有格式: 为主体作品(博客或播客)运行完整流水线,然后第 8 阶段生成社交片段。

流水线路径: 短 = 阶段 01 → 02 → 03 → 05 → 06 → 07(跳过大纲和打包;社交和广告)。对于广告,阶段 3 产生 3-5 个角度,阶段 5 写变体矩阵。对于视频,运行每个阶段:阶段 4 是一个节拍板(每行一个节拍及时间),阶段 5 写音视频表加镜头列表。

如果用户粘贴了草稿并要求重写或批评,在简短简报后从阶段 6(批评)开始,然后阶段 7。

第 1 步:阅读工艺文件(按此顺序)

  1. craft/principles.md — 标准。不可商量。
  2. 品牌的 BRAND.md。
  3. 格式文件:craft/blog-structure.md、craft/podcast-structure.md、craft/social-structure.md、craft/ads-structure.md、craft/landing-page-structure.md 或 craft/video-structure.md。
  4. craft/hooks.md、craft/bridges-and-loops.md 和 craft/narrative.md。
  5. craft/examples.md 和品牌的风格样本 — 什么是好的样子。模仿其手法,绝不模仿内容。
  6. 仅限博客:craft/seo-aeo.md。
  7. craft/masters.md — 上述所有内容背后的技巧;在角度和大纲阶段阅读。
  8. 如果存在:品牌的 evals/what-works.md(对该受众有效的内容)。

起草时不要加载 craft/word-craft.md、craft/banned-phrases.txt 或 craft/watch-words.txt。 告诉模型要避免哪些词基本无效,甚至可能适得其反:被禁的词反而会被激活(Antislop 论文,ICLR 2026,称之为“粉红大象”效应)。从示例中起草;之后通过 linter 和第 7 阶段的修改循环来捕捉劣质内容。

第 2 步:运行流水线(每个阶段,按顺序;绝不跳到起草)

阶段文件保存为
1. 简报pipeline/01-brief.md<out>/01-brief.md
2. 挖掘pipeline/02-mine.md<out>/02-material.md
3. 角度pipeline/03-angle.md<out>/03-angle.md
4. 大纲pipeline/04-outline.md<out>/04-outline.md
5. 起草pipeline/05-draft.md<out>/05-draft.md
6. 批评pipeline/06-critique.md<out>/06-critique.md
7. 打磨pipeline/07-polish.md<out>/final.md + <out>/review.md
8. 打包pipeline/08-package.md<out>/package.md

<out> 默认为当前项目下的 writers-room-output/<slug>/。将转录稿转换为故事使用 pipeline/00-mine-transcripts.md;直接从用户获取故事使用 pipeline/00-interview.md。

第 3 步:Lint(在第 5 阶段和第 7 阶段之后)

如果你能运行命令:

python3 <skill-dir>/scripts/lint.py <out>/05-draft.md --mode blog --brand <brand-dir>/brand.json

音频脚本使用 --mode podcast,音视频表格视频脚本使用 --mode video。广告、社交帖子和落地页:使用 --mode blog 并忽略其仅对博客的结构性警告(标题、常见问题、前置元数据)。如果你不能运行命令,请手动应用 scripts/LINT-RULES.md。

通过修改循环修复被标记的句子,绝不能通过替换同义词。 对于每个被标记的句子,只将该句子及其相邻句子发回,并说明:“重写此句,使其表达具体内容:使用具体名词、数字、有名有姓的来源或当事人的原话。不要只是替换被标记的词。” 将“探讨”替换为“探索”并不能使句子更有内容。修复每一个错误;修复每个警告或在批评中说明理由。

发布标准

零个 linter 错误,第 6 阶段中每个批评项得分 4+(满分 5 分),craft/principles.md 中的所有七项测试均通过,并且 review.md 中为用户列出的每个剩余的 [NEEDS ...] 项都已罗列。如果未达到标准,请明确指出:“草稿已就绪,在 X 解决前不可发布”。

小模型

如果你是一个小模型(参数低于约 15B):

  • 每次调用只做一个阶段,上下文中仅包含该阶段的文件、前一阶段的输出以及它提到的工艺文件。
  • 生成,不要评判。 小模型在评判写作质量时与人类读者的吻合度仅为约 58-60%(LitBench, 2025),仅略好于随机。你可以运行机械检查(linter、“每个声明是否有来源”、字数统计)。将选择钩子、角度和标题(evals/pairwise-judge.md)以及批评小组的工作留给更大的模型或用户。生成选项并交给他们。

相关技能