用途 plain-language 是一个文风与文字清理技能,用来约束智能体在会话中自己写出的自由文本。它在会话开始时加载一次并保持加载,之后每次回复都从上下文中应用这些规则,不需要再次读取。上下文丢失或内容变化后需要重新加载。
主要能力 它要求聊天的行文先给结论,简洁但用完整句子;采用 ASD-STE100 简化技术英语,即主动语态、现在时、短句、一句一个意思、一词一个含义;含三个以上标识符的句子要拆分。术语严格使用 GLOSSARY.md 中的词,日常词优先。代码、数据库、API、路由、界面和文件名等标识符保持原样,先说平实的实际效果,再给标识符,每个技术术语解释一次。不使用未解释的缩写和纯箭头式流程。
清理范围仅限自由文本,包括聊天回复,提交信息、PR 正文与评论、Issue 正文与评论、发布说明的文字部分,任务要求撰写的人类可读指南或 README 文本,以及用户交给你清理的文字。范围内文本中的代码片段、标识符和引用行属于受保护文本。
它列出要删除的表达模式,分为内容、语言、风格、沟通痕迹、填充词和行话几类。内容包括:浮于表面的 -ing 短语(如 highlighting、ensuring、reflecting、showcasing、fostering),删除或用真实来源展开;含糊的归因(如 Experts believe、Industry reports suggest),要么点名来源,要么删掉。
语言方面要替换的 AI 词汇包括 additionally、crucial、delve、enduring、enhance、fostering、garner、interplay、intricate、landscape(抽象义)、pivotal、showcase、tapestry(抽象义)、testament、underscore、vibrant 等,改用平实词。把 serves as、stands as、boasts、features 这类绕弯说法改回 is 或 has。不用“Not just X, but Y”句式,直接说要点。不强行三点式罗列,按自然数量写。不在同一段里给同一事物轮换同义词,选一个并重复使用。不用虚假范围(from X to Y,而 X 与 Y 不在有意义的尺度上),直接列出主题。
风格方面:避免使用破折号,用句号或逗号分隔;冒号只用于列表或示例之前,不用作句中连接;不要给每个专有名词或缩写加粗;不把“粗体标签加冒号再复述行”的内联小标题列表当作正文,改成散文;标题用句子式大小写;去掉装饰性表情符号;使用直引号而非弯引号。
沟通痕迹方面去除聊天机器人套话(如“I hope this helps!”、“Let me know if...”)和谄媚语气。填充词方面,in order to 改为 To,due to the fact that 改为 Because,删掉 It is important to note that;减少过度模糊限定;避免泛泛的结论。行话方面,substrate、wedge、vector、locus、nexus、primitive(名词)、harness(隐喻)、surface(如 API surface)、bedrock、scaffolding(隐喻)、modality、paradigm、gold-plating、ratchet(隐喻)、north star、flywheel 等抽象隐喻名词要换成具体的平实词。
使用方式 会话开始时,在第一次报告门控更新之后,如运行时提供 Skill 工具就调用 plain-language;否则先读项目内 .agents/skills/ 或 .claude/skills/ 下的 SKILL.md,再读用户级副本。之后每次实质回复前和定稿书面内容前,对本次任务所写的文字应用规则。清理草稿要在请求批准之前完成;已批准的措辞如需改动要重新获得批准。用户提出“Clean this”“remove the AI tells”“make this plain”时,返回清理后的文本,再加一行:Prose cleanup: <n> edits; protected spans kept: <m>。如果技能缺失,每个会话说明一次,并遵循工作区 AGENTS.md 中的文风说明。
限制 清理不授予任何工作流权限:不因文字变干净就发布、提交、推送、上线或关闭任何东西。不得为替换含糊说法而编造事实,只能用任务提供的事实或删除该说法。只重写为当前任务写的或编辑的散文,不改无关文字,不改变含义、证据、限定条件和数字。模板、标记、标题、字段标签、规范行、Issue 标题格式、代码、命令、路径、引用以及其它技能强制要求的逐字内容都保持原样。该技能在当前会话内联运行,不派发子智能体,除自身文件外不读其它文件。源代码、测试、配置、脚本、迁移、生成文件、代码注释和文档字符串,以及 ADR、规格、提示词和术语表条目都不在编辑范围内;如果清理请求指向这些内容,应说明并停止。