peer-facing-writing SKILL.md skillA
peer-facing-writing from webkubor/writing-standard-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add webkubor/writing-standard-skills/peer-facing-writing@git:20260910.b68d609Pins git:20260910.b68d609 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- webkubor/writing-standard-skills
- Path
skills/peer-facing-writing/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260910.b68d609, committed Sep 10, 2026
- Size
- 17,575 bytes
- Repository stars
- 6
- License
- MIT
写给同事看的文本（GitLab 单据、飞书文档、评审意见、群消息、PR review、跨团队报告）的语气与结构规范，基于职场协作与社会心理学。触发："提单 / 写报告 / 写文档给 QA 或后端 / 评审意见 / 回评 / 跨团队沟通 / 文案不合理 / 这样礼貌吗 / 语气太硬"。反触发：写给 owner 本人的对话回复走 reply-format-low-cost，那是另一套（对上要极简，对同侧要留余地）。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 对同事的书面沟通 给同事看的文本和给 owner 的汇报是**两套语气**。对 owner 要极简、结论先行、不铺过程（`cs rule reply-format-low-cost`）；对同侧同事要**留余地、给台阶、不越位**——因为他们不欠你执行，你也不是他们的上级。 判断标准只有一条：**这段话如果原样念给对方听，他会想解决问题，还是想先自我辩解？** 后者就是写坏了。 ## 零、先用金字塔原理搭骨架（结构定了再谈语气） 语气问题好改，结构错了整篇要重写。**动笔前先按金字塔原理搭骨架**：结论先行、以上统下、归类分组、逻辑递进。 ### 结论先行 —— 答案放在第一屏 读者的第一个问题永远是「结论是什么、要不要我动」。把它放在开头，证据放在后面供需要的人下钻。 ``` ✅ 7 条已全部复验：3 条已修复、1 条真缺陷已转后端、3 条要更新用例。前端无遗留。 （下面才是逐条明细、判据、复现步骤） ❌ 先讲复验方法 → 再讲每条怎么测的 → 最后一段才说结论 ``` **检验**：只读前 5 行，读者知不知道结论和自己要做什么？不知道就是没做到结论先行。 ### SCQA —— 开篇四句话把人带进上下文 用在文档开头或单据的「背景」段。四句，各一到两行，不要展开： | | 写什么 | 例（本次冒烟报告） | |---|---|---| | **S** 情境 | 对方已知的事实，建立共同起点 | 1.0.6 冒烟 120 条上轮跑完，7 条 failed | | **C** 冲突 | 发生了什么变化，让现状不成立 | 之后前端又修了几轮，环境已经不是上轮那个构建 | | **Q** 疑问 | 因此自然产生的问题 | 这 7 条现在还失败吗？分别该谁处理？ | | **A** 答案 | 你的结论，一句话 | 3 条已修复、1 条真缺陷转后端、3 条要改用例 | **S 一定要是对方已知的**。写成「我做了 X」就不是 SCQA，那是自述。SCQA 的作用是让对方觉得「对，我知道这个背景」，然后顺着你的逻辑走下来。 ### MECE —— 分组必须不重不漏 **Mutually Exclusive（相互独立）**：任何一条内容只能出现在一个分组里。 **Collectively Exhaustive（完全穷尽）**：分组加起来覆盖全部，数字能对上。 两个高频违反： 1. **重叠**：同一件事在「三项待办」和「后续动作表」里各写一遍 —— 读者不知道哪份是准的，改了一处另一处就过期。**同类信息只留一处，别处只引用。** 2. **不穷尽**：说「7 条已复验」，分组却只写了 6 条，或分组数字加起来不等于总数。**每次分组后做一次加法**。 …
Read the whole file at its exact version.
How to install
mdr add webkubor/writing-standard-skills/peer-facing-writing@sha256:abb3f7ef806485dfThe line at the top of this page pins the label git:20260910.b68d609, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_isobduxxcjgbksq6)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 10, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (17575 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
webkubor/writing-standard-skills · 6 stars · license MIT · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_isobduxxcjgbksq6 GET https://markdownregistry.com/api/v1/resolve?ref=webkubor/writing-standard-skills/peer-facing-writing GET https://markdownregistry.com/api/v1/blob/abb3f7ef806485df5bafce1925b28fc3c05394a65db4b1445737782086324d8f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.