writing

Files (4)

• SKILL.md
• openai.yaml · agents/
• document-workflows.md · references/
• examples.md · references/

SKILL.md (first lines)

# Writing Skill

以专业、简洁、通俗的文字组织独立可读的文稿，优先保证阅读流畅、叙述通顺和逻辑连贯。默认采用说明文，用户指定的文体、读者、模板与语言优先。日常聊天、创作和正式审查按各自文体处理。

## 工作方式

1. 阅读原始材料与相关评论，确认用途、读者、当前阶段和交付载体。沿用已有结论，关键歧义查阅原文后再澄清。
2. 围绕读者关心的问题组织主线，按理解所需的顺序展开背景、做法与结果。信息足够时直接撰写，按下列规则安排细节与表达。
3. 通读全文并修订衔接、标题和句式。保留原意、数据、来源及实际信息状态，按交付载体保存并确认结果。

## 正文与细节

正文围绕项目、事实和结论展开，提供理解当前内容所需的最小背景。细节按其对读者理解与判断的作用取舍，避免逐项铺陈实现或核查过程。

| 位置 | 内容 |
| --- | --- |
| 正文 | 核心对象、主要方法、结果与安排，以及影响判断的必要条件。 |
| 脚注或图注 | 与当前表述相关、需要留存但会打断阅读的简短补充。 |
| 文末附注、附录或专题页 | 较长的技术细节、配置、资料状态、检验明细与比对排查记录。 |
| 对话或评论 | 深入讨论、未收敛的探索和协作中的核查问题。 |

无助于理解且无查阅价值的内容直接省略。主要实验或比较结果在正文交代，逐项检验与排查过程另放。图中辅助标记、局部实现与具体参数按需要收于补充材料。

事实核查、推断判断与写作约束在后台执行，正文呈现处理后的内容。将信息状态融入自然措辞，如“拟采用”“当前版本”“本次样本”。内部告诫、红线表态和防御性自证不进入普通正文，也不自动转成脚注。用户要求的规范或合规文档按其主题撰写。

保留影响核心结论或决策的简要条件，其余限定按需要移入补充材料。仅为有查阅价值的内容设置附注。优先使用载体原生脚注，不支持时用文末编号附注，减少正文中反复出现的附注提示。

## 标题命名

- 用简洁的名词或名词短语标识主题、统领下文，如“研究背景”“技术路线”“实验设置”。解释、做法与结论在正文展开。
- 文档标题点明对象与主题，小标题保留足以区分内容的限定。项目内可用“技术路线”，独立页面可用“单目视频动态重建技术路线”。保留正式原名和必要的计划状态。
- 将完整陈述句、问句、介绍性语句和动宾式任务描述改为主题名称。取消自动追加的冒号解释、括号补充和总结式副标题，保留正式名称或项目明确约定的分隔符。
- 同级标题采用相近的概括层次与语法形式。编辑已有页面时沿用合适的标题，改名后同步本次范围内的引用。

## 句式与语序

- 一个句子集中表达一个主要意思，相关条件与限定贴近对应内容。通过清楚的指代和必要的关联词衔接上下文，避免碎句与机械堆叠连接词。
- 中文采用自然的中文语序。将照搬英文的长定语、嵌套从句、插入语、被动结构与名词化表达改写为顺畅叙述。英文按自然的主谓结构和修饰关系组织，避免逐字套用中文语序。
- 保留通行技术名称与英文术语，首次出现时按读者需要简释，后续统一名称。用明确的主语与动词表达，精简口语铺垫、夸张修饰和重复说明。
- 通过准确措辞保留事实、观测、解释、计划与候选之间的区别。以实际比较条件报告数据，用已有依据说明结论，细节按“正文与细节”的规则安排。

## 标点与排版

- 默认用句号划分完整意思，用逗号连接必要成分。单句逗号通常不超过两到三个，超出时按语义重组，保留条件与逻辑衔接。
- 分号仅用于结构明确的排比。普通并列、递进、转折、因果与先后叙述用正常句式表达。
- 冒号仅用于明确引出说话内容或确有必要的解释。普通说明直接融入句子，避免日常套用“标签＋冒号＋说明”。
- 破折号仅用于前后成分明确同指的同位说明，仍优先选择自然完整的句式。其他强调、转折、总结与插入补充改用正常句式。
- 中英文说明文均遵循上述使用偏好，标点形式按对应语言处理。中文默认简体并采用全角标点，公式、代码、命令、URL、标识符、正式原名和原始引文保留原始规范。
- 按内容选择最少但足够的标题、段落、列表与表格。统一编号、术语、单位和日期，控制装饰，采用载体原生格式。Markdown 标题与列表前留空行。

## 按需参考

- 标题、标点、翻译腔或防御性措辞的具体改写，参阅[表达示例](references/examples.md)中对应小节。
- 评论整理、多页文档维护、研究材料与项目目录约定，参阅[文档工作流](references/document-workflows.md)中对应小节。

交付前检查主线与衔接、标题与标点、信息状态与引用。检查在后台完成，向用户交付所需文稿或简要修改说明。

From Rvosuke/Skills, MIT.

More from Rvosuke/Skills