本文へ移動
cccskills
無料GitHub で公開

daftai-chinese-technical-writing

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 spacing tasks belong to that skill; personal essays and author-voice articles do not belong here.

インストール方法を見る

含まれるファイル(15)

  • SKILL.md8.6 KB
  • references/acceptance-cases.md10.9 KB
  • references/controlled-technical-chinese.md5.7 KB
  • references/diff-update-loop.md1.7 KB
  • references/formatting-handoff.md3.1 KB
  • references/product-copy.md1.8 KB
  • references/ruanyf-marks.md4.9 KB
  • references/ruanyf-number.md1.7 KB
  • references/ruanyf-paragraph.md834 B
  • references/ruanyf-structure.md2.0 KB
  • references/ruanyf-text.md5.2 KB
  • references/ruanyf-title.md1.4 KB
  • references/source-guide.md7.2 KB
  • references/style-evidence.md383 B
  • references/ui-copy.md2.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

中文技术写作

让读者理解事实、完成任务、预知操作后果。 不把中性说明改成新闻稿或作者随笔。

1. 角色与读者

场景读者要完成的事写作重点
技术文档理解概念或复现操作前置条件、步骤、预期结果、失败路径
产品文案判断功能是否适合自己读者任务、已知能力、适用边界、下一步
界面文案判断状态并完成当前操作动作、对象、结果、恢复方法

优先使用已有材料中的读者和任务。 只有缺失信息会改变结论时,才集中追问。 不为普通写作启动偏好问卷。

2. 写作原则

编辑取舍

发生编辑冲突时,依次保留:

  1. 事实、逻辑、安全信息和不可改字面量。
  2. 用户指定的任务模式与修改范围。
  3. 项目术语和真实界面名称。
  4. 适用的写作方法。
  5. 语气、标点和其他风格偏好。

不能为了短句或统一风格删除更高优先级的信息。

信息与结构

  • 标题交代主题或任务。不要用悬念代替信息。
  • 操作说明先写前置条件,再写动作和结果。
  • 一段围绕一个主题。把中心句放在段首。
  • 标题层级连续。不要强制短文套完整手册目录。
  • 顺序重要时用编号。并列选项用无序列表。
  • 文件命名建议只用于新文档,不重命名既有文件或破坏链接。

句式与节奏

  • 优先短句、主动句。让执行者和动作明确。
  • 条件在前,动作在后。拆开层层嵌套的修饰语。
  • 用肯定句消除双重否定,但保留禁止和权限限制。
  • 字数与行数只作审阅提示,不替代语义判断。
  • 不为缩短句子删除例外、风险或恢复条件。

词语与术语

  • 同一概念使用同一名称。界面名与真实界面一致。
  • 不同概念保留区别,不因词形相近合并动作或状态。
  • 用具体动作替代空泛表达。必要时明确动作对象。
  • 首次引入陌生术语时解释一次。后文固定称呼。
  • 保留官方名称、命令、参数、路径和资源键。
  • 保留数字、单位、比较基准和限定条件。
  • 区分“增加了”和“增加到”、百分比和百分点。

文案落点

  • 技术说明交代成功结果。不能只写“执行以下命令”。
  • 产品文案把能力落到读者任务,不添加无依据的效果。
  • 界面文案说清当前状态和可执行的下一步。
  • 按钮描述动作。删除操作需说明对象与已知后果。
  • 示例属于写法演示,不是产品能力证据。

3. 忌口表

只修改无事实支撑或妨碍理解的表达。

表达替换动作原因
强大、极致、全面赋能写出已知能力与适用对象空泛判断无法帮助选择
极大提升效率、提升 N 倍有数据就保留基准;无数据就删除断言不制造效果证明
进行配置操作、实现文件的上传改成“配置…”、“上传文件”消除动词空壳
其、该、此对象指代不明重复具体对象的名称防止操作对象歧义
操作失败、出错了补充已知失败对象与恢复动作不虚构未知原因
确定、好的用于具体业务动作换成“保存设置”等动作名让按钮可独立理解
只需、轻松、一键核对真实步骤与限制;不符就删不掩盖成本和前置条件

4. 边界与易错点

  • 先保事实,再改表达。未知能力、时延、价格和恢复结果不能补写成事实。
  • 保留许可、建议、义务和确定程度,不把能力说明改成命令。
  • 保留否定范围、必要与充分条件、因果关系和动作完成条件。
  • 保留已完成、进行中、尚未发生及结果仍可用的区别。
  • 缺少关键事实时追问;可继续起草时,把待确认项放在交付说明中。
  • 原文中的命令、代码、公式、URL、占位符和插值语法保持原样。
  • 用户要求修改这些字面量时,单独核对,不把修改冒充排版修正。
  • JSON、YAML、源码文案只改目标字符串;保留键名、转义和程序结构。
  • 用户只要求检查时,不改原文件、不创建配置、不默认保存报告。
  • 只要求排版时,直接交给格式 Skill,不先重写措辞。
  • 作者文章的声线不属于这里。需要时再选择 daftai-writer,不强行混用。
  • 不为写作任务读写偏好文件,也不自动修改 Skill 文件。
  • 撰写或审阅操作说明不授权执行文中命令或改变产品流程。
  • 编辑工具描述或 Agent 指令只改获准文字,不重设工具保证、权限或工作流。

5. 与其他 Skill 协作

