在 Codex 中使用下载的 Skill：把版本原稿整理成发布说明

你在本站下载了一个 Skill，打开压缩包却不知道从哪里下手。这一课用本站真实上架的 Humanizer zh 中文去 AI 味 Skill，把"下载之后"的每一步真正走完：放进 Codex 的项目技能目录、用一句话明确调用、拿到改写结果、再亲手复现"技能不出现"时怎么定位问题。

这一课的全部命令和输出都在 Windows 11、PowerShell、codex-cli 0.153.4 上实际运行过，运行日期 2026-09-08：白天完成首次验证，晚间又在全新目录按本文复跑一遍，并换了一份练习材料核验换稿流程，关键步骤的终端截图都在文中。练习资源固定为本站归档版本 commit-91f3d394。Claude Code 的对应做法见上一课，本文不重复。

这节课做完你会有什么

Humanizer zh 解决的问题很具体：把带宣传腔、套话和模糊表述的中文稿改得像人写的话。它不鉴定文字是不是 AI 写的，也不承诺通过任何检测工具。

本课的练习任务是让 Codex 把一段夸张的虚构版本原稿改写成发布说明，并且五项事实一个都不许丢：

1. 版本号 0.8.2 不变；
2. 发布日期 2026 年 9 月 10 日不变；
3. "给收藏添加标签"和"修复空标题保存失败"两项已完成内容都在；
4. 批量导出仍然写为开发中，没有被写成已交付；
5. 旧版本标签能否自动迁移，仍然写为未确认。

改写合格但事实走样，就是失败。这个检查思路比任何一次具体输出都重要——你以后换任何写作类 Skill，都用同样的办法验收。

开始前准备：软件、账号和费用

本课不要求购买第三方服务、申请云资源或部署服务器。下载本站的开源 Skill 本身免费；运行模型的账号成本以你自己的账号计划为准。

没装过 Codex 时，先装 Node.js LTS（从 Node.js 官网下载 Windows 安装包，一路默认），重开 PowerShell 检查：

node --version
npm.cmd --version

两条都返回版本号再安装 Codex：

npm.cmd install -g @openai/codex
codex.cmd --version

本课实测时 codex.cmd --version 显示 codex-cli 0.153.4。你的版本更新完全正常，不需要降到本文的版本。

第 1 步：下载本站资源包并解压

打开本站 Humanizer zh 中文去 AI 味 Skill 资源详情页，核对名称和版本 commit-91f3d394，用页面上的夸克或迅雷入口下载。本站页面上显示的版本就是网盘里那一个包，教程步骤与包内容一致。

下载得到的外层压缩包先"全部解压缩"，关键结构是：

RES-001014_humanizer-zh-chinese-writing-skill__commit-91f3d394/
├─ 资源详情介绍.md
├─ 开源与费用说明.md
├─ source/
│  ├─ SKILL.md
│  ├─ README.md
│  └─ LICENSE
└─ releases/
   └─ Humanizer-zh-commit-91f3d394.zip

解压完成后核对一下，source 里应该有 SKILL.md、README.md、LICENSE 三个入口文件，releases 里有内层包。下面是复跑时解压后真实看到的结构：

查看原图 ↗

如果你只拿到内层的 releases 压缩包，直接解压它也行，解出来是 Humanizer-zh-91f3d394… 文件夹，里面同样有这四个文件。两条路线任选一条；要安装的只是解压后的那个文件夹，不是压缩包本身。

打开 SKILL.md 读一遍开头：它的任务是文字改写，不是自动发布，也没有必须运行的脚本。LICENSE 为 MIT（Copyright (c) 2026 歸藏），保留这些文件和署名即可自由使用。

第 2 步：装进当前项目的技能目录

在文件资源管理器新建练习文件夹 C:\ai-practice\codex-release，在里面依次建 .agents\skills\humanizer-zh 三层文件夹，然后把上一步解压出的 SKILL.md、README.md、LICENSE 三个文件复制进去。结果应该是：

C:\ai-practice\codex-release\
└─ .agents\
   └─ skills\
      └─ humanizer-zh\
         ├─ SKILL.md
         ├─ README.md
         └─ LICENSE

三个常见坑，都检查一遍：

