- name
SKILL.md
Файл навыка остаётся в репозитории издателя.
Вставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add dongshuyan/compass-skills --skill clear-communication -a cursor -yВставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add dongshuyan/compass-skills --skill clear-communication -a claude-code -yВставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add dongshuyan/compass-skills --skill clear-communication -a codex -yВставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add dongshuyan/compass-skills --skill clear-communication -a grok -yОтправьте скопированное сообщение в чат Grok Bot. Бот загрузит этот SKILL.md с GitHub и добавит его к навыкам, общим для всех ваших ботов.
Install this skill: https://github.com/dongshuyan/compass-skills/tree/HEAD/skills/clear-communicationОт издателя
帮助读者找到答案、理解关系并完成当前任务。清楚和自然是手段;不能以删减必要信息或强化结论换取流畅。
从请求和上下文判断读者知道什么、想解决什么。已有线索足够时直接写,不让用户额外填写受众问卷或寻找范文。只有缺失信息会改变结论或操作时才追问。
从材料中提取需要保留的事实、条件、例外、数字、否定、证据强度和执行状态。原回答也可能有错;改写应以可核对的原始材料为依据。材料冲突或不足时指出具体缺口,不补写合理但没有依据的细节。
按任务选择顺序:
这些是组织依据,不是每次必须出现的段落模板。
篇幅较长时,先用一句话确定读者读完应该明白什么或做什么。围绕它保留和排序信息:先让人获得足以理解或操作的一层,再补必要机制、依据和例外。读者问的是“现在怎么用”,就不要用实现细节做开头;读者在审查论证,则应先呈现结论成立的依据。不要把同一组信息分别重述为概述、正文和总结。
信息完整以读者的任务为准,不以原始记录的条数为准。先区分直接影响理解或操作的信息、需要时才查的信息,以及本次无关的记录。保留第一类;第二类只有确实有用时才作为短补充;第三类不搬进正文。这个取舍过程不用向读者展示。具体来说,上手说明应优先回答怎么开始、哪些功能尚不可用、如何启用可选功能或恢复;实现字段、事件名、测试计数和开发进度只有影响这些动作时才需要写出。不能因此删掉失败、尚未验证、恢复前提等重要限制。
让每句的动作、主体和指代容易辨认。连续出现抽象名词时,尝试写成“谁做了什么,产生什么结果”。拆长句时保留条件和因果,避免一串互不相连的短句。
熟悉的词足以表达同一含义时优先使用。术语有精确含义或读者需要检索它时应保留;解释它在这里如何工作,不按词典机械替换。一个概念保持同一个名称。
保留必要的逻辑桥梁:为什么这个事实支持这个结论、为什么先做这一步。例子和类比应说明机制或边界;假设例子标明是假设,不能变成新的事实依据。
同一材料需要改写时,可以重排事实、改变句式、把含混指代改为具体对象。不要只做同义词替换。一个段落推进一个主要问题;后一句接着前一句解释原因、条件或结果,避免把相关信息拆成需要读者自行拼接的碎片。
详略服务于当前问题。删去重复、空泛评价、反复自证和与读者决策无关的调查经过。不要为追求字数短而删去警示、失败、条件或关键解释;不以短句数量衡量效果。
对照材料检查:
如果已经清楚,保留原文;不要为了体现编辑工作强行改写。交付用户需要的内容,内部检查过程不自动附在正文里。
把安装记录、调查记录或密集材料改成面向使用者的说明时,先阅读 examples.md 的信息取舍示例;其他任务在需要时参考。这些例子用于说明取舍,不是固定措辞。
面向读者组织准确、易理解的解释、状态汇报、方案比较和文档;用于复杂概念说明、长文、重要条件的表达或保持原意的改写。适用于中英文,可与学术及其他领域写作规则组合使用。
---name: clear-communicationdescription: 面向读者组织准确、易理解的解释、状态汇报、方案比较和文档;用于复杂概念说明、长文、重要条件的表达或保持原意的改写。适用于中英文,可与学术及其他领域写作规则组合使用。---# skills/clear-communication/SKILL.mdFAQ
Скачайте skills/clear-communication/SKILL.md у издателя или скопируйте путь и откройте репозиторий. PlugMCP только показывает навык в каталоге и не хранит файл.
Издатель хранит его в https://github.com/dongshuyan/compass-skills.
Claude, Cursor, Codex и Grok Build могут читать SKILL.md, который вы добавляете из репозитория издателя. Grok Bot устанавливает его, когда вы отправляете в чат ссылку на папку навыка на GitHub.