draft-placeholder-filler

star 1

识别正文草稿中的【】占位符,按提示语义填充内容,并将新发现的写作规范沉淀到 WritingStyle.md。触发词:填充占位符、处理【】、补全草稿、resolve placeholders。

9sunrise9 By 9sunrise9 schedule Updated 5/25/2026

name: draft-placeholder-filler description: 识别正文草稿中的【】占位符,按提示语义填充内容,并将新发现的写作规范沉淀到 WritingStyle.md。触发词:填充占位符、处理【】、补全草稿、resolve placeholders。 metadata: author: Bensz Conan

draft-placeholder-filler

识别 Markdown 正文草稿中的 【...】 占位符,按提示语义填充,并将填充过程中发现的写作规范增量沉淀到 WritingStyle.md。

技能定位

适用于:教材/学术专著正文草稿在写作时留下待补充内容的场景。作者在占位符内写明修改意图("换成学术词汇""具体一点""简单写"等),由本技能统一执行并归档规范。

提示词缩写约定:AKAA = "按上下文改为学术且直白的解释性表达";SPC = "具体解释"。

AKAA 执行铁律(从 WritingStyle 迁移)

  • MUST NOT 仅做同义词替换。
  • MUST 先解释该词在当前句中的具体对象与作用,再收敛为朴素准确的学术表达。
  • MUST 保持原句技术边界与因果关系不变。
  • MAY 适度增字以补足对象、条件、约束和影响,但需与上下句顺畅衔接。

AKAA 推荐执行顺序:

  1. 先判定对象:该词具体指代谁、发生在什么环节。
  2. 再补足约束:写清动作、条件、边界与影响。
  3. 最后术语收敛:改写为朴素、可检验、可教学解释的书面句式。

示例:

  • 统一口径,AKAA统一统计标准与字段定义
  • 上云,AKAA上传至云平台
  • 可落地,AKAA可执行

不适用:格式调整、排版、翻译、参考文献管理。


工作流(五步)

铁律(必须遵守)

  • 仅允许修改 【...】 标记位置对应的内容。
  • 超出 【...】 标记范围的原文不得修改。
  • 只有当 【...】 内明确写出可扩展修改范围(如"重写本句""重写本段")时,才可按指令修改标记外文本。

Step 1:扫描并分类占位符

扫描全文,提取所有 【...】 并按语义分为以下四类:

类型 特征 示例
填空型 占位符替代具体内容(列举、命名、出产物) 【具体那几个环节】【什么产物】
改写型 指示将现有词/句替换为更规范表达 【退化,换成学术词汇】【整体效果,具体一点】
写作提示型 指示一段落的写作方式(长度、风格) 【这一部分简单写】【约100字,列举式】
标识型 仅起内部标注作用,不需要生成内容 【TODO】【待补充数据】

标识型占位符:询问用户是否跳过。

Step 2:逐一解析填充意图

对每个占位符,从以下维度提取意图:

  • 结构意图:要填入的是哪类内容(名词列举、完整句、段落、标签替换)
  • 范围约束:填充内容仅限于文中已出现的信息,不引入文外新内容
  • 风格约束:如有"学术词汇""简单写""具体一点"等修饰,须同时执行风格转换

当同一占位符内出现多条指令时,按以下优先级执行(从高到低):

  1. 范围指令:如"重写本句""重写本段"(先确定可改动边界)
  2. 术语规范指令AKAA/"改成学术词汇"(先完成“语义澄清+学术化”)
  3. 信息密度指令:"具体一点"(补充机制或指标维度)
  4. 篇幅压缩指令:"简单写"(在不丢失关键信息前提下压缩)

若高优先级与低优先级冲突,以高优先级为准。

关键原则:填充内容必须与上下文语义自洽,且与同段中前后出现的同类表达保持一致(如同一"产物"多次出现须统一命名)。

Step 3:执行填充