• 入口不能多套一层：…\humanizer-zh\source\SKILL.md 读不到，SKILL.md 必须直接在 humanizer-zh 文件夹下；
• 打开资源管理器的"文件扩展名"显示，确认文件名是 SKILL.md 而不是 SKILL.md.txt；
• 文件夹名 humanizer-zh 要和 SKILL.md 开头 name: humanizer-zh 一致。

为什么放在项目里而不是用户主目录：Codex 官方文档写明它从项目 .agents/skills 和个人 ~/.agents/skills 等位置发现技能。本课用项目位置，好处是技能只影响这个练习文件夹，删掉文件夹就等于卸载。

在资源管理器地址栏输入 powershell 回车，在练习文件夹里打开终端，做两个检查：

Get-Location
Test-Path -LiteralPath '.\.agents\skills\humanizer-zh\SKILL.md'

第一行应显示 C:\ai-practice\codex-release，第二行必须是 True。复跑时终端里真实的样子：

查看原图 ↗

第 3 步：运行并明确调用技能

仍在练习文件夹里，启动只读沙箱模式：

codex.cmd --sandbox read-only

首次启动会让你选择登录方式并跳转浏览器完成认证。只读沙箱意味着这一课不批准 Codex 写文件或执行更改类命令；练习材料也请保持不敏感，因为对话内容会发送给模型服务。

进入会话后，整段粘贴下面的请求。原稿也可以从 本课练习材料包 里取，包内还有五项检查点和排查用的最小诊断 Skill：

请使用 $humanizer-zh 改写下面的虚构版本原稿。
只在对话里输出，不联网检索、不执行脚本、不写文件。
输出"发布说明"和"待确认事项"两部分。
保持版本号、发布日期和状态，不添加性能数据、用户评价或下载地址。
不要把计划功能写成已交付。

原稿：
资料夹 0.8.2 将以划时代的创新重塑信息整理体验！
发布日期：2026 年 9 月 10 日。
本版已支持给收藏添加标签，也修复了空标题保存失败的问题。
批量导出仍在开发中，不包含在 0.8.2 中。
旧版本标签能否自动迁移，目前尚未确认。
这不仅是一次升级，更是高效工作的全新里程碑。

$humanizer-zh 是明确调用：$ 加技能名，Codex 会把对应技能的完整说明加载给模型。也可以输入 /skills 查看当前会话可用的技能列表（官方文档提供的技能选择器，本文以 $ 明确调用为准，列表界面随版本可能略有差异）。

成功后应该看到什么

下面是 2026-09-08 实际运行返回的原文（去掉会话编号等环境信息；你的模型名、会话号会不同，改写内容也可能措辞略有差异）：

我会按 humanizer-zh 去掉夸张宣传，保留版本号、发布日期和各项状态。

发布说明

资料夹 0.8.2 将于 2026 年 9 月 10 日发布。本版已支持给收藏添加标签，并修复了空标题保存失败的问题。

批量导出仍在开发中，不包含在 0.8.2 中。

待确认事项

旧版本标签能否自动迁移，目前尚未确认。

晚间在全新目录复跑，返回内容与此一致（个别语句合并成了更短的段落）。复跑终端里的样子：

查看原图 ↗

对照开头的五项检查逐一核对：全部通过。两句宣传话（"划时代的创新重塑信息整理体验""高效工作的全新里程碑"）被整体删除，没有任何事实被添加或篡改。第一句"我会按 humanizer-zh…"也说明技能真的被加载了。

对照实验：没有安装技能时会怎样

把同样的请求发到一个没有安装这个技能的文件夹（比如另建一个空的 C:\ai-practice\codex-no-skill 再启动 Codex），实际返回的开头是：

当前可用技能中未列出 humanizer-zh；以下按自然、简洁、保留事实的原则改写。

这次实验说明两件事：成功案例里的技能行为确实来自第 2 步的安装，而不是模型自带能力；模型本身也有基本改写能力，但只有装了 Humanizer zh，它才会按那一整套"AI 写作特征"规则系统清理，而不是碰运气。

技能没出现时的排查：十分钟定位

如果 $humanizer-zh 发出去，Codex 回复里说找不到这个技能，不要急着重装客户端，按下面顺序查。

先做一次隔离实验：在项目里另建 .agents\skills\kg-release-check\SKILL.md，完整保存以下内容（这是本课原创的最小诊断技能，和下载包无关；练习材料包里也有一份）：

---
name: kg-release-check
description: 从用户提供的版本原稿中区分已交付、未交付和待确认事项。用于发布说明的状态检查，不用于开发功能或发布网站。
---

