1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | writing-shape-mattpocock-skills |
| 作者/维护者 | Matt Pocock（个人开发者，“Total TypeScript”、AI Hero 创始人） |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/in-progress/writing-shape |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 237,498（GitHub API；为 mattpocock/skills 合集仓库整体星数，不代表本技能自身热度） |
| Forks | 20,209（GitHub API，同上，合集整体口径） |
| 最新版本 | v1.2.3（GitHub Releases，发布于 2026-08-06） |
| 安装方式 | 通用安装器选择性安装到任意支持 SKILL.md 的 agent（该技能所在目录尚未被打包进官方一键插件） |
2. 功能介绍与亮点
writing-shape 是一个把“一堆原始素材”打磨成一篇结构清晰的文章的写作技能。它假设前期发散已经完成、素材已经收集齐全，专注解决“怎么排布、怎么论证、怎么收尾”这个后半段问题：
- 通读素材建立全局感——先完整读完用户提供的原始材料文件（笔记、片段、转录稿，格式不限），再动笔；
- 明确读者的前置知识——跟用户逐一确认哪些概念读者“走进来时就该懂”，其余概念必须在文中被引入后才能被后续段落引用，形成一条概念的“接地”链条；
- 同时给出 2-3 个候选开头——每个开头对应不同的论点或切入角度，逼用户选定或融合，开头一旦定下就框定了全文走向；
- 逐段生长——每写完一段就追问“读者接下来需要听到什么”，从素材堆里挖出对应内容，并就格式（一段散文、一个列表、一张表格、一条引用）逐条权衡取舍；
- 边写边落盘——每商定一段就立刻写入文章文件，不批量处理，让文章成形过程对用户可见。
亮点：
- “接地”（grounding）概念链——不是简单地写完就完，而是显式追踪每个概念是否已被读者具备或已被前文引入，避免专业术语突然冒出把读者甩下；
- 格式选择显式化——散文/列表/表格/引用/代码块之间怎么选、为什么选，都要求当场权衡说明，而不是随手排版；
- 原始素材只读不改——把用户的原始笔记当作“矿”,只挖不动,防止打磨过程中悄悄篡改用户本来的记录；
- 隶属于一个持续活跃维护的大型开源技能合集（仓库最近一次提交在 2026-08-24），目录下自带 Codex 适配元数据文件（
agents/openai.yaml）。
3. 适用场景
所属分类：内容创作与知识管理
适用于需要把零散素材整理成一篇完整文章的场景，尤其是：
- 手头已有一堆笔记、语音转录稿或零散段落，希望逐段打磨成一篇能发布的文章；
- 希望在写作过程中被追问“这段是不是在重复”“该用列表还是散文”，而不是自己闷头排版；
- 团队或个人博客、技术文档、内部分享稿等需要交付连贯成文而非草稿堆砌的写作任务。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | SKILL.md 为原生格式，通过通用安装器 npx skills add mattpocock/skills --skill writing-shape 装入个人 skills 目录即可用，无需转换 |
| Codex | 需适配 | 技能目录自带 agents/openai.yaml 适配元数据，是该技能专门做过 Codex 适配层的直接证据；通过通用安装器指定 --agent 参数选装 |
| OpenClaw | 需适配 | SKILL.md 为通用格式，官方安装器面向任意 agent 分发，但未见 OpenClaw 官方原生集成记录 |
| Hermes Agent | 需适配 | 第三方技能目录站点已将其归类收录为 Hermes 可用技能，但未找到 Hermes 官方文档或市场的直接确认记录 |
5. 推荐理由
writing-shape 把“打磨成文”这件事拆成了一套可执行的对话流程，而不是丢给模型一句“帮我润色”：先定读者的知识起点，再用候选开头逼你想清楚论点，然后逐段追问“接下来该说什么、该用什么格式”，边定稿边落盘。它不依赖任何外部服务、不收集也不上传任何数据，纯粹基于对话本身工作，安装门槛低，规则清晰可预期，适合任何需要把素材写成成文文章的场景，不局限于工程写作。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 第三方技能分发平台 skills.sh 显示该子技能独立安装量约 25.99 万次；合集仓库整体星数为 23.7 万，是整个仓库共享的数字，不代表本技能自身热度 |
| 可用性 | 8 | SKILL.md 流程完整、单条指令触发、无需额外配置或付费依赖；仓库最近一次提交在 2026-08-24，本技能内容最近一次实质更新在 2026-08-19；GitHub 按标题检索唯一相关的一条 issue 已处于关闭状态（当初的“上线”跟踪条目），当前无任何未关闭的功能性问题记录 |
| 安全性 | 7 | 纯提示词/对话流程技能，不执行任何 shell 命令、不联网外发、不涉及任何凭据，人工通读全文未见可疑指令；但第三方自动化安全审计平台 Snyk 对该技能给出 Fail 状态（另两项审计 Gen Agent Trust Hub、Socket 均为 Pass），页面未展开具体触发原因，作为未解的审计风险信号计入 |
安全检查清单： ① Shell 命令与权限范围：无，纯对话式写作流程，不执行任何脚本或命令 ② 联网外发：无 ③ API Key/凭据：不涉及 ④ 可疑指令：人工通读全文未见任何要求模型执行无关操作或外发数据的迹象；第三方自动化审计平台 Snyk 对本技能标记为 Fail（Gen Agent Trust Hub、Socket 均为 Pass），具体触发原因未公开 ⑤ 作者信誉：Matt Pocock，个人开发者，“Total TypeScript” 系列课程与 AI Hero 创始人，无造假迹象 ⑥ License：MIT，明确 ⑦ 最近维护：仓库整体 2026-08-24 有提交，本技能内容最近一次改动 2026-08-19
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 差异点 |
|---|---|---|
| writing-shape（本技能） | 对话式技能，把已收集齐的素材逐段打磨成结构化文章，显式追踪概念“接地”链 | 免费开源，专注“素材→成文”这一后半段，不涉及前期发散或选题 |
| Humanizer | 去除 AI 生成文本的痕迹，让已写好的文本读起来更像人写的 | 处理的是“文字已经写完、要改语感”，而 writing-shape 处理的是“文字还没写出来、要定结构” |
| writing-fragments / writing-beats（同仓库其余写作子技能） | 分别负责“从素材生成待打磨的片段”与“把片段串成初稿路径” | 三者是同一条写作管线里的前两站，writing-shape 是管线里“定稿成文”的最后一站，可以独立使用，也可以承接前两者的产出 |
差异化总结：多数写作辅助工具止步于“帮我润色这段话”，writing-shape 的核心壁垒是把“这段该不该存在”“该用什么格式”这类结构性决定显式摆到台面上讨论，而不是模型自己悄悄拍板。
8. 用户评价
该技能目前在第三方平台尚无独立的具名用户评价，仅见作者本人在公开社交媒体上提及将其作为个人写作工作流的一部分持续使用。
9. 其他补充
本技能是 mattpocock/skills 开源技能合集的一部分，随原仓库更新节奏一起演进；通过通用安装器安装后，npx skills update 可拉取该技能的最新版本。
10. 安装使用方式
Claude Code / Codex / OpenClaw / 其他支持 SKILL.md 的 agent（通用安装器）：
npx skills@latest add mattpocock/skills --skill writing-shape也可以直接把 skills/in-progress/writing-shape/SKILL.md 复制进对应 agent 的个人 skills 目录手动安装。
触发方式：准备好一份原始素材的 Markdown 文件后调用 /writing-shape，并告知素材文件路径；技能会先通读全文，再进入逐段打磨流程。安装后无需重启 agent 即可使用。
11. 注意事项
- 该技能位于仓库的
in-progress（进行中）目录，尚未被打包进作者官方发布的一键插件包，需通过通用安装器或手动复制安装； - 是一个纯对话式流程技能，最终成文质量高度依赖用户在候选开头与格式权衡环节的参与和判断，不是“一键生成终稿”；
- 属于
mattpocock/skills合集仓库的一部分，仓库内还有其余二十余个工程与写作类技能，可按需单独选装。
修订说明（2026-08-26）：初次发布时安全性评分未核对第三方审计平台 Snyk 的检测结果，误评为 9 分；复核确认 Snyk 对本技能标记为 Fail 后，安全性订正为 7 分，综合评分由 8.3 调整为 7.7（仍达到本站收录标准）。