writing-shape
Writing, exploit —— 把原始素材逐段塑造成一篇文章。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
Writing, exploit —— 把原始素材逐段塑造成一篇文章。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
使用并行子代理为一个模块生成多个截然不同的接口设计。当用户想设计 API、探索接口方案、对比模块形态,或提到 "design it twice" 时使用。
交互式 QA 会话,用户以对话方式报告 bug 或问题,代理负责提交 GitHub issue。会在后台探索代码库以获取上下文和领域语言。当用户想报告 bug、做 QA、以对话方式提交 issue,或提到 "QA session" 时使用。
通过用户访谈创建一份带有微小提交(tiny commits)的详细重构计划,然后将其作为 GitHub issue 提交。当用户想规划一次重构、创建重构 RFC,或将一次重构拆分为安全的增量步骤时使用。
从当前对话中提炼出一份 DDD 风格的通用语言(ubiquitous language)术语表,标记歧义并提出规范术语。保存到 UBIQUITOUS_LANGUAGE.md。当用户想定义领域术语、构建术语表、固化用词、创建通用语言,或提到 "domain model" 或 "DDD" 时使用。
询问哪个技能或流程适合你当前的处境。它是本仓库中各技能的路由器。
从两个轴向审查某个固定点(commit、branch、tag 或 merge-base)以来的变更——Standards(代码是否遵循本仓库记录的编码规范?)和 Spec(代码是否符合源起的 issue/PRD 的要求?)。在并行子智能体中运行两项审查,并把它们并排报告。当用户想审查一个分支、一个 PR、进行中的变更,或要求 "review since X" 时使用。
| name | writing-shape |
| description | Writing, exploit —— 把原始素材逐段塑造成一篇文章。 |
| disable-model-invocation | true |
用户已经(或将要)传入一个装满原始素材的 markdown 文件。把它当作输入素材堆 —— 从一份整洁的片段清单,到一大堆未加结构的散文,再到一份逐字记录,都可以。格式无所谓。在做任何别的事之前先从头到尾读完它。
然后运行一段产出一份独立文章文档的塑造会话。这是 exploit(发掘):探索已经做完,那一堆素材已经固定 —— 承诺一个结构,并挖掘这堆素材来填满它。不要编辑原始素材文件 —— 对本技能而言它是只读的。
如果用户没有说文章保存到哪里,就问一次并记住那个路径。
每个概念(concept)在某个区块能够倚赖它之前,都必须先被铺垫(grounded):读者要么走进来就知道它,要么在更早的某个区块里遇到过它。一个伸手去够未铺垫概念的区块会失去读者。单位是概念,而非表述它的词 —— 一个区块可以倚赖一个读者所缺乏的想法,哪怕视线里根本没有术语。当一个概念有名字时 —— 一个术语(term) —— 铺垫它意味着把这个想法和这个术语一起落定。
一个概念以两种方式之一被铺垫:
保留一份已铺垫内容的动态清单。当你问"读者接下来需要听到什么?"时,下一步动作所需的一个未铺垫概念本身就是答案:先铺垫它 —— 在这里或在更早的某个区块里 —— 否则你就做不了这一步。这是 从素材堆中取材 那种指认缺口的做法在高一层的体现:那里是素材堆缺素材;这里是文章缺一块地基。
杠杆是:什么设为前提、对比什么在文章内铺垫。前面要求太多,就把读者拒之门外;文中铺垫太多,开头就淹没在定义里。在你确立前提时与用户敲定它。
这是一次反转过来的拷问式会话。在构思阶段,问题是"你实际注意到了什么?"这里问的是"这篇文章实际在论证什么,以及读者需要以什么顺序听到它?"要反驳。拒绝让软弱的过渡蒙混过关。如果一个段落配不上它的位置,就砍掉它。
要一直沿用的具体动作:
把原始素材当作一座采石场,而非一份脚本。取出一个片段,把它改造得契合周围的段落,然后放置它。一个片段可以被拆分到多个段落、与另一个合并,或被转述。素材堆的活儿是被挖掘;文章的活儿是读起来像一个声音。
如果素材堆缺少文章所需的东西,就明确指认那个缺口:"这里我们需要一个例子而素材堆里没有 —— 现在给我一个,否则我们就砍掉这一节。"
在选择如何呈现一个区块时,把这些权衡与用户大声地掂量,而非默默地:
> [!TIP]、> [!NOTE])—— 但仅当它们内联会真正扰乱主论证时。否则就留在内联。每敲定一个区块就追加到文章文件。在每次写入之前从磁盘重新读取文件 —— 用户可能在两轮之间做了编辑。绝不盲目覆盖。如果用户想重写某个段落,就原地编辑那个特定段落;其余不动。