AI 技能AI 写作【免费下载链接】humanizerAgent skill that removes signs of AI-generated writing from text项目地址https://gitcode.com/GitHub_Trending/humani/humanizer点击查看免费下载导读本文围绕 AGENTS.md 展开系统拆解 Humanizer 这一以 Markdown 实现的 Agent Skill 仓库的内部结构、维护规则与发布校验流程。读者将掌握为什么一个仅由SKILL.md驱动的无构建步骤仓库需要一整套版本同步与一致性校验如何在不破坏提示词prompt与跨 Agent 兼容性的前提下安全新增或重排模式pattern以及如何借助 scripts/validate-package.py 在发布前自动验证包完整性。本文适用于任何维护 Agent Skill、Claude 插件或 Cursor 插件的开发者。一、仓库定位一个以 SKILL.md 为唯一产品的 Skill 包Humanizer 是一个用 Markdown 编写的 Agent SkillSKILL.md就是 Agent 每次调用时读取的提示词本体。AGENTS.md开篇即点明仓库的核心事实仓库没有构建步骤no build step不存在编译、打包或生成产物SKILL.md是唯一的 skill 文件也是事实来源source of truth维护的第一原则是保持 skill 的可移植性不要写入只绑定一两个 Agent 工具的指令让同一份提示词能在 Claude Code、Codex、Cursor、OpenCode、Gemini CLI 等不同 Agent 间通用。从源码结构看整个仓库的其余文件都围绕SKILL.md服务要么向外部平台描述它插件清单、市场清单、OpenAI 配置要么记录它的演化CHANGELOG要么校验它与周边文件的一致性验证脚本。因此改好 Humanizer 的本质是改好 SKILL.md 及其配套元数据而AGENTS.md就是这份工作的操作手册。SKILL.md的头部 YAML 元数据给出了 skill 的身份信息SKILL.md--- name: humanizer description: | Rewrite AI-sounding text so it reads like the writer without changing what it says. Use when editing or reviewing prose for AI tells: not-X-but-Y contrasts, one-line closers, staged openers, forced triads, dashes everywhere, inflated claims, sales language, stock AI words, bold labels, or filler. Based on Wikipedias Signs of AI writing. license: MIT metadata: version: 3.1.0 ---注意版本号位于metadata.version下而不是顶层version字段——这是 Agent Skills 规范的兼容性要求也是AGENTS.md与验证脚本共同约束的格式细节。二、关键文件地图每个文件在包中的作用AGENTS.md用一段清单界定了仓库内每个文件的职责这是理解整个包结构的最佳入口文件职责SKILL.md事实来源仓库唯一的 skill 文件包含可移植 YAML 元数据、AI 文本为何听起来像 AI 的成因说明以及按强度与频率分组、按 1 起连续编号的模式清单README.md面向用户的安装、使用与模式说明CHANGELOG.md发布说明新版本在前旧条目保留其发布时使用的模式编号.claude-plugin/plugin.json描述 Claude 插件并将其 skill 加载器指向根目录SKILL.mdskills: [./].claude-plugin/marketplace.json让用户可以把本仓库添加为 Claude 市场marketplace来源.cursor-plugin/plugin.json描述 Cursor 插件刻意省略skills字段让 Cursor 直接加载根目录的SKILL.mdagents/openai.yaml面向 OpenAI 兼容 Agent 的显示名、短描述与默认提示词scripts/validate-package.py校验包文件与共享值的一致性几个容易忽略但至关重要的设计决策都能在配置文件中得到印证Claude 插件只有一个 skill 入口.claude-plugin/plugin.json中skills: [./]把加载器指向仓库根目录确保所有平台读到的是同一份SKILL.md而不是多份可能漂移的副本。Cursor 插件不声明 skills 路径.cursor-plugin/plugin.json中没有任何skills字段。AGENTS.md明确要求Omit askillspath so Cursor loads the rootSKILL.md验证脚本也专门检查这一点见下文。OpenAI 兼容入口是纯提示词agents/openai.yaml 仅含三行内容——display_name: Humanizer、short_description: Make AI-written text sound like the writer、default_prompt: Use $humanizer to rewrite this text in my voice without changing its facts.把 skill 暴露为可通过$humanizer引用的工具。三、变更规则改动 SKILL.md 前必须遵守的六条约束AGENTS.md的核心部分是Rules for changes变更规则它们共同维护一个前提SKILL.md与README.md必须保持同步keep in sync。具体约束如下。3.1 模式Patterns编号规则模式从 1 开始连续编号、不允许跳号强度最高、出现最频繁的模式排最前。新增一个AI 特征tell时只有当现有模式都无法涵盖它时才值得立为新模式否则优先把新发现折叠进已有模式。一旦增删或重排模式必须同步更新 README 中的模式表格、README 的小节标题以及SKILL.md内所有§交叉引用。模式总数由验证脚本从标题自动推导正则匹配### N. 名称并与 README 表格中的模式名逐一比对。这条规则在SKILL.md中有着清晰的落地当前共有 26 个模式按 AF 六个分组Staging instead of stating、Rhythm by rule、Inflation and borrowed authority、Formatting by rule、Leftovers from the chat and the draft、Writing for the wrong reader组织其中 §1§5 是单次出现即可修改的最强特征而 §8、§9、§10、§11、§21 等标记为weak alone需要同一段落内多个特征共同出现才动手。CHANGELOG 记录了模式的演化史——例如 3.0.0 版本曾把 35 个模式合并为 25 个并重排编号3.1.0 又新增了第 26 个模式。3.2 版本号同步同一版本号必须同时出现在四处SKILL.md的metadata.versionCHANGELOG.md的第一个版本标题形如## 3.1.0.claude-plugin/plugin.json的version.cursor-plugin/plugin.json的version。同时禁止在 skill 的 YAML 顶层添加version字段——版本必须放在metadata之下。这一约束既保证各平台读到的包版本一致也避免非标准的顶层字段干扰 Agent Skills 加载器。3.3 兼容性Agent 名称只是示例不是上限安装与使用说明必须保持跨 Agent 中立。Claude Code、Cursor、OpenCode、Codex 等名称在文档中只是示例不应把指令写成某个 Agent 专属。这与仓库单一 SKILL.md 全平台复用的架构一脉相承。3.4 描述Description一致性插件清单plugin manifests必须使用SKILL.md中 description 的第一句话。实际仓库中SKILL.md的 description 首句 Rewrite AI-sounding text so it reads like the writer without changing what it says. 与.claude-plugin/plugin.json、.cursor-plugin/plugin.json、.claude-plugin/marketplace.json中的描述完全一致验证脚本会强制校验这一点。3.5 长度预算5500 词上限SKILL.md的每一个词都会在每次调用时被 Agent 读取因此它有一项严格的成本预算验证脚本将字数上限设为 5,500 词。AGENTS.md对此的措辞是a change that adds words should earn them——新增的每个词都应当换来等价的表达价值。这一约束从根源上防止提示词无限膨胀拖慢每次调用。3.6 历史与发布前检查任何行为变更或不明显的修复都必须在CHANGELOG.md中添加一条简短说明发布前必须依次运行三条检查命令python3 scripts/validate-package.pynpx skills add . --listclaude plugin validate .CHANGELOG.md本身也是维护规则的一部分旧条目必须保留其发布时使用的模式编号。例如 3.0.0 的条目记录了完整的旧编号→新编号映射表1→13, 2→17, 3→15...让历史版本的读者仍能对照当时的编号体系。这正是AGENTS.md要求old notes keep the pattern numbers their release used的原因。四、发布前校验validate-package.py 逐项解析scripts/validate-package.py 是整个维护流程的自动化核心它不依赖任何外部包docstring 明确说明 without external dependencies只用标准库json、re、pathlib实现。逐项阅读源码可以还原它实际检查的全部内容4.1 文件可读性与 JSON 合法性脚本启动即读取SKILL.md、README.md、CHANGELOG.md并解析三个 JSON 文件.claude-plugin/plugin.json、.cursor-plugin/plugin.json、.claude-plugin/marketplace.json。任何文件缺失、读取失败或 JSON 语法错误都会立即以SystemExit终止并给出带相对路径的提示如Cannot read .claude-plugin/plugin.json: ...或Fix the JSON in .cursor-plugin/plugin.json: ...。4.2 YAML 元数据约束要求SKILL.md必须以---\n...\n---的 YAML 块开头禁止顶层出现version:、compatibility:、allowed-tools:三个非标准字段源码第 48-50 行逐一遍历并报错要求metadata.version存在且为数字.数字.数字的三段式版本号。4.3 版本一致性校验脚本收集四处的版本号——SKILL.md的metadata.version、CHANGELOG.md第一个## x.y.z标题、Claude 插件的version、Cursor 插件的version——放入一个集合。若集合大小不为 1说明四处版本不一致直接报错Use one package version in all files: {...}。这正是AGENTS.md中同一版本出现在四个位置规则的机器化落地。4.4 skill 文件唯一性与加载路径递归搜索整个仓库确认只存在一个位于根目录的普通SKILL.md不是符号链接、没有第二份副本要求.claude-plugin/plugin.json的skills字段严格等于[./]即 Claude 加载器指向仓库根要求.cursor-plugin/plugin.json的name为humanizer且不得包含skills字段——否则 Cursor 会去寻找自定义路径而不是根目录的SKILL.md。4.5 描述一致性校验脚本把SKILL.md中description: |缩进块的内容折叠为单行并收集 Claude 插件、Cursor 插件、市场清单中的全部 description要求所有清单描述完全相同集合大小为 1且SKILL.md描述以该共同描述开头即清单使用第一句话。4.6 模式编号与 README 同步这是校验器最精巧的部分从SKILL.md用^### ([0-9])\. (.)$提取全部模式标题要求编号是从 1 开始的连续整数序列从README.md用^| ([0-9]) \| \*\*(.?)\*\*提取表格中的模式编号与名称要求编号集合与SKILL.md完全一致逐号比对模式名称任何不一致都会报错Match the README pattern names to SKILL.md: ...要求 README 的模式小节标题精确等于## The {总数} patterns例如当前为## The 26 patterns最后扫描SKILL.md中所有§数字交叉引用确保每个引用都指向 1 到模式总数范围内的有效编号——防止重排编号后留下指向错误或不存在模式的死引用。4.7 字数预算脚本用SKILL.split()统计SKILL.md的总词数超过 5,500 即报错。这也是AGENTS.md中长度约束的直接实现。全部检查通过后脚本输出一行结果Humanizer package v3.1.0 is valid。整条流水线证明Humanizer 的包不是一个构建产物而是一组必须彼此一致的文件约束校验器正是这些约束的机器执行者。五、写作风格规范Plain Language 原则AGENTS.md要求仓库内的一切文本——代码注释、提示词、文档、描述、校验消息、进度报告——都遵循 Plain Language简明英语原则。这不是随意的偏好而是有明确技术动机的提示词即产品SKILL.md下方从## Why AI text sounds the way it does开始的正文就是 Agent 每次实际读取的提示词措辞直接影响改写质量面向多 Agent 复用同样的文本会被不同 Agent 及其开发者阅读简明语言能降低误解成本。AGENTS.md给出的具体规范包括先给出主要观点lead with the main point使用常用词与主动语态common words, active voice句子与段落保持简短同一事物始终使用同一个术语one term for the same item用must表达硬性要求善用标题、列表与表格辅助阅读删去重复或多余词汇限制缩略语并解释技术术语避免双重否定保留精确的标识符、命令、路径、schema 字段、引文、受监控短语watched phrases与承载行为含义的示例——这些内容即使违反简明原则也不能简化因为它们是机器与人类共同依赖的精确信息保持完整的技术含义keep the full technical meaning。这些原则在仓库中有大量实例。例如SKILL.md的 §8 规则是绝对化表述The final rewrite must not contain em dashes (—) or en dashes (–) unless the writers sample uses them校验脚本的错误消息则直接使用must与动词开头的祈使句如 Keep SKILL.md at 5,500 words or fewer、Number SKILL.md patterns from 1 upward without gaps。六、编辑 SKILL.md 的三个操作准则AGENTS.md在最后给出编辑 skill 本身的三条准则可以视为对全文规则的浓缩保持 YAML 元数据合法——任何结构改动都不能破坏解析器依赖的元数据格式把元数据下方的提示词当作产品本身——它不是说明文档的附属品而是用户实际消费的核心资产优先用一条简短清晰的指令而不是再加一条例外或重复解释——这与 5,500 词预算互相呼应提示词越精简Agent 每次读取的注意力越集中行为越稳定。结合 SKILL.md 的实际结构可以看到这套准则的成果26 个模式共用同一套Watch for / Problem / Before / After模板每个模式只讲一件事工作流被压缩为标记特征 → 起草改写 → 对照检查 → 写出终稿四个步骤何时不动手When not to act与保留哪些细节Keep the details that carry the writers voice作为独立章节放在末尾避免在主流程中堆砌例外。七、实操一次完整的维护演练将上述规则串联起来一个规范的 Humanizer 变更流程应该是评估通读SKILL.md判断新发现的 AI 特征能否被现有 26 个模式涵盖若能则折入现有模式并只补充 watch list 或示例若不能才考虑新增模式编号接在 26 之后。同步修改在SKILL.md中更新模式正文与§引用在README.md中同步模式表格、小节标题## The N patterns与使用说明在CHANGELOG.md顶部添加新版本条目新版本号最新在前。版本对齐将同一版本号写入SKILL.md的metadata.version、CHANGELOG.md首条标题、.claude-plugin/plugin.json与.cursor-plugin/plugin.json确认没有在 YAML 顶层引入version字段。自检运行python3 scripts/validate-package.py直到输出Humanizer package vX.Y.Z is valid再运行npx skills add . --list与claude plugin validate .验证跨平台可安装性。文字把关按 Plain Language 规范审阅新增措辞确认每个新增词都挣得了它的位置且所有精确标识符命令、路径、watched phrases一字未改。这套流程的价值在于它把维护一个提示词包从纯手工的文字编辑变成了有机器校验兜底的工程化流程。任何一个环节的遗漏——版本没对齐、README 表格没同步、模式编号出现断号——都会被validate-package.py在发布前拦截从而保证用户在任何平台安装到的都是同一个、自洽的 Humanizer。结语AGENTS.md虽然只有几十行却精确刻画了 Humanizer 仓库的全部维护契约单一SKILL.md的产品架构、八个关键文件的职责划分、六条变更规则、一套由 scripts/validate-package.py 机器执行的发布校验以及贯穿始终的 Plain Language 写作规范。对任何想要维护或复刻一个跨 Agent Skill 包的开发者而言这份文档连同仓库中的实现就是一份可以直接借鉴的工程模板。赞分享AI 技能AI 写作【免费下载链接】humanizerAgent skill that removes signs of AI-generated writing from text项目地址https://gitcode.com/GitHub_Trending/humani/humanizer点击查看免费下载相关推荐Flutter 仓库 Agent Skills 协作规范Skill 采纳要求、维护职责与 dart_skills_lint 校验实战Flutter 仓库 Agent Skills 协作规范Skill 采纳要求、维护职责与 dart_skills_lint 校验实战 本篇围绕 Flutter跨平台移动开发前端UI组件桌面应用Ghost 仓库提交规范实战commit Skill 工作流与 Git Hooks 校验机制Ghost 仓库提交规范实战commit Skill 工作流与 Git Hooks 校验机制 本文以 Ghost monorepo 中的提交技能文档 SKILCMS后端前端lark-cli SKILL.md 规范解析AI Agent Skill 文件格式与质量门禁校验机制lark cli SKILL.md 规范解析AI Agent Skill 文件格式与质量门禁校验机制 本文围绕 lark cli 仓库中 internal/qCLIAI 技能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
安全维护 Agent Skill 包：Humanizer 仓库的变更规范与校验机制深度解析
AI 技能AI 写作【免费下载链接】humanizerAgent skill that removes signs of AI-generated writing from text项目地址https://gitcode.com/GitHub_Trending/humani/humanizer点击查看免费下载导读本文围绕 AGENTS.md 展开系统拆解 Humanizer 这一以 Markdown 实现的 Agent Skill 仓库的内部结构、维护规则与发布校验流程。读者将掌握为什么一个仅由SKILL.md驱动的无构建步骤仓库需要一整套版本同步与一致性校验如何在不破坏提示词prompt与跨 Agent 兼容性的前提下安全新增或重排模式pattern以及如何借助 scripts/validate-package.py 在发布前自动验证包完整性。本文适用于任何维护 Agent Skill、Claude 插件或 Cursor 插件的开发者。一、仓库定位一个以 SKILL.md 为唯一产品的 Skill 包Humanizer 是一个用 Markdown 编写的 Agent SkillSKILL.md就是 Agent 每次调用时读取的提示词本体。AGENTS.md开篇即点明仓库的核心事实仓库没有构建步骤no build step不存在编译、打包或生成产物SKILL.md是唯一的 skill 文件也是事实来源source of truth维护的第一原则是保持 skill 的可移植性不要写入只绑定一两个 Agent 工具的指令让同一份提示词能在 Claude Code、Codex、Cursor、OpenCode、Gemini CLI 等不同 Agent 间通用。从源码结构看整个仓库的其余文件都围绕SKILL.md服务要么向外部平台描述它插件清单、市场清单、OpenAI 配置要么记录它的演化CHANGELOG要么校验它与周边文件的一致性验证脚本。因此改好 Humanizer 的本质是改好 SKILL.md 及其配套元数据而AGENTS.md就是这份工作的操作手册。SKILL.md的头部 YAML 元数据给出了 skill 的身份信息SKILL.md--- name: humanizer description: | Rewrite AI-sounding text so it reads like the writer without changing what it says. Use when editing or reviewing prose for AI tells: not-X-but-Y contrasts, one-line closers, staged openers, forced triads, dashes everywhere, inflated claims, sales language, stock AI words, bold labels, or filler. Based on Wikipedias Signs of AI writing. license: MIT metadata: version: 3.1.0 ---注意版本号位于metadata.version下而不是顶层version字段——这是 Agent Skills 规范的兼容性要求也是AGENTS.md与验证脚本共同约束的格式细节。二、关键文件地图每个文件在包中的作用AGENTS.md用一段清单界定了仓库内每个文件的职责这是理解整个包结构的最佳入口文件职责SKILL.md事实来源仓库唯一的 skill 文件包含可移植 YAML 元数据、AI 文本为何听起来像 AI 的成因说明以及按强度与频率分组、按 1 起连续编号的模式清单README.md面向用户的安装、使用与模式说明CHANGELOG.md发布说明新版本在前旧条目保留其发布时使用的模式编号.claude-plugin/plugin.json描述 Claude 插件并将其 skill 加载器指向根目录SKILL.mdskills: [./].claude-plugin/marketplace.json让用户可以把本仓库添加为 Claude 市场marketplace来源.cursor-plugin/plugin.json描述 Cursor 插件刻意省略skills字段让 Cursor 直接加载根目录的SKILL.mdagents/openai.yaml面向 OpenAI 兼容 Agent 的显示名、短描述与默认提示词scripts/validate-package.py校验包文件与共享值的一致性几个容易忽略但至关重要的设计决策都能在配置文件中得到印证Claude 插件只有一个 skill 入口.claude-plugin/plugin.json中skills: [./]把加载器指向仓库根目录确保所有平台读到的是同一份SKILL.md而不是多份可能漂移的副本。Cursor 插件不声明 skills 路径.cursor-plugin/plugin.json中没有任何skills字段。AGENTS.md明确要求Omit askillspath so Cursor loads the rootSKILL.md验证脚本也专门检查这一点见下文。OpenAI 兼容入口是纯提示词agents/openai.yaml 仅含三行内容——display_name: Humanizer、short_description: Make AI-written text sound like the writer、default_prompt: Use $humanizer to rewrite this text in my voice without changing its facts.把 skill 暴露为可通过$humanizer引用的工具。三、变更规则改动 SKILL.md 前必须遵守的六条约束AGENTS.md的核心部分是Rules for changes变更规则它们共同维护一个前提SKILL.md与README.md必须保持同步keep in sync。具体约束如下。3.1 模式Patterns编号规则模式从 1 开始连续编号、不允许跳号强度最高、出现最频繁的模式排最前。新增一个AI 特征tell时只有当现有模式都无法涵盖它时才值得立为新模式否则优先把新发现折叠进已有模式。一旦增删或重排模式必须同步更新 README 中的模式表格、README 的小节标题以及SKILL.md内所有§交叉引用。模式总数由验证脚本从标题自动推导正则匹配### N. 名称并与 README 表格中的模式名逐一比对。这条规则在SKILL.md中有着清晰的落地当前共有 26 个模式按 AF 六个分组Staging instead of stating、Rhythm by rule、Inflation and borrowed authority、Formatting by rule、Leftovers from the chat and the draft、Writing for the wrong reader组织其中 §1§5 是单次出现即可修改的最强特征而 §8、§9、§10、§11、§21 等标记为weak alone需要同一段落内多个特征共同出现才动手。CHANGELOG 记录了模式的演化史——例如 3.0.0 版本曾把 35 个模式合并为 25 个并重排编号3.1.0 又新增了第 26 个模式。3.2 版本号同步同一版本号必须同时出现在四处SKILL.md的metadata.versionCHANGELOG.md的第一个版本标题形如## 3.1.0.claude-plugin/plugin.json的version.cursor-plugin/plugin.json的version。同时禁止在 skill 的 YAML 顶层添加version字段——版本必须放在metadata之下。这一约束既保证各平台读到的包版本一致也避免非标准的顶层字段干扰 Agent Skills 加载器。3.3 兼容性Agent 名称只是示例不是上限安装与使用说明必须保持跨 Agent 中立。Claude Code、Cursor、OpenCode、Codex 等名称在文档中只是示例不应把指令写成某个 Agent 专属。这与仓库单一 SKILL.md 全平台复用的架构一脉相承。3.4 描述Description一致性插件清单plugin manifests必须使用SKILL.md中 description 的第一句话。实际仓库中SKILL.md的 description 首句 Rewrite AI-sounding text so it reads like the writer without changing what it says. 与.claude-plugin/plugin.json、.cursor-plugin/plugin.json、.claude-plugin/marketplace.json中的描述完全一致验证脚本会强制校验这一点。3.5 长度预算5500 词上限SKILL.md的每一个词都会在每次调用时被 Agent 读取因此它有一项严格的成本预算验证脚本将字数上限设为 5,500 词。AGENTS.md对此的措辞是a change that adds words should earn them——新增的每个词都应当换来等价的表达价值。这一约束从根源上防止提示词无限膨胀拖慢每次调用。3.6 历史与发布前检查任何行为变更或不明显的修复都必须在CHANGELOG.md中添加一条简短说明发布前必须依次运行三条检查命令python3 scripts/validate-package.pynpx skills add . --listclaude plugin validate .CHANGELOG.md本身也是维护规则的一部分旧条目必须保留其发布时使用的模式编号。例如 3.0.0 的条目记录了完整的旧编号→新编号映射表1→13, 2→17, 3→15...让历史版本的读者仍能对照当时的编号体系。这正是AGENTS.md要求old notes keep the pattern numbers their release used的原因。四、发布前校验validate-package.py 逐项解析scripts/validate-package.py 是整个维护流程的自动化核心它不依赖任何外部包docstring 明确说明 without external dependencies只用标准库json、re、pathlib实现。逐项阅读源码可以还原它实际检查的全部内容4.1 文件可读性与 JSON 合法性脚本启动即读取SKILL.md、README.md、CHANGELOG.md并解析三个 JSON 文件.claude-plugin/plugin.json、.cursor-plugin/plugin.json、.claude-plugin/marketplace.json。任何文件缺失、读取失败或 JSON 语法错误都会立即以SystemExit终止并给出带相对路径的提示如Cannot read .claude-plugin/plugin.json: ...或Fix the JSON in .cursor-plugin/plugin.json: ...。4.2 YAML 元数据约束要求SKILL.md必须以---\n...\n---的 YAML 块开头禁止顶层出现version:、compatibility:、allowed-tools:三个非标准字段源码第 48-50 行逐一遍历并报错要求metadata.version存在且为数字.数字.数字的三段式版本号。4.3 版本一致性校验脚本收集四处的版本号——SKILL.md的metadata.version、CHANGELOG.md第一个## x.y.z标题、Claude 插件的version、Cursor 插件的version——放入一个集合。若集合大小不为 1说明四处版本不一致直接报错Use one package version in all files: {...}。这正是AGENTS.md中同一版本出现在四个位置规则的机器化落地。4.4 skill 文件唯一性与加载路径递归搜索整个仓库确认只存在一个位于根目录的普通SKILL.md不是符号链接、没有第二份副本要求.claude-plugin/plugin.json的skills字段严格等于[./]即 Claude 加载器指向仓库根要求.cursor-plugin/plugin.json的name为humanizer且不得包含skills字段——否则 Cursor 会去寻找自定义路径而不是根目录的SKILL.md。4.5 描述一致性校验脚本把SKILL.md中description: |缩进块的内容折叠为单行并收集 Claude 插件、Cursor 插件、市场清单中的全部 description要求所有清单描述完全相同集合大小为 1且SKILL.md描述以该共同描述开头即清单使用第一句话。4.6 模式编号与 README 同步这是校验器最精巧的部分从SKILL.md用^### ([0-9])\. (.)$提取全部模式标题要求编号是从 1 开始的连续整数序列从README.md用^| ([0-9]) \| \*\*(.?)\*\*提取表格中的模式编号与名称要求编号集合与SKILL.md完全一致逐号比对模式名称任何不一致都会报错Match the README pattern names to SKILL.md: ...要求 README 的模式小节标题精确等于## The {总数} patterns例如当前为## The 26 patterns最后扫描SKILL.md中所有§数字交叉引用确保每个引用都指向 1 到模式总数范围内的有效编号——防止重排编号后留下指向错误或不存在模式的死引用。4.7 字数预算脚本用SKILL.split()统计SKILL.md的总词数超过 5,500 即报错。这也是AGENTS.md中长度约束的直接实现。全部检查通过后脚本输出一行结果Humanizer package v3.1.0 is valid。整条流水线证明Humanizer 的包不是一个构建产物而是一组必须彼此一致的文件约束校验器正是这些约束的机器执行者。五、写作风格规范Plain Language 原则AGENTS.md要求仓库内的一切文本——代码注释、提示词、文档、描述、校验消息、进度报告——都遵循 Plain Language简明英语原则。这不是随意的偏好而是有明确技术动机的提示词即产品SKILL.md下方从## Why AI text sounds the way it does开始的正文就是 Agent 每次实际读取的提示词措辞直接影响改写质量面向多 Agent 复用同样的文本会被不同 Agent 及其开发者阅读简明语言能降低误解成本。AGENTS.md给出的具体规范包括先给出主要观点lead with the main point使用常用词与主动语态common words, active voice句子与段落保持简短同一事物始终使用同一个术语one term for the same item用must表达硬性要求善用标题、列表与表格辅助阅读删去重复或多余词汇限制缩略语并解释技术术语避免双重否定保留精确的标识符、命令、路径、schema 字段、引文、受监控短语watched phrases与承载行为含义的示例——这些内容即使违反简明原则也不能简化因为它们是机器与人类共同依赖的精确信息保持完整的技术含义keep the full technical meaning。这些原则在仓库中有大量实例。例如SKILL.md的 §8 规则是绝对化表述The final rewrite must not contain em dashes (—) or en dashes (–) unless the writers sample uses them校验脚本的错误消息则直接使用must与动词开头的祈使句如 Keep SKILL.md at 5,500 words or fewer、Number SKILL.md patterns from 1 upward without gaps。六、编辑 SKILL.md 的三个操作准则AGENTS.md在最后给出编辑 skill 本身的三条准则可以视为对全文规则的浓缩保持 YAML 元数据合法——任何结构改动都不能破坏解析器依赖的元数据格式把元数据下方的提示词当作产品本身——它不是说明文档的附属品而是用户实际消费的核心资产优先用一条简短清晰的指令而不是再加一条例外或重复解释——这与 5,500 词预算互相呼应提示词越精简Agent 每次读取的注意力越集中行为越稳定。结合 SKILL.md 的实际结构可以看到这套准则的成果26 个模式共用同一套Watch for / Problem / Before / After模板每个模式只讲一件事工作流被压缩为标记特征 → 起草改写 → 对照检查 → 写出终稿四个步骤何时不动手When not to act与保留哪些细节Keep the details that carry the writers voice作为独立章节放在末尾避免在主流程中堆砌例外。七、实操一次完整的维护演练将上述规则串联起来一个规范的 Humanizer 变更流程应该是评估通读SKILL.md判断新发现的 AI 特征能否被现有 26 个模式涵盖若能则折入现有模式并只补充 watch list 或示例若不能才考虑新增模式编号接在 26 之后。同步修改在SKILL.md中更新模式正文与§引用在README.md中同步模式表格、小节标题## The N patterns与使用说明在CHANGELOG.md顶部添加新版本条目新版本号最新在前。版本对齐将同一版本号写入SKILL.md的metadata.version、CHANGELOG.md首条标题、.claude-plugin/plugin.json与.cursor-plugin/plugin.json确认没有在 YAML 顶层引入version字段。自检运行python3 scripts/validate-package.py直到输出Humanizer package vX.Y.Z is valid再运行npx skills add . --list与claude plugin validate .验证跨平台可安装性。文字把关按 Plain Language 规范审阅新增措辞确认每个新增词都挣得了它的位置且所有精确标识符命令、路径、watched phrases一字未改。这套流程的价值在于它把维护一个提示词包从纯手工的文字编辑变成了有机器校验兜底的工程化流程。任何一个环节的遗漏——版本没对齐、README 表格没同步、模式编号出现断号——都会被validate-package.py在发布前拦截从而保证用户在任何平台安装到的都是同一个、自洽的 Humanizer。结语AGENTS.md虽然只有几十行却精确刻画了 Humanizer 仓库的全部维护契约单一SKILL.md的产品架构、八个关键文件的职责划分、六条变更规则、一套由 scripts/validate-package.py 机器执行的发布校验以及贯穿始终的 Plain Language 写作规范。对任何想要维护或复刻一个跨 Agent Skill 包的开发者而言这份文档连同仓库中的实现就是一份可以直接借鉴的工程模板。赞分享AI 技能AI 写作【免费下载链接】humanizerAgent skill that removes signs of AI-generated writing from text项目地址https://gitcode.com/GitHub_Trending/humani/humanizer点击查看免费下载相关推荐Flutter 仓库 Agent Skills 协作规范Skill 采纳要求、维护职责与 dart_skills_lint 校验实战Flutter 仓库 Agent Skills 协作规范Skill 采纳要求、维护职责与 dart_skills_lint 校验实战 本篇围绕 Flutter跨平台移动开发前端UI组件桌面应用Ghost 仓库提交规范实战commit Skill 工作流与 Git Hooks 校验机制Ghost 仓库提交规范实战commit Skill 工作流与 Git Hooks 校验机制 本文以 Ghost monorepo 中的提交技能文档 SKILCMS后端前端lark-cli SKILL.md 规范解析AI Agent Skill 文件格式与质量门禁校验机制lark cli SKILL.md 规范解析AI Agent Skill 文件格式与质量门禁校验机制 本文围绕 lark cli 仓库中 internal/qCLIAI 技能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
