mcpField
O
orwell-writing

orwell-writing

github.com/tamdogood创意与媒体225218 次安装10 周前更新
代码仓库

关于 orwell-writing

将 Orwell 的写作规则与 ASD-STE100 指南用于写作和修订,帮助改善技术及商务文案的清晰度,同时保留创作中有意为之的语气。

主要功能

  1. 01直接简洁的表达指南
  2. 02主动语态与明确主语
  3. 03术语保持一致
  4. 04技术说明写作模式
  5. 05文本修订流程
  6. 06保留刻意营造的创作语气

适用场景

  1. 01撰写技术说明
  2. 02编辑商务或产品文案
  3. 03删去含糊或浮夸措辞
  4. 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。

核心规则

请记住以下摘自《政治与英语》的规则:

  1. 不要使用你常在印刷品中见到的隐喻、明喻或其他修辞手法。
  2. 能用短词时,不要用长词。
  3. 只要可以删掉一个词,就删掉它。
  4. 能用主动语态时,不要用被动语态。
  5. 能想到日常英语中的对应说法时,就不要使用外语短语、科学术语或行话。
  6. 宁可违反以上任何一条规则,也不要说出明显粗鄙的话。

ASD-STE100 基本要求

对于技术和说明性文案:

  1. 使用短句。每句话只表达一个主要动作或陈述。
  2. 使用明确的主语和主动动词。行动者很重要时,要明确指出。
  3. 同一事物始终使用同一个术语。不要只为避免重复而更换术语。
  4. 使用含义明确的常用词。避免习语、俚语、比喻性语言和含糊的动词。
  5. 为确保准确而必须使用特定技术术语时,请对其作出定义或链接到相关定义。
  6. 缩短名词词组。使用介词说明术语之间的关系。
  7. 将步骤写成直接指令。说明条件、操作和预期结果。
  8. 指令清晰时,使用肯定表达。说明读者必须做什么。
  9. 除非用户的风格指南要求使用其他变体,否则统一使用美式英语拼写。
  10. 保留代码、命令、标识符、产品名称、法律文本和必需的引文。不要擅自简化这些内容。

如果无法严格遵循 STE,请保持文本清晰,并标出需要领域特定例外的术语或段落。

工作流

从头开始写作时:

  1. 根据用户的要求,确定受众、目的和预期语气。
  2. 用具体、直接的英语起草。
  3. 删除套话、陈旧的比喻、填充词、浮夸用语、不必要的抽象表达和可以避免的行话。
  4. 优先使用主动动词和明确的主语;但若被动语态更能突出重点、体现策略、营造悬念或确保技术准确性,则可使用被动语态。
  5. 保留必要的细微差别;不要为了简短而让文风粗糙、失实或平淡。
  6. 遵循 ASD-STE100 基本要求。检查术语、句子结构、指令和技术例外。

修订现有文本时:

  1. 保留用户的原意以及明确提出的语气或格式要求。
  2. 删除不起作用的词语、从句和句子。
  3. 将陈旧的修辞手法换成直白的表达或新颖、具体的意象。
  4. 在不影响准确性的前提下,将冗长、外来、科学或行话术语换成日常英语。
  5. 行动者很重要且已知时,将被动结构改为主动结构。
  6. 对于必须保留的行话、被动语态或华丽措辞,应予以标注,而不是擅自删除重要的精准表达。
  7. 最后进行一次 STE 检查。确认每个技术术语用法一致,每条指令都说明了必要操作,并且每项例外都有明确理由。

创意写作

对于小说、诗歌、回忆录、剧本和抒情散文,将 STE 视为帮助表达清晰的工具,而不是凌驾于用户文体之上的硬性要求。当刻意的模糊、韵律、对话风格、意象和人物声音能产生真实效果时,请予以保留。只删去那些显得陈旧、浮夸、闪躲或懒散的语言。仅在用户明确要求时才严格遵循 STE,并指出该要求与创作效果存在冲突的情况。

评论

支持 Markdown