writing-fragments
1. Bilingual SKILL.md
左右滑动可直接切换英文版与中文版;两种语言按段落自动对齐。英文中的蓝色虚线词语可点击查看解释。共标记 15 处。
Entry SHA-256: 298b0edd23df229183630de592ed8aa4289233560f2040691f6eb77caeaad4ea
2. Why This Skill Is Clever
一句话核心机制
把写作探索阶段变成一条持续采矿的对话管线:从第一句话起识别异质片段,静默追加到一个极简文件,同时明确拒绝提前施加结构。
触发与边界
- Direct source:
disable-model-invocation: true表明它只能由用户显式发起;它适用于文章的 explore 阶段,而非已经准备组织成稿的 exploit 阶段。 - Direct source: 工作目标是通过持续追问扩大“可能写什么”的空间;阶段、提纲和文章结构被明确排除。
- Direct source: 输入来自对话双方,输出是一个持续追加的 Markdown 文件;如果路径缺失,只询问一次并在会话中记住。
- Supporting context:
skills/in-progress/README.md将它标为公开测试的 Beta,并说明它不随插件发布、可能无预警变化;这些状态不属于选中原文。 - Interpretation: 它适合还不知道文章形状、但已经有主题或经验可挖的作者;如果用户已经要排序段落或确定叙事路径,应切换到后续塑形流程,而不是继续无边界发散。
信息架构 / 执行顺序
- 用户显式启动探索,并提供主题;若没有保存路径,只问一次并记住。
- 从初始提示词开始,把对话中的可用表达视为候选片段,而不是等待所谓“正式素材”。
- 通过持续追问让句子、主张、小场景、半成品想法、引语、观察簇、包袱和领衔词浮现。
- 每个片段出现时,先从磁盘重读文件,吸收用户在轮次间的编辑。
- 首次写入只创建一个暂定 H1;之后用水平线分隔并只追加新片段,不增加标签、目录或正文标题。
- 写入动作保持低摩擦:无需逐条征求许可,只顺带说明“加进去了”。
- 用户可随时删除、改写或合并特定片段;这些修改与新增片段同属核心流程。
- 整个阶段不构造提纲;片段库留待独立的 exploit skill 再进行结构化。
最巧妙的设计点
1. 用 explore / exploit 边界保护真正的发散
“widen the space of what could be written without committing to structure”
Direct source: 它没有笼统地说“头脑风暴”,而是把探索定义为扩大可能空间,把结构承诺交给另一个 skill。这个边界防止 agent 一看到好点子就自动总结成提纲,从而过早丢弃旁支素材。
2. 把初始提示也当作素材,而非一次性控制信息
“Capture fragments from the very first thing the user says”
Direct source: 初始提示通常包含最未经修饰、最有作者声音的表达。要求从第一句话开始捕捉,避免等到追问阶段才记录而漏掉开场中的标题、主张或隐喻。
3. 用异质片段降低入库门槛,但保留质量门槛
“readable by the author”
Direct source: 片段不必对冷读者自足,也不必成为完整论证;它只需让作者知道其意义,并通过“这是一段好文字吗”这一标准。这样既容纳半成品和不同形状,又不把任意噪声都当成果。
4. 领衔词是探索阶段的高杠杆产物
“a compact metaphor or coinage the whole piece can hang on”
Direct source: 一个准确的新词或隐喻不仅是漂亮表达,还会在后续阶段塑造结构、过渡和标题。skill 特别要求在对话反复环绕某个想法时推动命名,使素材采集能产出未来的组织轴心,而不必现在就组织文章。
5. 极简文件格式避免偷偷引入分类法
“No tags. No order beyond the order they were added.”
Direct source: 一个 H1、水平线和原样片段就是全部格式。没有标签、日期、目录和正文标题,意味着存储层不会逼作者在探索期回答“它属于哪一章”,也不会让暂时分类固化为文章结构。
6. 磁盘重读与只追加共同保护协作事实
“Before every write: re-read the file from disk.”
Direct source: 每次写入前重读,承认用户可能在工具外编辑、重排或删除;默认只追加则降低覆盖风险。两条规则组合后,磁盘文件成为权威状态,而非 agent 的会话记忆。
防失败机制与 trade-off
- 显式不变量: 不施加阶段、提纲或文章结构;从初始提示开始捕捉;首次写入只有一个 H1;正文没有标题、标签和额外排序。
- 显式写入安全: 每次写入前重读磁盘;默认绝不覆盖,只追加;只有用户明确指定时才就地编辑某个片段。
- 显式交互边界: 保存路径只问一次;每个片段无需逐条确认,但应顺带告知已添加,避免“静默”变成不可见副作用。
- 显式编辑能力: 删除最后一个、改写某个片段、合并两个片段都被视为一等指令,而不是破坏正常流程的例外。
- Trade-off: 按添加顺序平铺能保护发散,却会让大型片段库难以检索;后续 skill 必须承担筛选和塑形成本。
- Trade-off: “好文字”的门槛与“领衔词”的判断高度依赖模型品味和作者反馈,无法仅凭格式验证。
- Portability risk:
disable-model-invocation、会话内记住路径、磁盘重读和文件原地编辑依赖 agent harness;纯聊天环境需要显式文档状态与并发冲突处理。 - Beta risk: supporting README 说明该 skill 尚未进入插件,可能改变或消失,因此不应把当前文件格式当作永久 API。
可迁移原则
- 把探索与收敛拆成不同 skill,并为探索阶段写下明确的“禁止结构化”边界。
- 从交互第一刻就识别可复用成果,不要把初始输入仅当控制指令。
- 为中间产物定义足够宽的形状集合,同时保留一个清晰、低成本的质量门槛。
- 使用最小化存储格式,避免元数据和分类在证据不足时偷偷变成决策。
- 在人和 agent 都能编辑同一文件时,写前重读、默认追加,并把定点修改设计成一等操作。
今日实践题
假设用户开场说:“我总觉得 AI 写作像把刚捞上来的鱼立刻做成罐头。”你会把其中哪一部分保存为片段,又会如何追问以寻找一个能让整篇文章挂住的领衔词,同时不提前提出文章结构?
Evidence note
双语原文、explore / exploit 边界、片段类型、领衔词、极简文件格式、静默追加、写前重读和定点编辑规则均来自选中的 writing-fragments/SKILL.md。skills/in-progress/README.md 只作为 Supporting context,用于确认 Beta、未随插件发布和可能变化的状态。对信息损失、存储分类法、协作事实及可移植性的分析属于 Interpretation。
Source & provenance
- Repository path
- skills/in-progress/writing-fragments/SKILL.md
- Generated
- 2026-08-28 18:05 Asia/Shanghai
- Upstream commit
- 6654f6b60cd9d5be8b54c6fafe44346dabeb3b76
- Source
- View on GitHub