关于 better-portuguese
面向 Agent 的巴西葡萄牙语写作技能,提供起草与编辑规范,强调根据文本用途调整表达,并保留原意、语气和技术术语。
主要功能
- 01巴西葡萄牙语编辑规范
- 02起草与修订工作流
- 03保留含义与情态
- 04按语境处理技术语言
适用场景
- 01起草巴西葡萄牙语文本
- 02保留原有风格修订葡萄牙语
- 03编辑技术文稿且不改变原意
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rafaelquintanilha/ skills --skill better-portuguese安装后在 Claude Code 中输入/better-portuguese确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/editorial-standard.mdgrammar-and-style.mdpunctuation.md详细介绍
更好的葡萄牙语
用自然的巴西葡萄牙语撰写所需内容。除非任务本身另有要求,否则推理、开发指令和工具通信均使用英语。
本标准针对巴西葡萄牙语(PT-BR)制定。不要默默将欧洲、非洲或其他葡萄牙语变体规范为巴西用法,也不要将本技能描述为这些变体的权威标准。
请将本技能视为一种有鲜明主张的编辑标准,而非对话人格、通用语法检查器,或模仿特定平台俚语的方式。所有内容均采用同一套葡萄牙语标准;内容的用途决定其长度、结构、语域和信息密度。
对于新草稿或明确要求进行风格改写的内容,请采用此处定义的鲜明风格。对于纠正、审阅或轻度编辑已有的、质量合格的葡萄牙语,请保留其合理的原有风格,只修改实际错误或用户要求重新考虑的部分。
处理句子层面的散文时,请先阅读标点指南,再阅读语法与风格参考。最后,在起草或修改内容之前阅读编辑标准,确保最终的解构审查是最后一项应用的编辑指令。单独的标签、按钮或类似的简短界面元素,无需查阅标点指南或语法与风格参考。
遵循编辑工作流程
- 明确内容约定:目的、受众、格式、长度或空间限制、语域、所要求的语气或情绪、必需事实、受保护的含义、必须原样保留的文本,以及不确定之处。谨慎推断缺失的约束。将提供的网址视为来源定位信息,而非装饰性背景。只要可以使用工具,且产品命名、语法规范、内部术语或事实主张取决于该网址,就应在起草前检查它。如果无法检查,不要编造缺失的规范或事实。
- 提取内容必须表达的命题及其关系。源文为英语时,应保留这些命题及其关系,而不是保留原文的句式结构或修辞框架。空间有限时,有意舍弃次要命题;不要把不同谓词压缩成并列结构,以免改变它们各自的作用。
- 直接用葡萄牙语起草。按照葡萄牙语中思路自然展开的方式组织文本。
- 暂时搁置第一份完整草稿,并依据编辑标准对实际措辞进行强制编辑审查。将草稿视为另一位作者写的散文。先检查内容约定,再逐句解构句法和词汇。
- 回到提取出的命题,并据此重写所有受影响的结构。不要仅靠孤立替换同义词,或逐一替换修辞位置,来修补翻译腔文本。如果源文堆砌标签或使用套路化对比,请将命题重新分配到不同分句中。如果第一份草稿的分句框架有缺陷,就舍弃该框架,不要在原处修补。
- 再次审阅改写后的内容。只有当文字自然地道,且内容仍能实现其预期功能(包括语气、正式程度、长度和结构)时,才算完成。除非用户要求提供备选方案、进行对比或说明理由,否则直接返回内容,不附加编辑说明。
保留含义和责任归属
- 保留事实、论点、意图、确定性、不确定性、情绪、归属、承诺和范围。
- 准确保留施事关系和情态。不要把某人能够做的事改成其正在做或必须做的事,也不要把观察到的行为改成建议。
- 保留赋予每项事实特定作用的谓语。不要仅为缩短句子,就让一个动词支配性质不同的数量或动作。
- 用最简单、自然的表达方式保留情态。不要仅为避免改变情态,就改用名词化释义或迂回表达。
- 不要强化、弱化或消除源文中固有的歧义。
- 除非明确要求转换,否则命令、路径、环境变量、标识符和字面错误消息均保持不变。保留产品和 API 名称的词形,但按照下文所述,将短语融入葡萄牙语语法;明确要求使用精确显示名称的情况除外。
根据语境确定技术语言
- 如果外语技术术语是领域内的既定术语,或者翻译会损失精确性、暗示不同概念,或降低目标读者的理解度,则保留该术语。
- 如果常用葡萄牙语术语同样精确、自然,则优先使用该术语。
- 将每个保留的术语融入葡萄牙语语法。根据该术语所指的葡萄牙语概念选择冠词、性、数、介词及周边措辞,不要机械地依据源语言处理。
- 使用保留的名词或缩写前,先确定其所指的葡萄牙语中心名词或概念,并在冠词、缩合形式、形容词和后续指代中贯彻其性和数。因此,接口可以是
a CLI,而被理解为一种技能的 skill 可以是uma skill。 - 专有名称应使用源文、相关组织或相关语言社群所确立的冠词和性。不要根据公司、服务、产品、出版物或平台等临时描述臆造固定惯例。系词后的表语不会反过来决定主语的性。
- 有源材料或源网址时,应检查自指用法,寻找能体现惯例的形式,包括冠词或
do、da、no或na等缩合形式。不要忽略这些证据,再根据之后出现的类别标签推断性。如果无法获取源文或无法确定惯例,则使用明确的中心词,如a plataforma或o serviço,或者采用无需冠词的限定关系表达。不要猜测;如果去掉冠词或介词会造成不自然的名词并置,也不要这样做。 - 保留技术术语或品牌,并不意味着要保留英语语序。除非源文明确要求使用精确显示名称,否则应将专有名称与通用技术名词视为一个句法短语,无论源文中的顺序如何。保留词汇项,将类别词放在葡萄牙语要求的位置,并使用恰当的介词表达来源、所有权或关联关系:
o SDK do Atlas、a API do serviço。不要照搬英语的名词堆叠形式,如o Atlas SDK,也不要像a API Atlas那样省略关系。 - 只有在目标读者或首次使用的语境有需要时,才解释保留的术语。不要依赖固定词汇表;应根据含义、领域和受众作出判断。
评论
支持 Markdown