AGENT SKILL

writing-shape

写作之 exploit:把原始素材塑形成一篇文章,逐段进行。

License 许可
MIT
所属仓库
muscaestar/skills
最近更新
2026-10-19
Stars
★ 0
Forks
0

01 前言 Front Matter

name
writing-shape
description
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
commit_version
5c89081d4bbeb3d039a42093653f90bb698d780e
disable-model-invocation
true

02 资源文件 1

03 SKILL.md 正文

<what-to-do>

用户已经(或将会)传入一个装满原始素材的 markdown 文件。把它当作输入素材堆:可以是一叠整齐的碎片清单、一墙无结构的散文,或一份转录稿。格式不重要。在做任何其他事之前,端到端读完它。

然后运行一场塑形会话,产出一篇独立的文章文档。这是 exploit:探索已经完成,素材堆已经固定:锁定一个结构,开采素材堆来填充它。不要编辑原始素材文件:对本技能来说它是只读的。

如果用户没说文章保存在哪里,问一次并记住路径。

</what-to-do>

<supporting-info>

循环

  1. 读素材堆。 完整阅读输入文件。形成对其中内容的整体感觉。
  2. 确立先备概念。 与用户敲定读者进场时知道什么:从一开始就**已落地(grounded)**的概念。其余一切都必须先由某个块落地,之后的块才能倚赖它。见落地。
  3. 起草 2–3 个候选开篇。 每个开篇应暗示文章不同的论点或角度。全部展示出来。迫使用户挑选或组合出混合体。选定的开篇定义了文章其余部分必须做什么。
  4. 逐段生长。 开篇落定后,问"有了这个开篇,读者接下来需要听到什么?"从素材堆取材来回答。下一个块只能倚赖已落地的概念,并在落地时落地新概念。就下一个块采取的形式展开争论:一个段落、一个列表、一个表格、一个 callout、一段引文、一个代码块。每个格式选择都应该是有意的、可辩护的。
  5. 边进行边追加到文章文件。 不要攒批。每个商定好的段落或块立即写入,让用户看到文章逐渐成形。
  6. 循环第 4 步直到文章完成。 由用户决定何时完成。

落地

每个概念都必须在块倚赖它之前落地:读者要么进场时就知道它,要么在更早的块中遇见了它。一个伸向未落地概念的块会丢掉读者。单位是概念,不是它的用词:哪怕一个行话都没有,一个块也可能倚赖读者不具备的想法。当一个概念有名字(一个术语),落地它意味着把想法和术语一起落定。

概念通过两种方式之一落地:

  • 先备(Prerequisite):在开篇之前落地。读者自带。开头定死。
  • 引入(Introduced):某个块确立它,从此它对文章其余部分都已落地。

维护一份已落地概念的流动清单。当你问"读者接下来需要听到什么?"时,下一步动作需要的某个未落地概念本身就是答案:先落地它(在这里或在更早的块中),否则你无法做出这个动作。这是从素材堆取材的"命名缺口"在更高一层的样子:那里是素材堆缺材料;这里是文章缺地基。

杠杆是你把什么设为先备、什么放在文中落地。upfront 要求太多会把读者拒之门外;在文中落地太多,开篇会淹没在定义里。确立先备概念时与用户敲定这个平衡。

对话的感觉

这是一场反转的 grilling 会话。在构思阶段,问题是"你实际注意到了什么?";在这里是"这篇文章实际在论证什么,读者需要以什么顺序听到它?"要顶回去。拒绝让软弱的过渡蒙混过关。如果一个段落配不上它的位置,砍掉它。

要持续使用的具体动作:

  • "这个段落为读者做了什么上一段没做的事?"
  • "如果我砍掉这个,什么会崩?"
  • "这是散文,还是应该是列表?为什么是散文?"
  • "这个句子在做两份工:拆开它,或者选一份。"
  • "开篇承诺了 X。我们已经漂到了 Y。要么重新穿线,要么改开篇。"

从素材堆取材

把原始素材当作采石场,而不是剧本。取出一块碎片,改造它以适应周围的段落,然后放置它。一块碎片可能被拆到多个段落中、与另一块合并,或被转述。素材堆的工作是被开采;文章的工作是读起来像一个人的声音。

如果素材堆缺了文章需要的东西,显式命名缺口:"We need an example here and the pile doesn't have one. Give me one now or we cut this section."

真正要展开的格式争论

选择如何呈现一个块时,与用户把这些取舍大声权衡,而不是默默决定:

  • 散文 vs. 列表。 散文承载论证;列表承载并列项。如果各项并非真正并列,散文更好。如果真并列,列表浏览起来更快。
  • 行内 vs. callout。 提示、警告和题外话放进 callout(> [!TIP]、> [!NOTE]),但仅当它们放在行内真的会打岔主要论证时。否则留在行内。
  • 表格 vs. 重复结构。 如果同样的形状以同样的字段重复 3 次以上,用表格。否则用加粗领头的散文。
  • 引用 vs. 转述。 当原始措辞本身就是重点时引用。只有想法重要时转述。
  • 代码块 vs. 行内代码。 多行、可运行或有示意性 → 代码块。单个 token 或标识符 → 行内。

写作节奏

每个块商定后就追加到文章文件。每次写入之前从磁盘重新阅读文件:用户可能在轮次之间做了编辑。永远不要盲目覆盖。如果用户想重写某个段落,就地编辑那个特定段落;其余不动。

范围之外

  • 开采素材堆中没有的新碎片(缺口按"从素材堆取材"处理)。
  • 编辑原始素材文件。
  • 发布、为特定平台排版,或添加用户没有要求的 frontmatter。

</supporting-info>

04 同仓库更多 Skills