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 推荐执行顺序:
- 先判定对象:该词具体指代谁、发生在什么环节。
- 再补足约束:写清动作、条件、边界与影响。
- 最后术语收敛:改写为朴素、可检验、可教学解释的书面句式。
示例:
统一口径,AKAA→统一统计标准与字段定义上云,AKAA→上传至云平台可落地,AKAA→可执行
不适用:格式调整、排版、翻译、参考文献管理。
工作流(五步)
铁律(必须遵守)
- 仅允许修改
【...】标记位置对应的内容。 - 超出
【...】标记范围的原文不得修改。 - 只有当
【...】内明确写出可扩展修改范围(如"重写本句""重写本段")时,才可按指令修改标记外文本。
Step 1:扫描并分类占位符
扫描全文,提取所有 【...】 并按语义分为以下四类:
| 类型 | 特征 | 示例 |
|---|---|---|
| 填空型 | 占位符替代具体内容(列举、命名、出产物) | 【具体那几个环节】、【什么产物】 |
| 改写型 | 指示将现有词/句替换为更规范表达 | 【退化,换成学术词汇】、【整体效果,具体一点】 |
| 写作提示型 | 指示一段落的写作方式(长度、风格) | 【这一部分简单写】、【约100字,列举式】 |
| 标识型 | 仅起内部标注作用,不需要生成内容 | 【TODO】、【待补充数据】 |
标识型占位符:询问用户是否跳过。
Step 2:逐一解析填充意图
对每个占位符,从以下维度提取意图:
- 结构意图:要填入的是哪类内容(名词列举、完整句、段落、标签替换)
- 范围约束:填充内容仅限于文中已出现的信息,不引入文外新内容
- 风格约束:如有"学术词汇""简单写""具体一点"等修饰,须同时执行风格转换
当同一占位符内出现多条指令时,按以下优先级执行(从高到低):
- 范围指令:如"重写本句""重写本段"(先确定可改动边界)
- 术语规范指令:
AKAA/"改成学术词汇"(先完成“语义澄清+学术化”) - 信息密度指令:"具体一点"(补充机制或指标维度)
- 篇幅压缩指令:"简单写"(在不丢失关键信息前提下压缩)
若高优先级与低优先级冲突,以高优先级为准。
关键原则:填充内容必须与上下文语义自洽,且与同段中前后出现的同类表达保持一致(如同一"产物"多次出现须统一命名)。
Step 3:执行填充
按以下优先级生成填充内容:
- 填空型 — 从上下文直接推导(如前文已列出六个环节,填充时列出对应子集)
- 改写型 — 按学术写作规范替换:
- 若占位符内出现
AKAA,先做语义解包,再做术语规范化 - AKAA 的默认输出应满足“直白可懂 + 学术准确”:优先补出对象、边界、作用,不追求最短字数
- 口语动词 → 学术动词(退化 → 性能退化;出问题 → 失效;变差 → 下降)
- 模糊范围 → 具体指标或机制描述(整体效果变差 → 最终决策指令的精度与时效下降)
- 泛指代词 → 具名术语(产物 → 推理结果;这些东西 → 对应的技术路线)
- 对抽象名词(如“一致性”“约束”“语义”)优先写成“谁与谁在什么条件下保持一致/受限”的说明性短语
- 若占位符内出现
- 写作提示型 — 按提示语压缩或展开,常见规则:
- "简单写" → 压缩为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 约束级别;不删除已有条目
输出格式
完成后输出:
- 填充摘要:列出所有已填充的占位符及填充内容(表格形式)
- 一致性问题:如发现前后不一致,列出并给出建议
- WritingStyle.md 更新摘要:列出新增/修改的条目名称
调用示例
用户:@file:7.2-7.3_正文草稿.md 中有【】占位符,按提示修改,并总结到 WritingStyle.md
技能执行:
- 扫描草稿,识别出7个占位符(3个填空型、3个改写型、1个写作提示型)
- 逐一填充,检查"产物"命名一致性
- 将"口语→学术替换对"和"管道输出命名规则"追加到 WritingStyle.md
- 输出填充摘要表格