name: writing-fragments description: "写作的探索阶段:挖掘原始片段,暂不建立结构。" disable-model-invocation: true
先积累真实材料,暂不组织文章
这是探索阶段的写作技能:收集可以保留下来的句子、观察、故事或半成形想法,不急于安排结构。
还不清楚 Skill、Agent、安装和调用?先读 从零开始的6节入门课。
作者将它放在 in-progress,未作为稳定插件内容推广。先理解原理,实际使用前核实版本和依赖。
在关系图中查看 writing-fragments 与其他技能的关联 →
先把必要的概念讲清楚
这是一种先采集写作素材的方法。它特别适合把学习中的真实困惑、例子和认识保存下来,之后再决定如何写成文章。
下面是老师补充的入门说明;原作者的要求保留在中英对照正文中。所有例子均为帮助理解而构造的教学情境。
beat / fragment|叙事推进与素材片段
fragment 是可能用于文章的素材,允许还不完整。beat 是成文中完成一次推进的小段,例如交代一次失败、提出一个认识或展示一个例子。两者不是按字数区分:素材尚未承担文章顺序中的职责,节拍已经承担。
context|Agent 当前可用的上下文
模型这一轮实际能使用的请求、对话、指令和已读文件内容。它不是电脑上所有资料,也不是永久记忆。文件存在但没被读到,就不一定参与推理。交接文档应指明当前目标、进度、关键证据位置和下一步,让新会话能够恢复必要背景。
读原文,理解每一步为什么这样做
左右内容按小节对应;窄屏先中文、后英文。两种语言均完整展示,对应讲解紧接在小节之后。译文传达原文要求;老师讲解补充概念、原因、例子与适用边界。
name: writing-fragments description: "Writing, explore: mine raw fragments, no structure yet." disable-model-invocation: true
<what-to-do>
这一步只做探索:扩大可能写出的内容范围,暂时不确定文章结构。选择结构并成文属于后面的利用素材阶段,由别的技能负责。
围绕用户想写的话题,持续深入提问,产出写作片段。不要在这里强加阶段、提纲或文章结构。
对话双方提供的片段,随出现随追加到同一份 Markdown 文件。用户未提供保存路径时,只问一次,之后记住。用户最初的请求本身也可能有素材,应从第一句话开始捕捉。
首次写文件时,顶部只有一个一级标题作为暂定题目,可以以后修改;不加元数据、目录或日期。
</what-to-do>
<supporting-info>
<what-to-do>
This is pure explore: widen the space of what could be written without committing to structure. Committing is exploit, a separate skill's job. Run a grilling session that produces fragments, interviewing the user relentlessly about whatever they want to write about. Imposing phases, outlines, or article structure is out of scope here.
As fragments emerge from either side of the conversation, append them to a single markdown file.
If the user did not pass a path, ask once where to save the document, then remember it for the rest of the session.
Capture fragments from the very first thing the user says, including the initial prompt.
On first write, put a single H1 at the top with a working title (it can change later) and nothing else: no metadata, no TOC, no date.
</what-to-do>
<supporting-info>
什么是写作片段
片段是可能进入最终文章的任意文字。作者自己能看懂意思即可,不要求定义所有词,也不要求陌生读者立即理解。判断的是“这是否有写作价值”,而不是“是否已经形成自足论证”。
片段刻意允许不同形态:
- 一句锋利的话,还不知道放在哪里。
- 一个判断和一句理由。
- 一小段经历、代码、情境或类比。
- 尚未想完整的感觉,例如“X 好像 Y,以后展开”。
- 引语、对话或偶然听到的一句话。
- 几条在感觉上相关的观察。
- 抱怨、坦白或点题的笑话。
- 一个能统领全文的关键词,即用紧凑比喻或新名称概括核心想法,例如“曳光弹”或“战争迷雾”代表整种模式。
作者尤其重视最后一种。找到准确的统领词,可能影响后续结构、过渡和标题,在成文阶段持续产生帮助。对话反复围绕某个想法时,尝试为它找到合适名称。
可以把小说家的日记作为参照:多年记录未经结构化的观察,之后再从中取用。片段就是这样的观察记录。
What is a fragment
A fragment is any piece of text that might survive into the final article. It must be readable by the author (the author can tell what it means), but it does not need to define its terms or be comprehensible to a cold reader. The bar is "is this a piece of good writing?", not "is this a self-contained argument?"
Fragments are deliberately heterogeneous. Examples of what could be a fragment:
- A sharp sentence you'd want to deploy somewhere but don't yet know where.
- A claim with a one-line justification.
- A vignette: a thing that happened, a code snippet, a scenario, an analogy.
- A half-thought: "something about how X feels like Y, work this out later."
- A quote, a piece of dialogue, an overheard line.
- A list of related observations that hang together by feel.
- A complaint, a confession, a punchline.
- A leading word: a compact metaphor or coinage the whole piece can hang on (one term that names the idea, the way tracer bullets or fog of war names a whole pattern).
Of these, the leading word is the most valuable fragment to land. It is load-bearing: name the right one in explore and it shapes the structure, the transitions, and the title later, paying dividends through the entire exploit phase. When the conversation circles a recurring idea, push to coin a word for it.
The novelist's diary is the model: years of unstructured noticings that later get mined for raw material. Fragments are noticings.
片段可以不完整,但应让作者自己认得出意思
一个片段可能是一次经历、一句判断、一段对话、一个类比或半成形问题。它暂时不必自成完整论证,因为未来写作时还会补背景和组织关系。
例子:“我把 Agent 的成功报告当成验收,后来发现页面根本没更新。”这段可以成为以后讨论证据的素材。立即把它改成“AI 工程成功的五大原则”,反而丢掉原始经验。
引导词若能准确命名反复出现的认识,会帮助后面成文。例如“可验收的委托”可能连接多次经历。但命名应贴近材料,不能为了标题漂亮强造一个大概念。
先把值得保留的认识收集起来,不急着让每句话承担完整论证
假设你想写“重新学习如何驾驭 AI”。你说:“它做得越快,我越难判断它做对没有。”这句话有价值,即使还没有数据、例子和完整结论,也可以先作为片段保存。
之后你又讲一次返工经历、一段看到工单的困惑,以及终于理解上下文的时刻。探索阶段先保留,不急着把它们塞入固定三段式文章。
片段不必让陌生人立即懂,但成文时必须补足背景。 它是作者的素材,不是直接发布的教材。因此不能把这个阶段允许省解释的规则,拿来为初学者翻译技能。
统领词也应帮助理解,例如“会写任务,不会验收”可能概括一类经验。不要为了造新词增加读者负担。真正的个人经历必须来自用户,AI 可以提出类比,但不能编造经历后当成你的素材。
文件格式
# 暂定题目
第一段素材。
它可以有多个段落,也可以包含列表、代码或引用。
---
第二段素材。
---
> 一句希望保留的引语。
对它的反应。
---
- 一组相关观察
- 在意义或感受上彼此相连
- 希望放在一起
片段之间用水平分隔线 \n---\n。正文内部不加标题、不加标签,按加入先后排列,不另组织顺序。
File format
# Working title
A first fragment lives here.
It can be multiple paragraphs. It can include lists, code, quotes: whatever
shape the fragment naturally takes.
---
A second fragment.
---
> A quoted line that the user wants to keep around.
A reaction to it.
---
- A cluster of related observations
- That hang together by feel
- And want to be near each other
Fragments are separated by a horizontal rule (\n---\n). No headings inside the body. No tags. No order beyond the order they were added.
不设大纲,是为了暂缓收敛
片段按出现顺序追加,用分隔线区分,不强加章节和标签。这让你可以继续发现素材,而不是所有新想法都被迫塞进已定结构。
工作标题可以变化。记录素材的任务是保存值得继续思考的文字,不是承诺它都会进入最终文章,也不是已经形成正式观点。
因此私人反思、待确认事实和可公开内容仍应分别辨认。素材被记录,不等于获准发布。
记录节奏
直接追加,不为每个片段反复请求许可。可以顺口说“这段记下来”,不让保存对话打断思考。
每次写入前重新读取磁盘文件,因为用户可能在两轮之间编辑、重排或删除。保留这些改动,不整份覆盖;默认只追加,用户要求修改某片段时再就地编辑。
用户随时可以说删掉最后一条、把某条写得更准确、合并两条。这些都是直接执行的编辑指令。
</supporting-info>
Writing rhythm
Append silently. Don't ask permission for each fragment. Mention what you added in passing ("adding that"), but don't interrupt the conversation with save dialogs.
Before every write: re-read the file from disk. The user may have edited, reordered, or deleted fragments between turns, so preserve their changes. Never overwrite the file; only append (or, if the user asks, edit a specific fragment in place).
The user can say "cut the last one", "rewrite that one sharper", "merge those two" at any time. Treat those as first-class instructions.
</supporting-info>
协作写文件,必须尊重用户中途编辑
用户可能在两轮聊天之间删除、重排或改写片段。每次写入前重读文件,是防止 Agent 用自己缓存的旧副本覆盖用户修改。
你说“把最后一个删掉”就是明确编辑指令;没有这种要求时主要追加。安静保存减少打断,但不是让修改不可追踪。
本课产生素材文件。下一步可以用 writing-shape 或 writing-beats 组织文章,不能因为已经攒了很多素材就说文章完成。
先作答,再看参考思路
用自己的话说明:它解决什么问题,完成后会留下什么?
请各用一句话回答。若它只做规划或解释,不要把“已开发”“已部署”写成产物。
为什么这里不要求每段都让陌生读者看懂?
我已思考,查看参考思路
此阶段服务作者收集材料。面向读者补背景是后续成文阶段的职责,过早补齐会压制探索并增加负担。
原文中哪条要求在你的环境下可能不成立?
说出具体一句及其前提,例如工具不可用、资料缺失、已有项目约定冲突,或它只是作者偏好。把你的答案带回课堂,我们据此继续讨论。
把方法放进一个具体情境
教学案例:“今天发现 AI 说完成与真正保存之间还有一层证据。”先把这句话和发生经过记下。无需立刻扩成一篇“AI 时代的十大原则”。
边界与容易误读的地方
不要把片段自动改成完整结论;这会抹去当时尚未想清楚的状态。探索阶段也不能虚构经历补素材。
讨论后再实践:先判断上述情境是否适用,再选择真实任务。现在无需安装、运行命令或修改现有项目。