writing-beats-mattpocock-skills

1. 基本信息

项目	内容
名称	writing-beats-mattpocock-skills
作者/维护者	Matt Pocock（mattpocock）
来源链接	https://github.com/mattpocock/skills/tree/main/skills/in-progress/writing-beats
许可证	MIT（数据来自 GitHub API）
GitHub Stars	231,942（整个合集仓库层面，数据来自 GitHub API；该数字属整个仓库，不代表本技能自身热度）
Forks	19,801（数据来自 GitHub API）
最新版本	无独立版本号；仓库最近一次提交 2026-08-21（数据来自 GitHub API）
安装方式	`npx skills@latest add mattpocock/skills --skill=writing-beats`

writing-beats 是一个“从素材到初稿”的成文技能：拿到一份已经收集好的原始素材文件后，以类似“多重结局”小说的方式，把文章拆成一个个“拍子”（beat），每次只写一拍，写完再基于当前进度提出几个可能的下一拍方向，由用户挑选，如此循环直到文章自然收尾。

核心亮点：

“扎根”（grounding）机制：技能要求先与用户约定读者已知的前提概念，此后每一拍只能依赖已经“扎根”过的概念，新概念必须先被某一拍引入才能被后续拍子使用——用一套显式规则防止文章突然跳到读者跟不上的地方
多重结局式写作：每一步只呈现 2-3 个候选下一拍供用户挑选，而不是一次性生成整篇初稿，让作者始终掌握结构走向
拍子颗粒度自适应：一拍可以是一句话，也可以是几段完整的例证，技能明确要求“如果一拍需要五段和三个小标题，那它其实是两拍粘在一起”，避免拍子过度臃肿
只追加不覆盖：每次写入前重新从磁盘读取文章文件，保留用户的手动修改，绝不静默覆盖

固定分类：内容创作与知识管理

适合已经积累了一批素材（笔记、片段、案例），但不知道如何组织成一篇有清晰脉络的文章的写作者，尤其是长文、技术博客作者。典型场景：手头有一堆想法碎片，希望在保持对结构控制权的前提下，一步步试探不同的行文方向，而不是让 AI 一次性吐出整篇定稿。

Claude Code：原生支持 ✅。技能带 disable-model-invocation: true，需用户手动触发（如 /writing-beats），不会被模型自动调用
Codex：原生支持 ✅。该技能目录下带有独立的 agents/openai.yaml 适配文件（声明 display_name/short_description/allow_implicit_invocation），是仓库为 Codex 专门维护的直接证据，而非仅凭 SKILL.md 规范通用性推断
OpenClaw：原生支持 ✅。官方文档明确其技能系统与 Claude Code 使用同一套 SKILL.md 标准，多数技能无需改动即可跨用
Hermes Agent：需适配 ⚠️。frontmatter 仅含 name/description（Hermes 规范必填项均已满足），但仓库未提供 Hermes 专属安装清单，需手动复制技能目录

它把“素材成文”这一步拆成可控的分支叙事过程，用“扎根”规则保证读者始终跟得上文章的概念递进，同时让作者在每一拍都能挑选下一步方向而不是被迫接受一整篇定稿。逻辑自包含、无外部依赖、三项第三方安全审计全部通过。

维度	分数	说明
受欢迎程度	8	第三方平台 skills.sh 显示安装量 242,900+ 次；仓库整体 231,942 星不计入子技能个体热度；作者本人在 X 上公开介绍过该技能所属的写作三部曲，但尚未见独立于安装量之外的跨平台第三方评测
可用性	9	一条命令安装；SKILL.md 自包含、逻辑与示例完整；所属仓库近日仍在更新（最近一次提交 2026-08-21）；无付费依赖；唯一瑕疵是作者明确标注该技能处于 beta（“in-progress”）阶段，无独立文档页
安全性	9	纯提示词/交互类技能，只做“读取磁盘文件、与用户对话、追加写入本地 Markdown 文件”，无 shell 命令执行、无外部程序安装、无联网外发、无需 API key；License 明确；三项第三方自动化审计（Gen Agent Trust Hub / Socket / Snyk）全部通过；GitHub 仅命中 1 条已关闭的发布追踪 issue，无未修复缺陷

综合评分：8.67

技能	定位	与本技能的差异
writing-fragments	从零开始，通过持续追问采集零散写作素材	处理“素材还不存在”的更早期阶段；本技能要求素材已经就绪，是它的下游承接者
writing-shape	把一份素材文件逐段打磨成文，每步都要论证格式取舍	更偏后期的逐段精修与格式论证；本技能偏前期的整体叙事路径选择，产出的是初稿而非成稿
Humanizer	把已有的 AI 生成文本改写得更自然	作用于文字已经写好之后的语感打磨；本技能作用于连初稿都还没有的成文阶段

同一仓库内，作者本人公开描述过 writing-fragments → writing-beats → writing-shape 是一条完整流水线：先采集素材，再用本技能找出一条叙事路径写出初稿，最后逐段打磨定稿，三者互补而非替代。

该技能目前在第三方平台尚无独立于安装量统计之外的具名用户评价。

作者 Matt Pocock 在其 X（原 Twitter）账号上公开介绍过 writing-fragments / writing-beats / writing-shape 这一写作三部曲的更新，将三者并列描述为“素材采集 → 找路径成初稿 → 逐段打磨”的完整链条。

该技能位于仓库的 in-progress（测试）分支：作者刻意公开它以收集试用反馈，未进入官方插件清单与主 README 索引，也没有独立文档页，未来可能变更或下线而不预先通知。

通用安装器（推荐）：npx skills@latest add mattpocock/skills --skill=writing-beats
手动安装：从仓库目录下载 SKILL.md，放入对应 agent 的技能目录（如 Claude Code 的 .claude/skills/writing-beats/）
安装后需手动触发（disable-model-invocation: true，不会被模型自动调用）；若用户未指定文章保存路径，首次使用时会询问一次并记住