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.

Install it, pinned
mdr add daftai2026/daftai-skills/daftai-chinese-technical-writing@git:20261014.3b0326f

Pins 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

The exact contents, by fingerprint
mdr add daftai2026/daftai-skills/daftai-chinese-technical-writing@sha256:0159ee6248910558

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_d7w6q2ocswxbovj3.svg)](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.

versioncommittedcommitsizeaudit
git:20261014.3b0326f latest2026-10-14 3b0326f 8,816 BA view · diff
git:20261014.b21bd502026-10-14 b21bd50 9,411 BA view · diff
git:20261014.677457a2026-10-14 677457a 7,931 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

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.

More from daftai2026/daftai-skills

AGENTS.md AGENTS.md file
daftai2026/daftai-skills · AGENTS.md
git:20261014.d220237 · audit B · 18 stars
CLAUDE.md CLAUDE.md file
daftai2026/daftai-skills · CLAUDE.md
git:20261014.d220237 · audit B · 18 stars
daftai-chinese-copywriting SKILL.md skill
daftai2026/daftai-skills · skills/daftai-chinese-copywriting/SKILL.md · Checks and fixes Chinese copywriting with autocorrect-backed workflows for text and single-file Markdown/TXT inputs…
git:20261014.677457a · audit B · 18 stars
CLAUDE.md@skills/daftai-cloudflare-billing-audit CLAUDE.md file
daftai2026/daftai-skills · skills/daftai-cloudflare-billing-audit/CLAUDE.md
git:20261014.5acb415 · audit A · 18 stars
daftai-cloudflare-billing-audit SKILL.md skill
daftai2026/daftai-skills · skills/daftai-cloudflare-billing-audit/SKILL.md · Audits a Cloudflare application repository for code paths and configuration that may create usage-based billing…
git:20261014.d220237 · audit A · 18 stars
CLAUDE.md@skills/daftai-cloudflare-billing-audit/references CLAUDE.md file
daftai2026/daftai-skills · skills/daftai-cloudflare-billing-audit/references/CLAUDE.md
git:20261014.d220237 · audit A · 18 stars
daftai-extracting-video-subtitles SKILL.md skill
daftai2026/daftai-skills · skills/daftai-extracting-video-subtitles/SKILL.md · Extracts timed subtitles from local video/audio files using Whisper. Outputs SRT format with accurate timestamps…
git:20260327.38c81a4 · audit A · 18 stars
daftai-gpt-image-2-5-prompt-optimizer SKILL.md skill
daftai2026/daftai-skills · skills/daftai-gpt-image-2-5-prompt-optimizer/SKILL.md · Optimizes natural-language image requests and rough prompts into ready-to-use GPT Image 2.5 prompts using the official…
git:20260910.0f5afd5 · audit A · 18 stars
daftai-image-to-svg SKILL.md skill
daftai2026/daftai-skills · skills/daftai-image-to-svg/SKILL.md · Converts transparent or solid-background single-color PNG files and SVG files containing one embedded or local PNG into…
git:20260704.214568e · audit A · 18 stars
daftai-subtitle-translator SKILL.md skill
daftai2026/daftai-skills · skills/daftai-subtitle-translator/SKILL.md · Translate subtitle files (SRT/VTT) between languages. Auto-detect source language, batch translate with count…
git:20260327.38c81a4 · audit A · 18 stars
daftai-url-to-markdown SKILL.md skill
daftai2026/daftai-skills · skills/daftai-url-to-markdown/SKILL.md · Fetch any URL and convert to markdown using Chrome CDP, with automatic image downloading. Supports auto-capture and…
git:20260327.38c81a4 · audit B · 18 stars
daftai-video-compositor SKILL.md skill
daftai2026/daftai-skills · skills/daftai-video-compositor/SKILL.md · Embeds a local video into an exact rectangular or rounded region of a screenshot or static image, preserving…
git:20261014.677457a · audit A · 18 stars

Every file in daftai2026/daftai-skills

Browse by kind, by grade A, or by owner.