[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AV2B8WFCKB3B8KVBYPVA3N":3,"skill-same:01M7AV2B8WFCKB3B8KVBYPVA3N":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":6,"updatedAt":32,"install":33,"resources":45},"01M7AV2B8WFCKB3B8KVBYPVA3N","writing-shape",null,"写作之 exploit：把原始素材塑形成一篇文章，逐段进行。","muscaestar\u002Fskills","muscaestar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F34506351?v=4","01M7ATZNAAQJBTZZXCPKAWJQTH","Musca","01M7ATZNBG6JAV06HKBCBPM152",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-shape\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: writing-shape\ndescription: \"写作之 exploit：把原始素材塑形成一篇文章，逐段进行。\"\ndisable-model-invocation: true\ncommit_version: 5c89081d4bbeb3d039a42093653f90bb698d780e\n---\n\n\u003Cwhat-to-do>\n\n用户已经（或将会）传入一个装满原始素材的 markdown 文件。把它当作输入素材堆：可以是一叠整齐的碎片清单、一墙无结构的散文，或一份转录稿。格式不重要。在做任何其他事之前，端到端读完它。\n\n然后运行一场塑形会话，产出一篇独立的文章文档。这是 **exploit**：探索已经完成，素材堆已经固定：锁定一个结构，开采素材堆来填充它。不要编辑原始素材文件：对本技能来说它是只读的。\n\n如果用户没说文章保存在哪里，问一次并记住路径。\n\n\u003C\u002Fwhat-to-do>\n\n\u003Csupporting-info>\n\n## 循环\n\n1. **读素材堆。** 完整阅读输入文件。形成对其中内容的整体感觉。\n2. **确立先备概念。** 与用户敲定读者进场时知道什么：从一开始就**已落地（grounded）**的概念。其余一切都必须先由某个块落地，之后的块才能倚赖它。见[落地](#落地)。\n3. **起草 2–3 个候选开篇。** 每个开篇应暗示文章不同的论点或角度。全部展示出来。迫使用户挑选或组合出混合体。选定的开篇定义了文章其余部分必须做什么。\n4. **逐段生长。** 开篇落定后，问\"有了这个开篇，读者接下来需要听到什么？\"从素材堆取材来回答。下一个块只能倚赖已落地的概念，并在落地时落地新概念。就下一个块采取的形式展开争论：一个段落、一个列表、一个表格、一个 callout、一段引文、一个代码块。每个格式选择都应该是有意的、可辩护的。\n5. **边进行边追加到文章文件。** 不要攒批。每个商定好的段落或块立即写入，让用户看到文章逐渐成形。\n6. **循环第 4 步直到文章完成。** 由用户决定何时完成。\n\n## 落地\n\n每个**概念**都必须在块倚赖它之前**落地**：读者要么进场时就知道它，要么在更早的块中遇见了它。一个伸向未落地概念的块会丢掉读者。单位是概念，不是它的用词：哪怕一个行话都没有，一个块也可能倚赖读者不具备的想法。当一个概念有名字（一个**术语**），落地它意味着把想法和术语一起落定。\n\n概念通过两种方式之一落地：\n\n- **先备（Prerequisite）**：在开篇之前落地。读者自带。开头定死。\n- **引入（Introduced）**：某个块确立它，从此它对文章其余部分都已落地。\n\n维护一份已落地概念的流动清单。当你问\"读者接下来需要听到什么？\"时，下一步动作需要的某个未落地概念本身就是答案：先落地它（在这里或在更早的块中），否则你无法做出这个动作。这是[从素材堆取材](#从素材堆取材)的\"命名缺口\"在更高一层的样子：那里是素材堆缺材料；这里是文章缺地基。\n\n杠杆是你把什么设为先备、什么放在文中落地。upfront 要求太多会把读者拒之门外；在文中落地太多，开篇会淹没在定义里。确立先备概念时与用户敲定这个平衡。\n\n## 对话的感觉\n\n这是一场反转的 grilling 会话。在构思阶段，问题是\"你实际注意到了什么？\"；在这里是\"这篇文章实际在论证什么，读者需要以什么顺序听到它？\"要顶回去。拒绝让软弱的过渡蒙混过关。如果一个段落配不上它的位置，砍掉它。\n\n要持续使用的具体动作：\n\n- \"这个段落为读者做了什么上一段没做的事？\"\n- \"如果我砍掉这个，什么会崩？\"\n- \"这是散文，还是应该是列表？为什么是散文？\"\n- \"这个句子在做两份工：拆开它，或者选一份。\"\n- \"开篇承诺了 X。我们已经漂到了 Y。要么重新穿线，要么改开篇。\"\n\n## 从素材堆取材\n\n把原始素材当作采石场，而不是剧本。取出一块碎片，改造它以适应周围的段落，然后放置它。一块碎片可能被拆到多个段落中、与另一块合并，或被转述。素材堆的工作是被开采；文章的工作是读起来像一个人的声音。\n\n如果素材堆缺了文章需要的东西，显式命名缺口：\"We need an example here and the pile doesn't have one. Give me one now or we cut this section.\"\n\n## 真正要展开的格式争论\n\n选择如何呈现一个块时，与用户把这些取舍大声权衡，而不是默默决定：\n\n- **散文 vs. 列表。** 散文承载论证；列表承载并列项。如果各项并非真正并列，散文更好。如果真并列，列表浏览起来更快。\n- **行内 vs. callout。** 提示、警告和题外话放进 callout（`> [!TIP]`、`> [!NOTE]`），但仅当它们放在行内真的会打岔主要论证时。否则留在行内。\n- **表格 vs. 重复结构。** 如果同样的形状以同样的字段重复 3 次以上，用表格。否则用加粗领头的散文。\n- **引用 vs. 转述。** 当原始措辞本身就是重点时引用。只有想法重要时转述。\n- **代码块 vs. 行内代码。** 多行、可运行或有示意性 → 代码块。单个 token 或标识符 → 行内。\n\n## 写作节奏\n\n每个块商定后就追加到文章文件。每次写入之前从磁盘重新阅读文件：用户可能在轮次之间做了编辑。永远不要盲目覆盖。如果用户想重写某个段落，就地编辑那个特定段落；其余不动。\n\n## 范围之外\n\n- 开采素材堆中没有的新碎片（缺口按\"从素材堆取材\"处理）。\n- 编辑原始素材文件。\n- 发布、为特定平台排版，或添加用户没有要求的 frontmatter。\n\n\u003C\u002Fsupporting-info>\n","\u003Cwhat-to-do>\n\n用户已经（或将会）传入一个装满原始素材的 markdown 文件。把它当作输入素材堆：可以是一叠整齐的碎片清单、一墙无结构的散文，或一份转录稿。格式不重要。在做任何其他事之前，端到端读完它。\n\n然后运行一场塑形会话，产出一篇独立的文章文档。这是 **exploit**：探索已经完成，素材堆已经固定：锁定一个结构，开采素材堆来填充它。不要编辑原始素材文件：对本技能来说它是只读的。\n\n如果用户没说文章保存在哪里，问一次并记住路径。\n\n\u003C\u002Fwhat-to-do>\n\n\u003Csupporting-info>\n\n## 循环\n\n1. **读素材堆。** 完整阅读输入文件。形成对其中内容的整体感觉。\n2. **确立先备概念。** 与用户敲定读者进场时知道什么：从一开始就**已落地（grounded）**的概念。其余一切都必须先由某个块落地，之后的块才能倚赖它。见[落地](#落地)。\n3. **起草 2–3 个候选开篇。** 每个开篇应暗示文章不同的论点或角度。全部展示出来。迫使用户挑选或组合出混合体。选定的开篇定义了文章其余部分必须做什么。\n4. **逐段生长。** 开篇落定后，问\"有了这个开篇，读者接下来需要听到什么？\"从素材堆取材来回答。下一个块只能倚赖已落地的概念，并在落地时落地新概念。就下一个块采取的形式展开争论：一个段落、一个列表、一个表格、一个 callout、一段引文、一个代码块。每个格式选择都应该是有意的、可辩护的。\n5. **边进行边追加到文章文件。** 不要攒批。每个商定好的段落或块立即写入，让用户看到文章逐渐成形。\n6. **循环第 4 步直到文章完成。** 由用户决定何时完成。\n\n## 落地\n\n每个**概念**都必须在块倚赖它之前**落地**：读者要么进场时就知道它，要么在更早的块中遇见了它。一个伸向未落地概念的块会丢掉读者。单位是概念，不是它的用词：哪怕一个行话都没有，一个块也可能倚赖读者不具备的想法。当一个概念有名字（一个**术语**），落地它意味着把想法和术语一起落定。\n\n概念通过两种方式之一落地：\n\n- **先备（Prerequisite）**：在开篇之前落地。读者自带。开头定死。\n- **引入（Introduced）**：某个块确立它，从此它对文章其余部分都已落地。\n\n维护一份已落地概念的流动清单。当你问\"读者接下来需要听到什么？\"时，下一步动作需要的某个未落地概念本身就是答案：先落地它（在这里或在更早的块中），否则你无法做出这个动作。这是[从素材堆取材](#从素材堆取材)的\"命名缺口\"在更高一层的样子：那里是素材堆缺材料；这里是文章缺地基。\n\n杠杆是你把什么设为先备、什么放在文中落地。upfront 要求太多会把读者拒之门外；在文中落地太多，开篇会淹没在定义里。确立先备概念时与用户敲定这个平衡。\n\n## 对话的感觉\n\n这是一场反转的 grilling 会话。在构思阶段，问题是\"你实际注意到了什么？\"；在这里是\"这篇文章实际在论证什么，读者需要以什么顺序听到它？\"要顶回去。拒绝让软弱的过渡蒙混过关。如果一个段落配不上它的位置，砍掉它。\n\n要持续使用的具体动作：\n\n- \"这个段落为读者做了什么上一段没做的事？\"\n- \"如果我砍掉这个，什么会崩？\"\n- \"这是散文，还是应该是列表？为什么是散文？\"\n- \"这个句子在做两份工：拆开它，或者选一份。\"\n- \"开篇承诺了 X。我们已经漂到了 Y。要么重新穿线，要么改开篇。\"\n\n## 从素材堆取材\n\n把原始素材当作采石场，而不是剧本。取出一块碎片，改造它以适应周围的段落，然后放置它。一块碎片可能被拆到多个段落中、与另一块合并，或被转述。素材堆的工作是被开采；文章的工作是读起来像一个人的声音。\n\n如果素材堆缺了文章需要的东西，显式命名缺口：\"We need an example here and the pile doesn't have one. Give me one now or we cut this section.\"\n\n## 真正要展开的格式争论\n\n选择如何呈现一个块时，与用户把这些取舍大声权衡，而不是默默决定：\n\n- **散文 vs. 列表。** 散文承载论证；列表承载并列项。如果各项并非真正并列，散文更好。如果真并列，列表浏览起来更快。\n- **行内 vs. callout。** 提示、警告和题外话放进 callout（`> [!TIP]`、`> [!NOTE]`），但仅当它们放在行内真的会打岔主要论证时。否则留在行内。\n- **表格 vs. 重复结构。** 如果同样的形状以同样的字段重复 3 次以上，用表格。否则用加粗领头的散文。\n- **引用 vs. 转述。** 当原始措辞本身就是重点时引用。只有想法重要时转述。\n- **代码块 vs. 行内代码。** 多行、可运行或有示意性 → 代码块。单个 token 或标识符 → 行内。\n\n## 写作节奏\n\n每个块商定后就追加到文章文件。每次写入之前从磁盘重新阅读文件：用户可能在轮次之间做了编辑。永远不要盲目覆盖。如果用户想重写某个段落，就地编辑那个特定段落；其余不动。\n\n## 范围之外\n\n- 开采素材堆中没有的新碎片（缺口按\"从素材堆取材\"处理）。\n- 编辑原始素材文件。\n- 发布、为特定平台排版，或添加用户没有要求的 frontmatter。\n\n\u003C\u002Fsupporting-info>\n",{"name":5,"description":7,"commit_version":24,"disable-model-invocation":25},"5c89081d4bbeb3d039a42093653f90bb698d780e",true,"main","d198f74688d91ee205dcb8e96649a988a256ea4d","matt\u002Fwriting-shape","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills","https:\u002F\u002Fgithub.com\u002Fmuscaestar","muscaestar.xyz","2026-10-19 17:04:10",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":25},[35,38,41],{"tool":36,"command":37},"npx","npx skills add muscaestar\u002Fskills --skill writing-shape",{"tool":39,"command":40},"bunx","bunx skills add muscaestar\u002Fskills --skill writing-shape",{"tool":42,"command":43},"pnpm","pnpm dlx skills add muscaestar\u002Fskills --skill writing-shape","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-shape\u002FSKILL.md",[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",140,"https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-shape\u002Fagents\u002Fopenai.yaml",[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7AV2CSM2X530JCZZZMB9G25","skills-link","管理 muscaestar\u002Fskills 仓库的 skill 安装。当用户想安装\u002F卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问\"这个 skill 装了没有\"时使用。也用于向用户解释三层结构与全局\u002F项目双范围安装策略。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fown\u002Fskills-link\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7AV2A090EYE2BY7G33GW05X","writing-fragments","写作之 explore：开采原始碎片，还没有结构。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-fragments\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7AV281H5H6TDYGPFNH3ZM29","writing-for-agents","为 agents 编写文档。在创建或编辑技能，或修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7AV24MDVDQV8C67Y65DA9KC","writing-beats","写作之 exploit；把原始素材组装成一段由节拍（beat）构成的旅程，在每个节拍倚赖某个术语之前先把它落地。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-beats\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7AV22KNP7VXV3XHPX8JF0KB","wizard","生成一个交互式 bash 向导，引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘，或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwizard\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AV20Q86HA3V6F4Q746E5JS","wayfinder","把一大块工作（超过一个 agent 会话能装下的）规划为 issue 跟踪器上一张由决策 ticket 构成的共享地图，然后一次解决一个，直到通往目的地的路清晰可见。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwayfinder\u002FSKILL.md",[],[]]