| name | eliteforge-writing-clearly-and-concisely |
| description | 遵循斯特伦克式简洁写作原则改写面向读者的文字,使表达清晰、简洁且结构严谨。用户要求润色、精简、澄清、去重、重组或统一文档、README、技术说明、PR 描述、提交信息、错误信息、界面文案、报告或摘要的语气时使用。 |
| metadata | {"version":"1.0.2"} |
EliteForge 清晰简洁写作
遵循简洁写作原则,清楚表达,果断删减。
使用场景
编写下列面向读者的文字时使用本技能:
- 文档、README 和技术说明
- 提交信息和合并请求说明
- 错误信息、界面文案、帮助文本和注释
- 报告、摘要及其他说明性文字
- 以提高清晰度为目标的编辑任务
只要文字需要由人阅读,就使用本技能。
写作规范
所有面向读者的文字必须遵循以下规则:
- 优先使用简短、直接的句子。
- 除非被动语态明显更清楚,否则使用主动语态。
- 使用肯定形式陈述。
- 使用明确、具体、可验证的词语。
- 删除无用词语。
- 让关联词语彼此靠近。
- 结论前置;需要强调时,将重点放在句尾。
- 每段只表达一个主题。
- 避免套话、重复、过度保留和鼓动性表达。
- 只有不确定性确有意义时,才使用“大概”“可能”“基本上”等模糊限定词。
- 不写冗长开场或元话语。
- 删除不影响原意的句子。
输出最终内容前,静默复写一次,进一步提高简洁度和清晰度。
禁止的写法
- 不以“好的”“当然”“这个问题很好”等空泛回应开头。
- 不解释显而易见的步骤。
- 除非需要消除歧义,否则不复述用户需求。
- 短段落足够时,不使用冗长列表。
- 不使用宣传、煽情或恭维语气。