writing-shape
作者 mattpocockwriting-shape 是一项对话式起草技能，用于把 markdown 原始材料整理成可发布的文章。它适合处理开头选择、按段落展开、结构取舍等工作，适用于技术写作、访谈笔记、录音转写清理和粗稿润色。如果你需要的是有引导的编辑流程，而不是一次性提示词，那么可以用 writing-shape 指南。
这个技能得分 68/100，说明它可以收录，但更适合带着谨慎说明来呈现。目录用户能清楚看到它的用途：通过有引导的对话式流程，把原始 markdown 笔记、转写稿或粗稿整理成可发布文章；但也要预期它主要是纯文本规格，支持资产有限，而且没有安装命令或辅助脚本。
- 触发条件明确：它清楚说明，当用户手里有 markdown 原始材料并希望把它整理成文章时，就应使用这个技能。
- 操作流程清晰：先完整阅读输入，再起草 2–3 个候选开头，然后按段落逐步扩展正文。
- 安装决策价值高：它提醒原始材料文件是只读的，文章应在会话中保存在单独文件里。
- 没有提供支持文件或脚本，因此智能体必须完全依赖 `SKILL.md` 中的说明。
- 仓库处于未完成路径，且缺少示例或参考资料，这会降低对边缘情况和最终润色效果的把握。
writing-shape 技能概览
writing-shape 是一款对话式起草技能，用来把一堆 markdown“素材”逐步整理成可发布的文章，每次只解决一个结构选择。它最适合已经有原始材料、但还需要帮助找角度、开头和最终文章形态的写作者、技术营销人员和编辑。
它适合做什么
当任务不是“从零写一篇”，而是“把这份粗糙材料理顺并串起来”时，就该用 writing-shape。它很适合访谈笔记、转写稿清理、草稿碎片，以及那些在收尾前需要先把叙事线搭起来的技术写作。
它为什么不同
writing-shape 不只是概括原始笔记。它会先让你在几个候选开头里做选择，再在推进过程中一边讨论结构、一边逐段搭建文章。这让它特别适合那些顺序、强调点和格式和事实本身同样重要的写作场景。
最佳适用场景与限制
如果你想从杂乱输入里产出一篇可读的文章，这个技能很适合 Technical Writing；但它不能替代主题判断。如果你只需要不讨论、直接出一版润色文案，通用提示词可能更快；如果你需要一个带引导的编辑流程，writing-shape 才是更合适的安装选择。
如何使用 writing-shape 技能
安装与会话设置
使用 npx skills add mattpocock/skills --skill writing-shape 安装。然后在开启会话时，把原始 markdown 文件和目标文章路径交给它；如果你还没决定，也可以让它帮你选。这个技能默认把源材料当作只读内容处理，并且要求在每次写入前都重新读取文章文件。
需要提供什么输入
writing-shape 最有效的用法，通常要先给三样东西：原始笔记、目标受众，以及希望产出的文章结果。比如，“把这些笔记整理成一篇面向新平台工程师的实用指南”，就比“把它改好一点”更有用，因为前者明确给出了它要优化的论点、读者和细节层级。
建议的工作流
先打开源文件，从头到尾读一遍，再让技能给出 2–3 个候选开头。选择最符合文章真实任务的那个开头，然后按节奏往下推进，一步一步问：读者下一步需要什么？这正是 writing-shape 最有价值的地方：它既能让文章保持锚定，又能在草稿展开时继续调整结构。
先读哪些文件
先打开 SKILL.md，再查看该技能引用的仓库说明文件，比如 README.md、AGENTS.md 和 metadata.json（如果存在的话）。在这个仓库里，真正的核心价值就在 SKILL.md 本身，所以实际决策重点不是“去找隐藏辅助文件”，而是“理解这个起草循环，并把它顺畅地应用到你的内容里”。
writing-shape 技能常见问题
writing-shape 只适用于 markdown 输入吗？
它是围绕 markdown 文件设计的，但这个“素材堆”也可以是转写稿、笔记，或转换成 markdown 的粗糙文本。关键要求是：在开始塑形之前，源材料必须能作为一个完整内容体被读通。
它和普通提示词有什么不同？
普通提示词往往是一次性直接要一篇成稿。writing-shape 走的是迭代式编辑流程：开头选择、段落顺序、格式讨论都会在过程中发生，所以它通常能把杂乱输入整理成更有意图感的文章。
writing-shape 适合新手吗？
适合，只要使用者能提供源材料，并回答几个编辑问题。尤其适合新手“知道自己手头有什么”，但还不清楚该怎么把它组织成一篇有说服力的文章的时候。
什么时候不该用它？
如果内容本来就已经结构紧凑、没有真正需要塑形的素材堆，或者你需要的是一次性摘要而不是逐步成形的文章，就不要用 writing-shape。它最有价值的场景，是草稿还需要决定“长什么样”，而不只是做清理。
如何改进 writing-shape 技能
给它更明确的编辑简报
writing-shape 产出最好的时候，前提是你给了一个清晰的承诺：文章写给谁、解决什么问题、最终要变成什么类型的稿子。如果你能一开始就说清受众和结果，技能就能选出更合适的开头，并让后面的段落始终保持一致。
提供更好的源材料
常见失败原因是素材堆太宽、重复太多，或者混进了无关研究。在调用技能之前，先删掉明显噪音，把最相关的 markdown 片段整理在一起；如果源材料里包含多个主题，也要先把章节标出来。更好的输入能减少分叉过多的草稿，也能让塑形对话更有决断力。
迭代结构，不只是措辞
如果第一版感觉不对，不要只说“把文案写顺一点”。更有效的做法是调整论点、重排内容节奏，或者改变文章形式预期。writing-shape 的提升，通常先来自文章结构的修正，其次才是句子层面的润色。
保留文章文件
因为这个技能要求在每次写入前重新读取文章文档，所以修改应该留在那个文件里，而不是都在聊天里处理。这个习惯能保护用户修改、让协作更安全，也能让 writing-shape 在更长的起草过程中持续发挥作用。