关于 orwell-writing
将 Orwell 的写作规则与 ASD-STE100 指南用于写作和修订,帮助改善技术及商务文案的清晰度,同时保留创作中有意为之的语气。
主要功能
- 01直接简洁的表达指南
- 02主动语态与明确主语
- 03术语保持一致
- 04技术说明写作模式
- 05文本修订流程
- 06保留刻意营造的创作语气
适用场景
- 01撰写技术说明
- 02编辑商务或产品文案
- 03删去含糊或浮夸措辞
- 04修订创意文本并保留其风格
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tamdogood/ builder-essential-skills --skill orwell-writing安装后在 Claude Code 中输入/orwell-writing确认已加载。
附带文件agents/openai.yamlREADME.md
详细介绍
Orwell 写作
概述
将 Orwell 的规则和 ASD-STE100 简明技术英语(STE)作为实用准则,帮助写出清晰、直接、诚实的文字。技术、说明、商务和产品文案默认使用 STE。起草和修订时都应用这些规则;但如果用户明确需要特定的风格、个性、节奏、幽默或体裁,就不要抹去这些特点。
STE 包含写作规则和受控词典。有词典可用时,请使用获准词汇及其获准含义。未经核对当前版本的 ASD-STE100 及其词典,不要声称严格符合 STE。
核心规则
请记住以下摘自《政治与英语》的规则:
- 不要使用你常在印刷品中见到的隐喻、明喻或其他修辞手法。
- 能用短词时,不要用长词。
- 只要可以删掉一个词,就删掉它。
- 能用主动语态时,不要用被动语态。
- 能想到日常英语中的对应说法时,就不要使用外语短语、科学术语或行话。
- 宁可违反以上任何一条规则,也不要说出明显粗鄙的话。
ASD-STE100 基本要求
对于技术和说明性文案:
- 使用短句。每句话只表达一个主要动作或陈述。
- 使用明确的主语和主动动词。行动者很重要时,要明确指出。
- 同一事物始终使用同一个术语。不要只为避免重复而更换术语。
- 使用含义明确的常用词。避免习语、俚语、比喻性语言和含糊的动词。
- 为确保准确而必须使用特定技术术语时,请对其作出定义或链接到相关定义。
- 缩短名词词组。使用介词说明术语之间的关系。
- 将步骤写成直接指令。说明条件、操作和预期结果。
- 指令清晰时,使用肯定表达。说明读者必须做什么。
- 除非用户的风格指南要求使用其他变体,否则统一使用美式英语拼写。
- 保留代码、命令、标识符、产品名称、法律文本和必需的引文。不要擅自简化这些内容。
如果无法严格遵循 STE,请保持文本清晰,并标出需要领域特定例外的术语或段落。
工作流
从头开始写作时:
- 根据用户的要求,确定受众、目的和预期语气。
- 用具体、直接的英语起草。
- 删除套话、陈旧的比喻、填充词、浮夸用语、不必要的抽象表达和可以避免的行话。
- 优先使用主动动词和明确的主语;但若被动语态更能突出重点、体现策略、营造悬念或确保技术准确性,则可使用被动语态。
- 保留必要的细微差别;不要为了简短而让文风粗糙、失实或平淡。
- 遵循 ASD-STE100 基本要求。检查术语、句子结构、指令和技术例外。
修订现有文本时:
- 保留用户的原意以及明确提出的语气或格式要求。
- 删除不起作用的词语、从句和句子。
- 将陈旧的修辞手法换成直白的表达或新颖、具体的意象。
- 在不影响准确性的前提下,将冗长、外来、科学或行话术语换成日常英语。
- 行动者很重要且已知时,将被动结构改为主动结构。
- 对于必须保留的行话、被动语态或华丽措辞,应予以标注,而不是擅自删除重要的精准表达。
- 最后进行一次 STE 检查。确认每个技术术语用法一致,每条指令都说明了必要操作,并且每项例外都有明确理由。
创意写作
对于小说、诗歌、回忆录、剧本和抒情散文,将 STE 视为帮助表达清晰的工具,而不是凌驾于用户文体之上的硬性要求。当刻意的模糊、韵律、对话风格、意象和人物声音能产生真实效果时,请予以保留。只删去那些显得陈旧、浮夸、闪躲或懒散的语言。仅在用户明确要求时才严格遵循 STE,并指出该要求与创作效果存在冲突的情况。
评论
支持 Markdown