client-facing-docs

仓库创建 2026年7月6日最近提交 21 天前SkillHot 收录 20 天前

▸ 精选理由

强调可读性与诚实数字，适合对外沟通与决策材料准备。

这个 Skill 做什么

为客户撰写无术语、含现实数据和工程原则的技术文档与提案。

面向客户写技术文档和提案，把复杂内容变成客户能懂的白话、给出真实数据与工程权衡。用于架构说明、项目建议书、Kickoff 演示或交付报告，目标是让非技术方也能判断风险与价值。特点是去掉术语迷宫、解释关键决策并给出务实的实现原则。

▸ 展开 SKILL.md 英文原文

Writing client-facing technical documentation — architecture documents, proposals, project presentations — in plain language, jargon-free, with honest numbers and explicit pragmatic engineering principles. Use whenever the material will be read by a client or non-technical stakeholder - architecture doc, kickoff presentation, proposal, delivery report or closing email.

内容创作对外文档简洁表达面向客户通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/JoaoEquer/Oficina/main/skills/client-facing-docs/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/JoaoEquer/Oficina/main/skills/client-facing-docs/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Client-facing documentation

A document for a client is not a technical document with a nice cover. It is a different kind of writing.

## Principles

1. **Zero untranslated jargon.** "Monorepo" becomes "a single repository". "Multi-tenant" becomes "each company with its data isolated". "CI/CD" becomes "every change passes automated checks before going live". If a technical term must appear, a one-sentence explanation comes with it.
2. **Honest numbers.** Hours, deadlines and scope reflect the real contract — never a partial version that "presents better". A wrong number in presented material is the kind of thing that erodes trust and is very expensive to fix later.
3. **Document scope = c

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有