按以下优先级生成填充内容:

  1. 填空型 — 从上下文直接推导(如前文已列出六个环节,填充时列出对应子集)
  2. 改写型 — 按学术写作规范替换:
    • 若占位符内出现 AKAA,先做语义解包,再做术语规范化
    • AKAA 的默认输出应满足“直白可懂 + 学术准确”:优先补出对象、边界、作用,不追求最短字数
    • 口语动词 → 学术动词(退化 → 性能退化;出问题 → 失效;变差 → 下降)
    • 模糊范围 → 具体指标或机制描述(整体效果变差 → 最终决策指令的精度与时效下降)
    • 泛指代词 → 具名术语(产物 → 推理结果;这些东西 → 对应的技术路线)
    • 对抽象名词(如“一致性”“约束”“语义”)优先写成“谁与谁在什么条件下保持一致/受限”的说明性短语
  3. 写作提示型 — 按提示语压缩或展开,常见规则:
    • "简单写" → 压缩为1–2句核心判断,去掉背景铺垫
    • "具体一点" → 补充量化指标或机制描述
    • "列举式" → 按 WritingStyle.md 的 List Introduction 规范生成

Step 4:一致性检查

填充完成后扫描全文,检查:

  • 同一"产物"/"对象"在段内命名是否一致
  • 同一功能模块的表述是否前后统一
  • 新填充内容是否引入了与 WritingStyle.md 冲突的表达(双冒号、演进比喻、解释性括号等)

Step 5:沉淀写作规范

对填充过程中遇到的新规律,以增量形式追加到 WritingStyle.md 对应章节:

  • 口语→学术的替换对 → 追加到 Colloquial-to-Academic Substitutions 表格
  • 新的"不得"表达 → 追加到 Prohibited Expressions 表格
  • 流程/管道命名规范 → 追加到 Pipeline Output Naming 或新建条目
  • 段落结构规律(如引言压缩规则)→ 追加到 Section Lead-in Sentence

常见占位符与处理规则速查

占位符模式 处理规则
【具体哪几个X】 从上下文枚举;超过3项用顿号,超过4项用分号
【X完成了什么任务】 写"X完成从A到B的[动词]"格式的功能句
【什么产物】 命名输出实体,后续段落统一使用该名称
【产物】(反复出现) 替换为Step 3中已命名的实体名称
【X,AKAA】 等价于 【X,改成学术词汇】,但必须按上下文先解释 X 的具体含义,再输出学术且直白表达
【X,SPC】 等价于 【X,具体解释】,补充机制、指标或边界条件
【退化,换成学术词汇】 → 性能退化(必要时可扩为“关键性能指标持续下降并接近失效阈值”)
【整体效果,具体一点】 → 补充具体的指标维度(精度、时效、吞吐等)
【这一部分简单写】 将括号内完整草稿压缩为1–2句核心描述,删除括号
【指的是那几个模块】 替换为"由……承担"格式

WritingStyle.md 更新规范

  • 路径:由用户在调用时指定,默认询问
  • 操作方式str_replace 追加到最近的相关条目后,不新建章节(除非确实无对应章节)
  • 格式要求:新增条目须包含 good/bad 对照代码块
  • 禁止操作:不修改现有 MUST/SHOULD/MAY 约束级别;不删除已有条目

输出格式

完成后输出:

  1. 填充摘要:列出所有已填充的占位符及填充内容(表格形式)
  2. 一致性问题:如发现前后不一致,列出并给出建议
  3. WritingStyle.md 更新摘要:列出新增/修改的条目名称

调用示例

用户:@file:7.2-7.3_正文草稿.md 中有【】占位符,按提示修改,并总结到 WritingStyle.md

技能执行:

  1. 扫描草稿,识别出7个占位符(3个填空型、3个改写型、1个写作提示型)
  2. 逐一填充,检查"产物"命名一致性
  3. 将"口语→学术替换对"和"管道输出命名规则"追加到 WritingStyle.md
  4. 输出填充摘要表格
Install via CLI
npx skills add https://github.com/9sunrise9/scholar-kit --skill draft-placeholder-filler
Repository Details
star Stars 1
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator