daftai-chinese-technical-writing SKILL.md skillA
daftai-chinese-technical-writing from daftai2026/daftai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add daftai2026/daftai-skills/daftai-chinese-technical-writing@git:20261014.3b0326fPins git:20261014.3b0326f in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- daftai2026/daftai-skills
- Path
skills/daftai-chinese-technical-writing/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261014.3b0326f, committed Oct 14, 2026
- First version recorded
- Oct 14, 2026
- Size
- 8,816 bytes
- Repository stars
- 18
- License
- none declared
Writes, rewrites, and reviews Chinese technical documentation, product copy, and UI microcopy using ruanyf/document-style-guide, STE-inspired Chinese methods for procedural passages, and separate product and UI extensions. Use for 中文技术写作, README, API documentation, 操作指南, 安装部署说明, 故障排查文档, 运维 Runbook, 工具描述, Agent 指令文案, 产品介绍, 功能说明, 界面文案, 按钮, 空状态, and 错误提示 when the task concerns meaning, structure, or wording. Delegates requested formatting checks to daftai-chinese-copywriting. Pure punctuation or…
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
# 中文技术写作 让读者理解事实、完成任务、预知操作后果。 不把中性说明改成新闻稿或作者随笔。 ## 1. 角色与读者 | 场景 | 读者要完成的事 | 写作重点 | | --- | --- | --- | | 技术文档 | 理解概念或复现操作 | 前置条件、步骤、预期结果、失败路径 | | 产品文案 | 判断功能是否适合自己 | 读者任务、已知能力、适用边界、下一步 | | 界面文案 | 判断状态并完成当前操作 | 动作、对象、结果、恢复方法 | 优先使用已有材料中的读者和任务。 只有缺失信息会改变结论时,才集中追问。 不为普通写作启动偏好问卷。 ## 2. 写作原则 ### 编辑取舍 发生编辑冲突时,依次保留: 1. 事实、逻辑、安全信息和不可改字面量。 2. 用户指定的任务模式与修改范围。 3. 项目术语和真实界面名称。 4. 适用的写作方法。 5. 语气、标点和其他风格偏好。 不能为了短句或统一风格删除更高优先级的信息。 ### 信息与结构 - 标题交代主题或任务。不要用悬念代替信息。 - 操作说明先写前置条件,再写动作和结果。 - 一段围绕一个主题。把中心句放在段首。 - 标题层级连续。不要强制短文套完整手册目录。 - 顺序重要时用编号。并列选项用无序列表。 - 文件命名建议只用于新文档,不重命名既有文件或破坏链接。 ### 句式与节奏 - 优先短句、主动句。让执行者和动作明确。 - 条件在前,动作在后。拆开层层嵌套的修饰语。 - 用肯定句消除双重否定,但保留禁止和权限限制。 - 字数与行数只作审阅提示,不替代语义判断。 - 不为缩短句子删除例外、风险或恢复条件。 ### 词语与术语 - 同一概念使用同一名称。界面名与真实界面一致。 - 不同概念保留区别,不因词形相近合并动作或状态。 - 用具体动作替代空泛表达。必要时明确动作对象。 - 首次引入陌生术语时解释一次。后文固定称呼。 - 保留官方名称、命令、参数、路径和资源键。 - 保留数字、单位、比较基准和限定条件。 - 区分“增加了”和“增加到”、百分比和百分点。 ### 文案落点 - 技术说明交代成功结果。不能只写“执行以下命令”。 - 产品文案把能力落到读者任务,不添加无依据的效果。 - 界面文案说清当前状态和可执行的下一步。 - 按钮描述动作。删除操作需说明对象与已知后果。 - 示例属于写法演示,不是产品能力证据。 ## 3. 忌口表 只修改无事实支撑或妨碍理解的表达。 | 表达 | 替换动作 | 原因 | | --- | --- | --- | | 强大、极致、全面赋能 | 写出已知能力与适用对象 | 空泛判断无法帮助选择 | | 极大提升效率、提升 N 倍 | 有数据就保留基准;无数据就删除断言 | 不制造效果证明 | …
Read the whole file at its exact version.
How to install
mdr add daftai2026/daftai-skills/daftai-chinese-technical-writing@sha256:0159ee6248910558The line at the top of this page pins the label git:20261014.3b0326f, 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_d7w6q2ocswxbovj3)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, all committed on Oct 14, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261014.3b0326f latest | 2026-10-14 | 3b0326f | 8,816 B | A | view · diff |
| git:20261014.b21bd50 | 2026-10-14 | b21bd50 | 9,411 B | A | view · diff |
| git:20261014.677457a | 2026-10-14 | 677457a | 7,931 B | A | view |
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 (8816 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
daftai2026/daftai-skills · 18 stars · license none declared · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_d7w6q2ocswxbovj3 GET https://markdownregistry.com/api/v1/resolve?ref=daftai2026/daftai-skills/daftai-chinese-technical-writing GET https://markdownregistry.com/api/v1/blob/0159ee6248910558829ac2d2135743b273befda8a8c117266109f5564acc0192
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.