从素材堆到成稿skills13 仓库 writing-shape 技能的逐段塑形写作方法论【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills本文解析 skills13/skills 仓库in-progress桶中writing-shape技能的核心思想如何把一份原始素材堆零散片段、非结构化的成段文字甚至逐字稿加工成一篇结构自洽的文章而且是一段一段地塑形、每一步都与人争论格式选择。读完你将掌握一套explore探索已完成、进入 exploit开采阶段的成稿流程概念必须先落地grounding、开头候选必须给多个、每写一段都要回答读者下一步需要听到什么。这套方法适用于任何想用 Agent 辅助产出高质量长文写作的工作流其姊妹技能 writing-fragments采集素材与 writing-beats逐节推进分别覆盖了它前后的写作阶段。一、技能定位explore 结束之后的 exploitwriting-shape在技能自身的description中把自己定义为一句话Writing, exploit: shape raw material into an article, paragraph by paragraph.写作、开采把原始素材塑形成一篇文章一段一段来。它的启动方式很特别frontmatter 里带有disable-model-invocation: true对应的 agents/openai.yaml 中还有policy.allow_implicit_invocation: false。按照仓库 AGENTS.md 与 SKILL-MECHANICS.md 的约定这意味着它是一个**纯用户手动调用user-invoked**的技能模型不能自动触发只能由人类输入技能名来唤起代价是不占用任何常驻 context 预算收益是它只在需要时被加载。writing-shape的输入约定很宽松用户已经传入或将传入一个 markdown 原始素材文件无论内容是一份整齐的片段清单、一堵无结构的散文墙还是一份对话逐字稿格式不重要技能要求在任何其他动作之前先把整个文件从头到尾读完。关键的分工在文档开头就划清这是exploit开采/榨取。探索已经做完素材堆已经固定承诺一个结构然后开采这个堆去填充它。与之相对的是 writing-fragments 的定位那是一个纯explore探索技能负责在还没决定结构的阶段通过拷问式访谈榨出零散片段fragments并强调承诺结构是另一个技能的工作。也就是说writing-fragments负责产出素材raw materialwriting-shape负责把素材变成文章二者构成写作流水线的上下游。[!NOTE] 本技能对素材文件是只读的文档明确写道 Do not edit the raw material file: it is read-only to this skill.不要编辑原始素材文件它对本技能是只读的。如果用户没有指定文章保存路径技能只问一次并记住该路径。二、核心循环The loop六步逐段生长技能的骨架是一个六步循环强调不批量、逐块落地读素材堆Read the pile完整读入输入文件对里面有什么形成整体感知。确立前置条件Establish the prerequisites与用户敲定读者进门时已经知道什么即一开始就grounded已落地的概念集合。其余一切概念都必须由某个 block块先落地后续 block 才能依赖它。起草 2~3 个候选开头Draft 2–3 candidate openings每个开头都应暗示文章的不同论点或切入角度全部展示给用户强制用户挑选或合成一个混合版。被选中的开头定义了整篇文章剩余部分必须完成的事。逐段生长Grow paragraph by paragraph开头落地后问给定这个开头读者接下来需要听到什么从素材堆中取料回答。下一个 block 只能依赖已落地的概念并在落地时引入新的概念。同时争论下一个 block 采用什么形式段落、列表、表格、callout、引用还是代码块每一种格式选择都必须是刻意的、可辩护的。边写边追加Append to the article file as you go不要批量。每个达成一致的段落或 block 立即写入让用户能看到文章逐步成形。循环第 4 步直到文章完成由用户决定何时算完成。这六步的闭环体现了以用户为决策者的设计候选开头要用户选、每段形式要用户认可、收尾时机要用户定Agent 只负责提问、取料、起草与争论。三、Grounding概念落地机制文章的可读性地基Grounding是本文档中最核心的理论概念它的表述非常严谨每个概念在某个 block 依赖它之前必须被落地grounded读者要么进门时就知道它要么在更早的 block 里见过它。一个 block 伸手去够一个未落地的概念就会失去读者。注意其单位是概念而不是词一个 block 可能依赖读者缺失的某个想法即使通篇没有任何术语。当概念有名字即术语时落地意味着把想法和术语一起交付。概念只有两种落地方式Prerequisite前置条件在开头之前就已落地读者自带一开始就固定。Introduced引入某个 block 建立它从那时起它对文章剩余部分保持落地。技能要求持续维护一份已落地清单。当问读者下一步需要听到什么时如果下一个动作需要某个未落地的概念那么这个未落地概念本身就是答案要么先落地它在这里或在更早的 block否则这个动作做不了。文档把这种机制称为 gap-naming给缺口命名并指出它是 Pulling from the pile从素材堆取料的上一层抽象在取料那一层缺口是素材堆缺材料在这里缺口是文章缺一块地基。杠杆点在于你决定把什么设为 prerequisite、把什么留在文章内部落地。前置要求太多会把读者挡在门外内部落地太多会让开头淹没在定义里。这个权衡要与用户在确立前置条件时一并敲定。四、对话感Conversational feel被倒置的 grilling 会话writing-shape把自身定位为一次被倒置的 grilling 会话This is a grilling session inverted。仓库中 grilling 技能是一种设计树 轮次 前沿frontier的拷问式访谈每轮问完整个前沿的所有问题、给出推荐答案、等用户回答后再重算前沿。writing-shape借用了这种坚持追问、拒绝敷衍的态度但问题从你实际注意到的是什么ideation 阶段换成这篇文章实际上在论证什么读者需要按什么顺序听到它其要求非常强硬Push back反驳。拒绝让薄弱过渡蒙混过关。如果一个段落不配占位就删掉它。文档给出了一套可持续使用的具体追问话术这些句子本身就是可复用的写作检查清单这个段落为读者做了上一段没做的事如果我砍掉它什么会坏掉这是散文还是应该做成列表为什么用散文这个句子在干两件事拆开它或者只留一件。开头承诺了 X我们飘到 Y 了。要么重新穿回这条线要么改开头。最后一条尤其重要它把文章视作承诺-兑现结构任何偏离开头论点的段落都必须被纠正或让开头被改写。五、从素材堆取料Pulling from the pile采石场而非剧本文档用一个清晰的隐喻框定素材与文章的关系把原始素材当作采石场quarry而不是剧本script。取一段素材重写它以适应周边段落再放进去一个片段可以拆散到多个段落、与其他片段合并、或者被转述素材堆的职责是被开采文章的职责是读起来像一个声音read as one voice。如果素材堆缺少文章需要的东西不能去外面挖新片段这属于 out of scope而要显式地点名这个缺口这里需要一个例子但素材堆里没有。现在给我一个否则我们就砍掉这一节。这种点名缺口机制保证了成稿过程要么被素材支撑要么明确降级绝不靠编造填充。六、要真正去吵的格式权衡Format arguments to actually have文档明确要求当决定如何渲染一个 block 时要当着用户的面权衡这些取舍而不是默默决定。五组权衡构成了一套形式选择决策表权衡维度决策规则散文 vs. 列表散文承载论证argument列表承载平行条目parallel items。条目不真正平行就用散文真正平行则列表扫读更快。行内 vs. callout提示、警告、旁注放进 callout [!TIP]、 [!NOTE]但仅当它们真会打断行内主论证时否则留在行内。表格 vs. 重复结构同一形状以同字段重复 3 次以上 → 表格否则用带加粗引子的散文。引用 vs. 转述原文措辞本身就是要点 → 引用只有想法重要 → 转述。代码块 vs. 行内代码多行、可运行或说明性内容 → 代码块单个 token 或标识符 → 行内。这张表在 writing-shape/SKILL.md 中是作为格式争论的实战工具存在的而它背后的理念与仓库 writing-for-agents 文档中leading word主导词、信息层级information hierarchy等写作杠杆一脉相承写作不是排版而是每一次渲染选择都在影响读者的注意力与理解成本。七、写作节奏Writing rhythm永远先重读磁盘上的文件关于落盘技能的规定非常严格直接呼应了writing-fragments中的同款纪律每敲定一个 block 就追加到文章文件每次写入前都从磁盘重读文件用户可能在上轮之后编辑过绝不能盲目覆盖Never overwrite blindly如果用户要求重写某个段落就地编辑那一段其余部分保持不动。这意味着技能默认了人类随时会干预的真实协作场景文章文件是共享画布Agent 的每次写入都应以磁盘当前状态为基准。八、明确的范围边界Out of scope文档以三条否定清单收尾防止技能越界不挖素材堆之外的新片段缺口按Pulling from the pile一节的方式处理即点名并让用户提供或删除该节不编辑原始素材文件不做发布、不为特定平台排版、不添加用户没要求的前置元数据frontmatter。这三条边界与技能纯用户调用、专注塑形的定位完全一致它只负责从固定素材到文章文件这一段。九、仓库上下文它在写作技能家族中的位置把writing-shape放回仓库全景中能更清楚地看到它的设计意图上游 writing-fragmentsexplore 阶段访谈产出异构片段并追加进一个素材文件不承诺任何结构并特别强调leading word主导词是最有价值的片段——给一个反复出现的想法造一个词会在整个 exploit 阶段持续回报结构、过渡与标题。姊妹技能 writing-beats同为 exploit 阶段但它用逐拍beat旅程 选择你自己的冒险的方式组织文章同样有完整的 Grounding 章节概念必须先落地一拍只能依赖已落地概念候选下一拍必须从当前已落地集合可达。两者对比writing-beats以拍为推进单位、每次给 2~3 个候选下一拍writing-shape以block为单位、每次都争论格式形式。上游方法论 grilling提供了设计树、轮次、前沿、给推荐答案的追问框架writing-shape的对话感即其倒置应用。元写作理论 writing-for-agents整个仓库文档写作的共同底层grounding概念与其中每一步都以完成判据收尾单一事实来源前置词等原则互相印证。从 in-progress/README.md 可以看到in-progress桶是公开的 beta 技能公开存在是有意的欢迎试用并反馈问题它们被排除在插件和顶层 README 之外不提供文档页随时可能变更或消失。如果你希望试用由于它不在插件内置集合中需手动安装npx skillslatest add mattpocock/skills --skillwriting-shape十、小结一段一段地让文章自己长出形状writing-shape提供了一套可操作、可辩护、强协作的成稿流程六步循环保证文章逐段生长Grounding 机制保证每一步读者都跟得上对话感保证每一段都挣到了自己的位置采石场取料保证素材被物尽其用而不被神化五组格式权衡保证每个渲染决策都经过思考。它既是一份 Agent 技能说明书也是一份可以独立使用的技术写作方法论清单——即使不借助任何 Agent用先定前置概念 → 多候选开头 → 逐段论证形式 → 每段必须挣到位置这套纪律去写长文也能显著提升文章的结构完整度与读者体验。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从素材堆到成稿：skills13 仓库 writing-shape 技能的逐段塑形写作方法论
从素材堆到成稿skills13 仓库 writing-shape 技能的逐段塑形写作方法论【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills本文解析 skills13/skills 仓库in-progress桶中writing-shape技能的核心思想如何把一份原始素材堆零散片段、非结构化的成段文字甚至逐字稿加工成一篇结构自洽的文章而且是一段一段地塑形、每一步都与人争论格式选择。读完你将掌握一套explore探索已完成、进入 exploit开采阶段的成稿流程概念必须先落地grounding、开头候选必须给多个、每写一段都要回答读者下一步需要听到什么。这套方法适用于任何想用 Agent 辅助产出高质量长文写作的工作流其姊妹技能 writing-fragments采集素材与 writing-beats逐节推进分别覆盖了它前后的写作阶段。一、技能定位explore 结束之后的 exploitwriting-shape在技能自身的description中把自己定义为一句话Writing, exploit: shape raw material into an article, paragraph by paragraph.写作、开采把原始素材塑形成一篇文章一段一段来。它的启动方式很特别frontmatter 里带有disable-model-invocation: true对应的 agents/openai.yaml 中还有policy.allow_implicit_invocation: false。按照仓库 AGENTS.md 与 SKILL-MECHANICS.md 的约定这意味着它是一个**纯用户手动调用user-invoked**的技能模型不能自动触发只能由人类输入技能名来唤起代价是不占用任何常驻 context 预算收益是它只在需要时被加载。writing-shape的输入约定很宽松用户已经传入或将传入一个 markdown 原始素材文件无论内容是一份整齐的片段清单、一堵无结构的散文墙还是一份对话逐字稿格式不重要技能要求在任何其他动作之前先把整个文件从头到尾读完。关键的分工在文档开头就划清这是exploit开采/榨取。探索已经做完素材堆已经固定承诺一个结构然后开采这个堆去填充它。与之相对的是 writing-fragments 的定位那是一个纯explore探索技能负责在还没决定结构的阶段通过拷问式访谈榨出零散片段fragments并强调承诺结构是另一个技能的工作。也就是说writing-fragments负责产出素材raw materialwriting-shape负责把素材变成文章二者构成写作流水线的上下游。[!NOTE] 本技能对素材文件是只读的文档明确写道 Do not edit the raw material file: it is read-only to this skill.不要编辑原始素材文件它对本技能是只读的。如果用户没有指定文章保存路径技能只问一次并记住该路径。二、核心循环The loop六步逐段生长技能的骨架是一个六步循环强调不批量、逐块落地读素材堆Read the pile完整读入输入文件对里面有什么形成整体感知。确立前置条件Establish the prerequisites与用户敲定读者进门时已经知道什么即一开始就grounded已落地的概念集合。其余一切概念都必须由某个 block块先落地后续 block 才能依赖它。起草 2~3 个候选开头Draft 2–3 candidate openings每个开头都应暗示文章的不同论点或切入角度全部展示给用户强制用户挑选或合成一个混合版。被选中的开头定义了整篇文章剩余部分必须完成的事。逐段生长Grow paragraph by paragraph开头落地后问给定这个开头读者接下来需要听到什么从素材堆中取料回答。下一个 block 只能依赖已落地的概念并在落地时引入新的概念。同时争论下一个 block 采用什么形式段落、列表、表格、callout、引用还是代码块每一种格式选择都必须是刻意的、可辩护的。边写边追加Append to the article file as you go不要批量。每个达成一致的段落或 block 立即写入让用户能看到文章逐步成形。循环第 4 步直到文章完成由用户决定何时算完成。这六步的闭环体现了以用户为决策者的设计候选开头要用户选、每段形式要用户认可、收尾时机要用户定Agent 只负责提问、取料、起草与争论。三、Grounding概念落地机制文章的可读性地基Grounding是本文档中最核心的理论概念它的表述非常严谨每个概念在某个 block 依赖它之前必须被落地grounded读者要么进门时就知道它要么在更早的 block 里见过它。一个 block 伸手去够一个未落地的概念就会失去读者。注意其单位是概念而不是词一个 block 可能依赖读者缺失的某个想法即使通篇没有任何术语。当概念有名字即术语时落地意味着把想法和术语一起交付。概念只有两种落地方式Prerequisite前置条件在开头之前就已落地读者自带一开始就固定。Introduced引入某个 block 建立它从那时起它对文章剩余部分保持落地。技能要求持续维护一份已落地清单。当问读者下一步需要听到什么时如果下一个动作需要某个未落地的概念那么这个未落地概念本身就是答案要么先落地它在这里或在更早的 block否则这个动作做不了。文档把这种机制称为 gap-naming给缺口命名并指出它是 Pulling from the pile从素材堆取料的上一层抽象在取料那一层缺口是素材堆缺材料在这里缺口是文章缺一块地基。杠杆点在于你决定把什么设为 prerequisite、把什么留在文章内部落地。前置要求太多会把读者挡在门外内部落地太多会让开头淹没在定义里。这个权衡要与用户在确立前置条件时一并敲定。四、对话感Conversational feel被倒置的 grilling 会话writing-shape把自身定位为一次被倒置的 grilling 会话This is a grilling session inverted。仓库中 grilling 技能是一种设计树 轮次 前沿frontier的拷问式访谈每轮问完整个前沿的所有问题、给出推荐答案、等用户回答后再重算前沿。writing-shape借用了这种坚持追问、拒绝敷衍的态度但问题从你实际注意到的是什么ideation 阶段换成这篇文章实际上在论证什么读者需要按什么顺序听到它其要求非常强硬Push back反驳。拒绝让薄弱过渡蒙混过关。如果一个段落不配占位就删掉它。文档给出了一套可持续使用的具体追问话术这些句子本身就是可复用的写作检查清单这个段落为读者做了上一段没做的事如果我砍掉它什么会坏掉这是散文还是应该做成列表为什么用散文这个句子在干两件事拆开它或者只留一件。开头承诺了 X我们飘到 Y 了。要么重新穿回这条线要么改开头。最后一条尤其重要它把文章视作承诺-兑现结构任何偏离开头论点的段落都必须被纠正或让开头被改写。五、从素材堆取料Pulling from the pile采石场而非剧本文档用一个清晰的隐喻框定素材与文章的关系把原始素材当作采石场quarry而不是剧本script。取一段素材重写它以适应周边段落再放进去一个片段可以拆散到多个段落、与其他片段合并、或者被转述素材堆的职责是被开采文章的职责是读起来像一个声音read as one voice。如果素材堆缺少文章需要的东西不能去外面挖新片段这属于 out of scope而要显式地点名这个缺口这里需要一个例子但素材堆里没有。现在给我一个否则我们就砍掉这一节。这种点名缺口机制保证了成稿过程要么被素材支撑要么明确降级绝不靠编造填充。六、要真正去吵的格式权衡Format arguments to actually have文档明确要求当决定如何渲染一个 block 时要当着用户的面权衡这些取舍而不是默默决定。五组权衡构成了一套形式选择决策表权衡维度决策规则散文 vs. 列表散文承载论证argument列表承载平行条目parallel items。条目不真正平行就用散文真正平行则列表扫读更快。行内 vs. callout提示、警告、旁注放进 callout [!TIP]、 [!NOTE]但仅当它们真会打断行内主论证时否则留在行内。表格 vs. 重复结构同一形状以同字段重复 3 次以上 → 表格否则用带加粗引子的散文。引用 vs. 转述原文措辞本身就是要点 → 引用只有想法重要 → 转述。代码块 vs. 行内代码多行、可运行或说明性内容 → 代码块单个 token 或标识符 → 行内。这张表在 writing-shape/SKILL.md 中是作为格式争论的实战工具存在的而它背后的理念与仓库 writing-for-agents 文档中leading word主导词、信息层级information hierarchy等写作杠杆一脉相承写作不是排版而是每一次渲染选择都在影响读者的注意力与理解成本。七、写作节奏Writing rhythm永远先重读磁盘上的文件关于落盘技能的规定非常严格直接呼应了writing-fragments中的同款纪律每敲定一个 block 就追加到文章文件每次写入前都从磁盘重读文件用户可能在上轮之后编辑过绝不能盲目覆盖Never overwrite blindly如果用户要求重写某个段落就地编辑那一段其余部分保持不动。这意味着技能默认了人类随时会干预的真实协作场景文章文件是共享画布Agent 的每次写入都应以磁盘当前状态为基准。八、明确的范围边界Out of scope文档以三条否定清单收尾防止技能越界不挖素材堆之外的新片段缺口按Pulling from the pile一节的方式处理即点名并让用户提供或删除该节不编辑原始素材文件不做发布、不为特定平台排版、不添加用户没要求的前置元数据frontmatter。这三条边界与技能纯用户调用、专注塑形的定位完全一致它只负责从固定素材到文章文件这一段。九、仓库上下文它在写作技能家族中的位置把writing-shape放回仓库全景中能更清楚地看到它的设计意图上游 writing-fragmentsexplore 阶段访谈产出异构片段并追加进一个素材文件不承诺任何结构并特别强调leading word主导词是最有价值的片段——给一个反复出现的想法造一个词会在整个 exploit 阶段持续回报结构、过渡与标题。姊妹技能 writing-beats同为 exploit 阶段但它用逐拍beat旅程 选择你自己的冒险的方式组织文章同样有完整的 Grounding 章节概念必须先落地一拍只能依赖已落地概念候选下一拍必须从当前已落地集合可达。两者对比writing-beats以拍为推进单位、每次给 2~3 个候选下一拍writing-shape以block为单位、每次都争论格式形式。上游方法论 grilling提供了设计树、轮次、前沿、给推荐答案的追问框架writing-shape的对话感即其倒置应用。元写作理论 writing-for-agents整个仓库文档写作的共同底层grounding概念与其中每一步都以完成判据收尾单一事实来源前置词等原则互相印证。从 in-progress/README.md 可以看到in-progress桶是公开的 beta 技能公开存在是有意的欢迎试用并反馈问题它们被排除在插件和顶层 README 之外不提供文档页随时可能变更或消失。如果你希望试用由于它不在插件内置集合中需手动安装npx skillslatest add mattpocock/skills --skillwriting-shape十、小结一段一段地让文章自己长出形状writing-shape提供了一套可操作、可辩护、强协作的成稿流程六步循环保证文章逐段生长Grounding 机制保证每一步读者都跟得上对话感保证每一段都挣到了自己的位置采石场取料保证素材被物尽其用而不被神化五组格式权衡保证每个渲染决策都经过思考。它既是一份 Agent 技能说明书也是一份可以独立使用的技术写作方法论清单——即使不借助任何 Agent用先定前置概念 → 多候选开头 → 逐段论证形式 → 每段必须挣到位置这套纪律去写长文也能显著提升文章的结构完整度与读者体验。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考