# 发布状态检查

仅依据本次输入，先列版本号与日期，再分三栏输出：
- 已交付：明确属于本版本的功能或修复。
- 未交付：开发中、计划中、明确不属于本版的事项。
- 待确认：未知、未决定或材料相互冲突的事项。
原文没有版本号或日期时写"未提供"。
不能把"将支持"改成"已支持"。不写文件、不运行命令、不联网。

重新进入会话，发送 请使用 $kg-release-check 检查… 并附上同一段原稿。本课实测返回：

我会使用 kg-release-check，仅依据原稿区分发布状态。

版本号：0.8.2
发布日期：2026 年 9 月 10 日

| 已交付 | 未交付 | 待确认 |
|---|---|---|
| 支持给收藏添加标签；修复空标题保存失败的问题。 | 批量导出仍在开发中，不包含在 0.8.2 中。 | 旧版本标签能否自动迁移，尚未确认。 |

诊断技能正常、下载技能不正常，问题在下载包那一侧：回看第 2 步的三个坑（层级、扩展名、命名）。诊断技能也不正常，问题在环境一侧：逐项检查当前目录是否是 C:\ai-practice\codex-release、.agents\skills 拼写、SKILL.md 开头是否是两行 --- 包住的 YAML；改完文件后退出 Codex 在同一文件夹重开。两种都正常但结果不对时，再按 Skill 没生效：亲手复现四种故障，再逐层修好 深入。

另外三种本课实际遇到的报错，照着处理：

• 启动就报 Not inside a trusted directory and --skip-git-repo-check was not specified：练习文件夹不是 git 仓库，Codex 的非交互模式默认拒绝。学习场景不用建 git 仓库，命令后面加上 --skip-git-repo-check 再启动即可。
• 运行报 The … model requires a newer version of Codex. Please upgrade to the latest app or CLI and try again.：你的 Codex 版本落后于账号当前的默认模型。先完全退出 Codex（包括后台进程），再运行一次 npm.cmd install -g @openai/codex 升级；升级后 codex.cmd --version 仍报错就再执行一遍同一条安装命令修复。本课排错时先在旧版上遇到这条，升级到 0.153.4 后成功。升级前退出 Codex 是必须的：文件被占用时升级可能失败。
• 模型回复说"原文几乎全变成了问号，无法辨认"：你用管道方式（某文件内容 | codex exec …）发中文练习稿，而 PowerShell 的管道编码不是 UTF-8，中文在进模型前就被替换成了问号。先执行下面三行再重发同样的命令；交互窗口里直接粘贴不受影响，因为输入由终端自己处理。复跑时真实遇到一次，改完编码原样重发就成功了：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = New-Object System.Text.UTF8Encoding($false)
chcp 65001

换成你自己的材料

练习稳定后，把原稿换成你自己的文字：一篇公众号段落、一条产品更新说明、一封通知。只换"原稿："后面的内容，其余指令不动，检查点也按你的稿子重列——把不能丢的事实（数字、日期、承诺范围）在发出前写进请求里。

晚间复跑时换了一份同结构的原创虚构材料（"日程鸽 1.2.0"发布稿），检查点同样五项：版本 1.2.0、日期 2026 年 9 月 18 日、静音时段设置与跨时区修复两项已完成、周视图导出 PDF 写为开发中、旧标签迁移写为未确认。实际返回：

我会按 humanizer-zh 改写，删去夸张宣传，保留版本号、发布日期和各项状态。

发布说明

日程鸽 1.2.0 将于 2026 年 9 月 18 日发布。

本版已支持设置提醒的静音时段，并修复了跨时区行程显示错误的问题。周视图导出 PDF 功能仍在开发中，不包含在 1.2.0 中。

待确认事项

旧版本的自定义标签能否自动迁移，目前尚未确认。

五项检查全过，两句宣传话（"革命性的时间管理理念重新定义您的每一天""高效人生的全新起点"）被整体删除。终端里的样子：

查看原图 ↗

务必遵守两条：不把密码、客户隐私、未公开业务数据放进练习；改写结果自己读一遍再采用，Skill 是编辑助手，不是免检印章。

本课完成的标志：目标技能能被 $ 调用、五项检查全过、能用最小诊断技能自己定位一次"技能不出现"。下一步可以做 Codex 交付检查练习，把"说完成了"和真实文件结果分开核对。