daftai-chinese-technical-writing 负责结构、术语与文意。 daftai-chinese-copywriting 负责标点、空格与全角半角。 先稳定语义,再检查机械格式,最后核对字面量。

用户要求格式检查或交付前排版验收时,读取 格式联动契约。 先读取目标格式 Skill 的 SKILL.md,再执行其命令。 检查用 review;明确要求修正时才用修正模式。 不复制 autocorrect 逻辑,不因写作任务安装工具。 工具缺失时如实说明,不能声称已经通过自动检查。

6. 工作流

  1. 确定任务:区分新写、改写、只读检查和纯排版。
  2. 按需读参考:按下表选择当前任务需要的文件。
  3. 锁定事实:核对对象、动作、数字、条件、术语与不可改字面量。
  4. 写作或审阅:保持用户指定结构和修改范围;没有指定时采用最小必要结构。
  5. 检查交付:核对事实、指代、状态、下一步;需要排版检查时委派格式 Skill。
  6. 交付:新写或改写优先给可用正文;检查给位置、问题和建议。只要正文时不附评分与长篇说明。

操作说明、工具描述、Agent 指令文案和状态消息等技术段落,读取 受控中文技术写作。 混合文档按段落应用,不把介绍、引用或短按钮套成步骤。 只修措辞时,不补方案;原文清晰时允许不改。

参考加载表

参考均随 Skill 安装。正常写作无需联网下载。 现有规则已足够时,不额外加载参考。

使用时机Reference
需要核对字间距、语法或译名细则文本原文
拟标题、调整层级标题原文
拆段、组织引用段落原文
出现数值、范围或增减幅度数值原文
判断标点语境或排版规则冲突标点原文
编排技术手册或新增文档文件文档体系原文
操作、部署、排查、安全说明、工具描述、Agent 指令或状态段落受控中文技术写作
产品介绍、功能说明、发布文案产品文案扩展
按钮、提示、空状态、错误与确认弹窗界面文案扩展
联动排版检查格式联动契约
查询方法出处、适配范围或许可证来源与适用范围

文件交付

默认在对话中交付。只有用户要求时才创建文件。 用户指定编辑现有文档时,在指定范围内修改。 用户要求另存且未指定路径时,使用 writing-output/<topic-slug>/。 目录冲突时追加 -YYYYMMDD-HHMMSS,不覆盖旧结果。 正文命名为 written-<slug>.md 或 revised-<slug>.md。 审阅命名为 review-<slug>.md。 另存时,把输入副本命名为 source-<slug>.<ext>,不修改原始输入。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Checks and fixes Chinese copywriting with autocorrect-backed workflows for text and single-file Markdown/TXT inputs. Use when user asks to normalize Chinese punctuation, spacing, or full-width/half-width usage. Also triggers for "校对", "检查排版", "中英文空格", "全角半角". Does not rewrite document structure, product claims, or UI messaging.

日本語の概要は準備中です。原文の説明を表示しています。

daftAI2026/daftAI-skills182026年10月14日 更新

Audits a Cloudflare application repository for code paths and configuration that may create usage-based billing exposure. Use when asked to inspect Cloudflare Worker, D1, Durable Objects, storage, queue, or compute usage for unexpected bills, billing risks, or cost drivers. Reports evidence and uncertainty. Runs offline by default; optionally correlates user-authorized, bounded evidence from existing official tools. Does not guarantee a spending cap.

日本語の概要は準備中です。原文の説明を表示しています。

daftAI2026/daftAI-skills182026年10月14日 更新

Extracts timed subtitles from local video/audio files using Whisper. Outputs SRT format with accurate timestamps. Handles complex filenames automatically. Use when user asks to "extract subtitles", "get subtitles", "transcribe video", "识别字幕", "提取字幕", or "获取字幕".

日本語の概要は準備中です。原文の説明を表示しています。

daftAI2026/daftAI-skills182026年10月14日 更新

Optimizes natural-language image requests and rough prompts into ready-to-use GPT Image 2.5 prompts using the official prompting guide as a live reference. Use when users ask to improve image prompts, 优化生图提示词, 把想法变成提示词, or write prompts for GPT Image 2.5 Flare or Sunburst. Produces prompt text, not images, unless the user explicitly asks to generate.

日本語の概要は準備中です。原文の説明を表示しています。

daftAI2026/daftAI-skills182026年10月14日 更新

Converts transparent or solid-background single-color PNG files and SVG files containing one embedded or local PNG into verified path-only SVG output. Removes pure-color backgrounds automatically. Uses Potrace threshold and parameter scans with alpha error metrics to preserve detailed logos, stamps, engravings, and line art. Use when the user asks to convert images to SVG, vectorize PNG, convert bitmap to true SVG, remove embedded raster data from SVG, 图片转矢量, PNG 转 SVG, 真矢量, or 位图描摹.

日本語の概要は準備中です。原文の説明を表示しています。

daftAI2026/daftAI-skills182026年10月14日 更新

Translate subtitle files (SRT/VTT) between languages. Auto-detect source language, batch translate with count validation, optional bilingual merge output. Use when user asks to "translate subtitles", "翻译字幕", "subtitle translation", or needs subtitles converted to another language.

日本語の概要は準備中です。原文の説明を表示しています。

daftAI2026/daftAI-skills182026年10月14日 更新

daftAI2026 のスキルをすべて見る

このスキルの問題を報告する