humanizer

Files (5)

• LICENSE
• SKILL.md
• SOURCE.md
• openai.yaml · agents/
• humanizer-original.md · references/

SKILL.md (first lines)

# humanizer

创建时间：未知（历史文档未记录）

修改时间：2026-10-11

统一处理文字是否易懂、是否带有 AI 套话这两类问题。根据读者和文本用途调整表达，保留准确的技术含义与事实。

## 用途与输入

适用于文章润色，以及代码说明、注释、README 和技术文档的编写或修改。

输入是写作任务或待修改的文字、文件；解释实现时还需要相关代码或资料。可选输入包括读者背景、写作样本、输出语言和必须保留的格式。

使用示例：`请用 humanizer 修改这份实现说明，解释陌生术语，去掉套话，并保留代码实际支持的条件和限制。`

## 使用步骤

1. 阅读[上游写作与润色规则](references/humanizer-original.md)，结合任务确定读者、用途和作者语气。遵守其中保留事实、匹配写作样本及按文本类型调整语气的要求。
2. 编写新文字时，依据用户提供的材料起草；修改已有文字时，检查整段表达和句子含义。技术内容同时应用“中文技术表达”，在同一轮修改中处理易懂程度与 AI 套话。
3. 完成“交付前检查”，对照原材料复核事实、条件和限制，交付最终文字。修改文字时保持代码块、代码标识符、命令、路径、YAML 和链接目标不变；用户明确要求修改这些内容时，按其授权范围处理。

文件任务和被其他 Skill 调用时，只写或返回最终版本。独立润色粘贴文本时按上游输出规则交付；用户指定输出格式时遵循用户要求。

Agent 指令文档的规则组织、引用条件和完成标准由 writing-for-agents 负责；它调用本 Skill 时，按其已确定的结构和约束完成表达检查，无需额外调用 writing-clearly-and-concisely。

## 中文技术表达


写代码说明、注释和文档时，根据用户提供的信息判断读者背景。没有说明时，默认读者不熟悉当前项目的内部实现。已在当前对话或文档中解释清楚的概念，无需重复介绍。

### 写作要求

- 用具体的主体和动作说明行为：谁在什么条件下，对什么做了什么，最后产生什么结果。将抽象描述改成代码实际执行的操作。
- 必须使用读者可能陌生的专业术语时，首次出现就用一句话解释。缩写首次出现时，补充全称及其在当前场景中的含义。
- 面向用户的说明先写可观察到的行为；面向开发者的说明先写相关组件或函数的行为，再介绍理解它所需的实现细节。
- 复杂机制难以仅用文字讲清楚时，给出一个具体的输入、处理过程和输出示例。示例应符合实际实现；为方便理解而假设的数据或条件，要明确说明。
- 保留准确的函数名、配置项、命令、数据类型和必要术语。通俗化时保留原有的条件、限制和失败情况。
- 注释优先解释代码的意图、约束或容易误解的行为；文档按读者完成任务所需的程度展开。简单问题直接回答，不强制套用固定结构。

### 改写示例

以下示例假设代码确实能防止同一条保存请求造成重复写入。

原句：

> 通过幂等机制实现状态收敛，保障链路一致性。

改写：

> 同一条保存请求即使收到两次，也只写入一次，避免产生重复记录。这里的“幂等”指重复执行同一个操作，结果仍和执行一次相同。

实际改写时，根据代码确认原句涉及的行为。缺少依据时说明尚未确认的部分；示例只用于说明表达方式，不能作为具体项目的实现依据。

## 交付前检查

结合上游的 AI 套话检查，通读本次新增或修改的文字，直接修正以下问题：

- 句子听起来很专业，却没有说明具体行为或结果。
- 术语解释又引入了未经解释的陌生术语。
- 示例、效果或保证超出了代码和已有资料能支持的范围。
- 解释重复了读者已经知道的内容，或注释只是复述代码。

检查完成后交付最终文字；仅在用户要求时附检查过程。

## 依赖与输出

依赖语言模型及随目录提供的上游参考文件，无额外程序依赖。输出为符合用户任务格式的文字或获准修改的文件；缺少实现依据时明确说明待确认内容。

本地扩展、上游版本和许可证见 [SOURCE.md](SOURCE.md)。

From Hex4C59/my-skills, MIT.

More from Hex4C59/my-skills