SuperAPI AI 工具集

writing-artifacts

写作与研究

查看项目

更新于 10-15 17:13

技能介绍

writing-artifacts 是一条“生产线”:原始想法输入,可发布成品输出。使用者负责调度各个站点,每个站点的方法都写在各自的 SKILL.md 中,应在对应阶段读取,而不是凭记忆操作。

用途

该技能用于把模糊主题——问题描述、事故、决策、长文想法——转化为用户所选格式的成品。它覆盖从框定、挖掘、结构化、精简到渲染的完整写作流程,并区分普通写作与仓库内软件文档两种体裁。

主要能力

Stage 0 — 框定(一轮提问后即推进):在动笔前确定三件事:SUBJECT(一句话)、READER(必须理解它的人)、OUTPUT FORMAT。默认格式按去向决定:快速分享用 md;用户会反复查看或展示给他人的用 html 页面或 Artifact;需要视觉隐喻或主图时增加图像阶段。若用户已说明格式则不再询问。先估体量再选格式,体量表(散文、仪表盘、图表、动效)与质量标准位于规则 artifacts-rules 中,无需询问即可应用。读者预设 ELI5(“像给五岁小孩解释”“完全外行”)会把 READER 定为对领域一无所知、FORMAT 定为以大图少字承载的 Artifact;简化语言但不简化事实,不使用无依据的术语,也不使用“简单/只是/显然”这类词。体裁分支在此决定:仓库内软件文档(README、API 文档、教程、操作指南等位于仓库下的内容)会把结构站点替换为 documentation-writing(八条规则 + Diataxis、docs/ 位置与链接规则)作为 Stage 2,替代 writing-beats/writing-shape 组合,Stage 1 挖掘与 Stage 3 去废话纪律保持不变;其余内容(问题记录、事故、决策、长文散文)走默认流程。

Stage 1 — 挖掘(发散):writing-fragments 把已知的一切以原始片段形式倾倒出来——证据、时间线、感受、半成品想法——暂不结构化。对于真正模糊的想法(而非已知事故),先运行 adhd 做并行发散,再对存活片段做碎片化。

Stage 2 — 结构化(收敛):二选一。writing-beats 适用于需要把读者引向某处的内容:问题叙述、事故记录、决策理由,会在某个节拍依赖某术语前先为其打基础。writing-shape 适用于材料已大致有序、只需逐段塑形的情况。

Stage 3 — 精简:就地精简草稿,全程以 stop-slop 作为标准(不限于本阶段):无填充、无含糊、无 AI 腔调。

Stage 4 — 渲染(格式分支):md/纯散文直接交付精简后的文本,完成。html 页面/Artifact/图表/图像则把完成后的文本交给 using-design-skills 作为内容契约,由它组织流水线(它负责权威选择、图像生成委派、截图证据质量循环)。不要自行内联样式;此时文本已是冻结内容——设计改变布局,不改变措辞。

Stage 5 — 报告修改(在回复中,不在成品里):交付后最多加五行,说明改了什么及原因。每类修改一行,而非每句一行:你打基础的术语、你显式化的假设、你重排的结构、你删掉的内容。指出问题,而非更漂亮的措辞。当输入是已有文本时,每行采用 before → after,引用承载问题的最短片段;当文本是新写的时,去掉 before 部分,报告删了什么及原因。该报告绝不进入成品。

使用方式

按阶段推进:先框定,再挖掘,再结构化,再精简,最后按格式渲染。每个阶段读取对应 SKILL.md。

适用场景

适用于围绕某主题的书面交付物——散文以及仓库内软件文档(Stage 0 的体裁分支选择结构站点)。来自讨论的计划页面则直接在 artifacts-rules(Plan page)下构建。

限制

文字优先,像素其次:绝不在草稿未精简时进入 Stage 4——重新设计废话只会产出穿着考究的废话。允许回退一次:若渲染暴露结构漏洞(某节因从未真正解释而无法可视化),仅针对该节返回 Stage 2,然后重新渲染。