writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- writing-shape
- description
- 写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
- commit_version
- 5c89081d4bbeb3d039a42093653f90bb698d780e
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml140 B
03 SKILL.md 正文
<what-to-do>
用户已经(或将会)传入一个装满原始素材的 markdown 文件。把它当作输入素材堆:可以是一叠整齐的碎片清单、一墙无结构的散文,或一份转录稿。格式不重要。在做任何其他事之前,端到端读完它。
然后运行一场塑形会话,产出一篇独立的文章文档。这是 exploit:探索已经完成,素材堆已经固定:锁定一个结构,开采素材堆来填充它。不要编辑原始素材文件:对本技能来说它是只读的。
如果用户没说文章保存在哪里,问一次并记住路径。
</what-to-do>
<supporting-info>
循环
- 读素材堆。 完整阅读输入文件。形成对其中内容的整体感觉。
- 确立先备概念。 与用户敲定读者进场时知道什么:从一开始就**已落地(grounded)**的概念。其余一切都必须先由某个块落地,之后的块才能倚赖它。见落地。
- 起草 2–3 个候选开篇。 每个开篇应暗示文章不同的论点或角度。全部展示出来。迫使用户挑选或组合出混合体。选定的开篇定义了文章其余部分必须做什么。
- 逐段生长。 开篇落定后,问"有了这个开篇,读者接下来需要听到什么?"从素材堆取材来回答。下一个块只能倚赖已落地的概念,并在落地时落地新概念。就下一个块采取的形式展开争论:一个段落、一个列表、一个表格、一个 callout、一段引文、一个代码块。每个格式选择都应该是有意的、可辩护的。
- 边进行边追加到文章文件。 不要攒批。每个商定好的段落或块立即写入,让用户看到文章逐渐成形。
- 循环第 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
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。
wayfinder
把一大块工作(超过一个 agent 会话能装下的)规划为 issue 跟踪器上一张由决策 ticket 构成的共享地图,然后一次解决一个,直到通往目的地的路清晰可见。