1实现原理 · 为什么它能做到
定位为 exploit 阶段：素材堆固定不变，skill 的任务是选定一条路径并逐 beat 开采素材。
skills/in-progress/writing-beats/SKILL.md
The user has passed (or will pass) a markdown file of raw material. This is **exploit**: the exploring is done, the pile is fixed. Commit to a path through it and mine the pile to fill each beat.
注：explore/exploit 两分法贯穿本仓库 writing 三件套：writing-fragments 是 explore，writing-beats/writing-shape 是 exploit。
交互算法 = choose-your-own-adventure 节拍旅程：先定 prerequisites → 给 2-3 个候选起始 beat 让用户选 → 只写那一拍 → 重读磁盘 → 再给 2-3 个候选 next beats → 循环到自然结尾。
skills/in-progress/writing-beats/SKILL.md
Once the user picks a starting beat, write **only that beat** to the article file. A beat may be one sentence or several paragraphs, whatever that beat naturally is. Stop there.
注：step 4 续：'Re-read the article file from disk. Then offer 2–3 candidate **next beats**: different directions the journey could pivot to from where the article now stands.'——每步用户选路，agent 只写被选中的一拍。
grounding 约束引擎：每个概念在某个 beat 使用前必须已 grounded（读者自带 = prerequisite，或前文 beat 引入）；候选 beat 的可达性由已 grounded 集合决定。
skills/in-progress/writing-beats/SKILL.md
Every **concept** has to be **grounded** before a beat can lean on it: the audience either walked in knowing it or met it in an earlier beat. A beat that reaches for an ungrounded concept loses the reader; that is the one move the journey can't make. The unit is the concept, not the word for it: a beat can lean on an idea the reader lacks even with no jargon in sight.
注：操作化：'Keep a running list of what's grounded so far, and update it each time a beat lands.' grounding 单元是概念而非术语词。
节奏纪律：一次只落一个 beat、绝不超前写；每次写前从磁盘重读文件，绝对保留用户编辑；用户可随时要求重写某一拍。
skills/in-progress/writing-beats/SKILL.md
Append one beat at a time. Never write ahead. Re-read the article file from disk before every write. Preserve user edits absolutely.
注：重读磁盘是把『用户可能手动改过文件』当默认事实处理，防止覆盖。
终点定义：旅程完成即止，而非素材耗尽——大部分素材堆本来就会有剩余碎片。
skills/in-progress/writing-beats/SKILL.md
The article ends when the journey is complete, not when the pile is empty. Most piles will have leftover fragments that don't make it in. That is fine; that is the point of having more raw material than you need.
注：素材是采石场（'The pile is a quarry.'），可 paraphrase/split/recombine/quote。
2核心能力
01从素材生成多条候选起始 beat（不同切入点），标注各自 grounding 的新概念
02每步只写一拍、然后重读磁盘并给 2-3 个可达的下一个候选 beat
03grounding 运行清单：约束每拍只许用已 grounded 概念，落地新概念即解锁后续拍
04素材采石场式复用：paraphrase/split/recombine/quote 随意组合
05就地改拍支持：'rewrite that beat' 只动那一拍，其余不动
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 交互成本高：每拍一轮选择，长文可能需要很多轮用户参与。 — 设计上每拍都停、给候选、等选择——文章越长轮数越多，急性子用户可能觉得拖沓。
- 模型生成的候选分叉质量决定体验 — 候选 starting/next beats 由模型从素材推断，若模型误读素材或 grounding 清单维护出错（漏记已引入概念），可达性判断会失真。
- beta 状态 — in-progress bucket：不入 plugin、无 docs 页、可随时变化或消失。
- 素材注入面 — 素材文件若含不可信文本，模型需区分『素材 = 被加工对象』与指令；无硬隔离，属宿主通用 prompt 处理问题。
风险提醒：蓝色，知晓即可。仅本地文件操作：读用户素材文件、向用户指定的文章文件追加 beat/就地编辑；无脚本、无网络外发、无凭证读取。注意点：写路径完全由用户指定（'ask once and remember the path'），不会自选路径；模型生成的文字需用户审阅。
5第二遍独立确认
- [ok] choose-your-own-adventure 交互流程（候选拍 → 用户选 → 只写一拍 → 重读 → 再候选） — SKILL.md 步骤 1-5 逐字存在：'Write 2–3 candidate **starting beats**'、'write **only that beat**'、'Re-read the article file from disk. Then offer 2–3 candidate **next beats**'。
- [ok] grounding 机制（prerequisite/introduced + 运行清单 + 可达性） — Grounding 整节存在，含 'Keep a running list of what's grounded so far'；候选拍可达性由 grounded 集决定。
- [ok] 只写一拍、不超前 — 'Append one beat at a time. Never write ahead.' 原文在。
- [ok] 每次写前重读磁盘、保留用户编辑 — 'Re-read the article file from disk before every write. Preserve user edits absolutely.' 原文在。
- [ok] 就地重写特定 beat — 'edit in place, leave the rest alone' 原文在。
- [ok] 文件写入范围 — 仅用户指定文章文件；'If the user did not say where to save the article, ask once and remember the path.' 无其它路径指令。
- [ok] 外部依赖为空 — token 扫描零命中；无 CLI/API/网络/包。
- [ok] 元数据 + beta 状态 — GitHub API MIT/257659/2026-09-04；本地 HEAD == 3cca18b；in-progress README 列为 beta。
6结论
适合：适合手头有一堆素材（访谈/笔记/碎片）、想要一篇由『每步可转向』的节拍构成的交互式文章的写作者；尤其适合重视读者认知负担、愿意逐拍打磨的人。
不适合：不适合想一口气拿成稿的用户（逐拍确认很慢）；不适合素材仍需探索收集的阶段（那是 writing-fragments 的 explore 职责）；不适合需要严格大纲/论证结构的论文式写作（本 skill 以旅程与节拍组织，不保证论证树完备）。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-09
方式 A · 人下载镜像包下载 writing-beats.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agente5908f87db6a7beb…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库mattpocock / mattpocock/skills
原始 GitHubmattpocock/skills ↗
Stars257659
最近推送2026-09-04
本 skill commit
3cca18b368许可MIT（GitHub API spdx MIT；仓库根 LICENSE: Copyright (c) 2026 Matt Pocock）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。