writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- writing-beats
- description
- 写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
- commit_version
- 321658273cb1d20b76026717d027d505790106d4
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml140 B
03 SKILL.md 正文
<what-to-do>
用户已经(或将会)传入一个装满原始素材的 markdown 文件。这是 exploit:探索已经完成,素材堆已经固定。选定一条穿过它的路径,开采这堆素材来填充每个节拍。
如果用户没说文章保存在哪里,问一次并记住路径。
然后运行一段逐节拍的旅程,自选冒险(choose-your-own-adventure)风格:
- 确立先备概念。 在任何节拍之前,与用户敲定读者进场时已经知道什么:从一开始就**已落地(grounded)**的概念。其余一切都必须先由某个节拍落地,之后的节拍才能使用它。见落地。
- 从原始素材中写出 2–3 个候选起始节拍。每个都是进入文章的不同入口。每个都只能倚赖已落地的概念;注明每个节拍新落地了哪些概念。在写入文章文件之前把节拍展示给用户。用户挑选一个。预览这个选择解锁了哪些后续节拍,仿佛让用户看到路径前方的一小段。
- 用户选定起始节拍后,只把那一个节拍写入文章文件。一个节拍可以是一句话,也可以是几个段落,那个节拍自然是什么样就是什么样。到此停下。
- 从磁盘重新阅读文章文件。然后提供 2–3 个候选下一节拍:旅程可以从文章当前位置转向的不同方向。每个都必须从当前已落地集合可达;注明每个节拍落地了什么。
- 循环第 3–5 步,直到文章抵达自然的终点。
</what-to-do>
<supporting-info>
落地
每个概念都必须在节拍倚赖它之前落地:读者要么进场时就知道它,要么在更早的节拍中遇见了它。一个伸向未落地概念的节拍会丢掉读者;那是这段旅程唯一不能做的动作。单位是概念,不是它的用词:哪怕一个行话都没有,一个节拍也可能倚赖读者不具备的想法。当一个概念有名字(一个术语),落地它意味着把想法和术语一起落定。
概念通过两种方式之一落地:
- 先备(Prerequisite):在第一个节拍之前落地。读者自带。开头定死。
- 引入(Introduced):某个节拍确立它,从此它对之后的每个节拍都已落地。
所以每个节拍做两件事:它要求已落地的概念,并落地新概念。维护一份目前已落地概念的流动清单,每落地一个节拍就更新它。
这正是自选冒险的成形方式。一个候选节拍只有在它要求的一切都已落地时才可达;挑选一个落地了概念 X 的节拍,会解锁每一个等待 X 的节拍。当你提供下一节拍时,它们必须全部从当前已落地集合可达,并说明每个节拍落地什么,让用户看到它打开了哪些路径。
最大的杠杆是你把什么设为先备、什么放在文中落地。 upfront 要求太多,会把不具备它们的读者拒之门外;在文中落地太多,前面的节拍会淹没在定义里。确立先备概念时与用户敲定这个平衡,并且每当一个诱人的节拍被发现要求一个尚无东西落地的概念时就重新审视:解法要么是在它之前加一个落地节拍,要么把这个概念提升为先备。
什么是节拍
节拍是旅程中的一个动作。它做一件事:布置场景、落定观点、抛出问题、插入题外话、扭转角度。然后它停下,把读者留在一个下一节拍可以转向的位置。
节拍的大小由它的需要决定:
- 如果这个动作只需要一句话,就用一句话("And then nothing happened for three weeks.")。
- 如果这个动作需要铺垫,就用一个短段落。
- 如果这个节拍是一个自足的小品、论证或例子,就用多个段落。
如果一个"节拍"需要五个段落和三个小标题,它就不是节拍;而是两个节拍粘在了一起。拆开它。
从素材堆取材
从原始素材堆中取材填充每个节拍。你可以转述、拆分、重组或引用。素材堆是采石场。
结束旅程
文章在旅程完成时结束,而不是在素材堆掏空时。大多数素材堆都会有没有入选的剩余碎片。没关系;准备比需要更多的原始素材,意义正在于此。
写作节奏
- 一次追加一个节拍。永远不要超前写。
- 每次写入之前从磁盘重新阅读文章文件。绝对保留用户的编辑。
- 如果用户对之前的节拍做了实质性编辑,让它改变后面的走向。
- 如果用户说"重写那个节拍"或"退回去试试不同的第 3 拍",照做:就地编辑,其余不动。
</supporting-info>
04 同仓库更多 Skills
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。
wayfinder
把一大块工作(超过一个 agent 会话能装下的)规划为 issue 跟踪器上一张由决策 ticket 构成的共享地图,然后一次解决一个,直到通往目的地的路清晰可见。