@yottameta/yotta-humanize 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# 更新日志
+
+## v0.1.0 (2026-08-26)
+
+YottaMeta 自有实现首版（去 AI 味方向参考开源社区 humanizer / ai-humanizer 类技能思路，已完全重写为中文语料实现，零依赖、无上游代码）：
+
+- **检测器引擎**（scripts/yotta_humanize.py + humanize_rules.py，Python 3.8+ 标准库）：24 类中文 AI 腔规则（内容 / 语言 / 句式 / 沟通 / 废话五组）+ 词表 + 句式正则 + 统计突发性（句长均匀度 CV / 突发性 / 双字词汇多样性 TTR / 逗号密度）。
+- **确定性改写**：词表替换（赋能→支持、抓手→切入点、闭环→流程…）、套话 / 聊天残渣 / 奉承 / 免责删除、破折号 / 感叹号限流；输出修复清单与前后评分。
+- **CLI**：score（--gate 可做 CI 拦截）/ analyze / report（Markdown）/ suggest / rewrite / version；--json 机器可读；stdin 编码自适应（UTF-8 优先，回退本机编码）。
+- **退出码**：与元安 / 元审 / 元盾家族一致（0 = 成功；1 = --gate 达到阈值；4 = 用法错误）。
+- **测试**：scripts/test_yotta_humanize.py 155 项全绿（24 类规则命中 / 干净文本低分 / 统计量 / 确定性改写 / CLI 子命令 / 退出码 / JSON / GBK 控制台）。
+- **文档**：SKILL.md / README.md / references（patterns / scoring / rewriting）/ assets/banner.png。
+- 版权：YottaMeta 纯自有 MIT + NOTICE 品牌声明；README 一行上游致谢。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YottaMeta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,11 @@
+# NOTICE — YottaMeta 品牌声明
+
+「YottaMeta」「元忆」「yotta-memory」「元真」「yotta-humanize」「元阁」以及本家族各技能名称（yotta-* 前缀）是 YottaMeta 的品牌与标识。
+
+本软件以 MIT 许可证开源，任何人均可自由使用、修改与分发。若你在其基础上制作派生作品：
+
+1. 不得继续使用 YottaMeta 或本家族名称（yotta-*、元忆、元真 等）作为派生作品的名称；
+2. 不得暗示派生作品由 YottaMeta 官方维护、认可或与之存在关联；
+3. 建议在派生作品中明确声明「与 YottaMeta 官方无关联」。
+
+上游来源致谢：本技能由 YottaMeta 全新实现，去 AI 味方向参考开源社区的 humanizer / ai-humanizer 类技能思路，词表与句式均为中文自研整理，无上游代码。

package/README.md

@@ -0,0 +1,157 @@
+
+<p align="center">
+  <img src="assets/banner.png" alt="yotta-humanize banner" width="100%" />
+</p>
+
+<h1 align="center">yotta-humanize · 元真</h1>
+
+<p align="center">YottaMeta 自有的去 AI 味中文写作编辑技能：<b>检测器引擎（24 类规则 + 词表 + 统计突发性）</b>识别 AI 腔文本，并给出确定性改写，让中文写作更自然、更像人写的。适用于编辑 / 润色文本、给 AI 生成的中文稿件做检测与改写。</p>
+<p align="center">检测到空泛升华、套话、AI 黑话（赋能 / 闭环 / 抓手）、同义堆叠、排比三连、聊天残渣（希望对你有所帮助）等 AI 腔特征时自动激活——<b>不靠提示词兜底，按规则确定性判定</b>。</p>
+<p align="center">纯 Python 3.8+ 标准库实现，零外部依赖；Windows + Linux + macOS 通用；检测 + 改写全流程，改写不依赖模型。</p>
+
+<p align="center">
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue" /></a>
+  <a href="https://agentskills.io/"><img alt="Standard: agentskills.io" src="https://img.shields.io/badge/standard-agentskills.io-orange" /></a>
+  <a href="https://www.npmjs.com/package/@yottameta/yotta-humanize"><img alt="npm package" src="https://img.shields.io/npm/v/@yottameta/yotta-humanize" /></a>
+  <a href="https://github.com/YottaMeta/yotta-humanize"><img alt="GitHub stars" src="https://img.shields.io/github/stars/YottaMeta/yotta-humanize" /></a>
+  <a href="https://github.com/YottaMeta/yotta-humanize/commits/main"><img alt="last commit" src="https://img.shields.io/github/last-commit/YottaMeta/yotta-humanize" /></a>
+  <a href="https://github.com/YottaMeta/yotta-humanize"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen" /></a>
+</p>
+
+## 这是什么
+
+AI 生成的中文文本有一眼可辨的「AI 腔」：空泛升华（标志着 / 彰显了）、套话（众所周知 / 综上所述 / 未来可期）、黑话（赋能 / 闭环 / 抓手 / 颗粒度）、机械列举（首先 / 其次 / 再次）、聊天残渣（希望对你有所帮助）……元真把这些特征做成**确定性检测器引擎**：24 类规则（词表 + 句式正则）+ 中文统计突发性（句长均匀度 / 词汇多样性），输出 0-100 的 AI 腔评分，并给出**确定性改写**（词表替换、套话删除、聊天残渣清理、标点限流）。
+
+它不是某个平台的专属功能，而是一份与智能体无关的工具包：装进任何支持 Agent Skills 的智能体即可按需调用。全程零依赖、不调模型；需要判断的改写以建议形式给出，不强行自动改。
+
+## 核心价值
+
+- **24 类检测规则**：内容（空泛升华 / 套话开头结尾 / 模糊归因 / 绝对化）/ 语言（AI 黑话 / 同义堆叠 / 名词化堆砌 / 「我们」滥用）/ 句式（排比三连 / 机械列举 / 反问堆叠 / 标点滥用）/ 沟通（聊天残渣 / 奉承讨好 / 免责回避）/ 废话（填充 / 转折 / 重复声明）。
+- **统计突发性**：句长均匀度（CV）、突发性、双字词汇多样性（TTR）、逗号密度——补规则检测不到的节奏问题。
+- **确定性改写**：无歧义机械变换直接改（赋能→支持、抓手→切入点、众所周知 / 综上所述 删除、希望对你有所帮助 清理、破折号 / 感叹号限流），输出修复清单与前后评分。
+- **机器可读**：--json 输出纯净 JSON；score --gate 接入 CI / 发布前检查。
+- **中文优先**：词表、句式、改写映射全部针对中文语料自研整理，与英文 humanizer 类技能无共享代码。
+
+## 核心优势
+
+| 优势 | 说明 |
+|---|---|
+| **零依赖** | Python 3.8+ 标准库，无模型、无数据库、无外部服务；Windows + Linux + macOS 通用 |
+| **确定性** | 规则判定可复现、可解释；改写是确定性变换，不依赖模型概率 |
+| **中文优先** | 针对中文 AI 腔（黑话 / 套话 / 排比 / 聊天残渣）自研词表与句式，非英文规则直译 |
+| **检测 + 改写一体** | score / analyze / report / suggest / rewrite 全流程，一条命令从检测到改写 |
+| **可复核** | 改写输出修复清单与前后评分，人工可逐条核对 |
+| **生态分发** | GitHub + npm + ClawHub 三源同步发布；npx / install.sh / 手动复制三种安装方式 |
+
+## 功能体系
+
+| 能力 | 说明 |
+|---|---|
+| score | 输出 AI 腔评分（0-100），--gate 可做 CI 拦截（退出码 1） |
+| analyze | 详细检测报告（文本 / --json），含命中规则、上下文片段、建议 |
+| report | Markdown 检测报告（统计表 + 命中规则） |
+| suggest | 按优先级分组的改写建议 |
+| rewrite | 确定性改写：替换 / 删除 AI 腔，输出修复清单 + 改写后文本 + 前后评分 |
+| version | 打印版本 |
+
+## 快速使用
+
+Windows 用 python，Linux/macOS 用 python3。
+
+```bash
+# 评分（0-100，越高越像 AI 写的）
+python3 scripts/yotta_humanize.py score -f article.md
+
+# 详细检测报告
+python3 scripts/yotta_humanize.py analyze -f article.md
+
+# Markdown 报告
+python3 scripts/yotta_humanize.py report -f article.md > report.md
+
+# 按优先级分组的改写建议
+python3 scripts/yotta_humanize.py suggest -f article.md
+
+# 确定性改写（输出改写后文本 + 修复清单）
+python3 scripts/yotta_humanize.py rewrite -f article.md
+
+# 管道输入
+cat article.md | python3 scripts/yotta_humanize.py score --stdin
+
+# CI 拦截：评分 >= 阈值时退出码 1
+python3 scripts/yotta_humanize.py score -f article.md --gate --threshold 45
+```
+
+退出码语义（与元安 / 元审 / 元盾家族一致）：0 = 成功；1 = score --gate 且评分达到阈值；4 = 用法错误 / 致命异常。
+
+## 安装
+
+三种方式任选其一，技能文件统一从 **npm** 获取（GitHub 无代理时较慢，npm 可配国内镜像加速）。
+
+### 方式一：npm（推荐，一行安装）
+```bash
+# 国内加速（可选）：npm config set registry https://registry.npmmirror.com
+npx -y @yottameta/yotta-humanize -g
+npx -y @yottameta/yotta-humanize --dir <你的技能目录>   # 任意智能体：指定目录安装
+```
+> 智能体不在预置列表里？用 --dir 指定它的 skills 目录，或手动复制（方式三）。--list 可查看各智能体对应的默认目录。想手动拿文件也可 npm pack @yottameta/yotta-humanize 解包后按方式二/三安装。
+
+### 方式二：install.sh 一键安装
+获取技能文件夹后（npm pack 解包或 git clone），进入技能文件夹：
+```bash
+bash install.sh -g    # 用户级；bash install.sh --list 查看全部目录
+bash install.sh --agent codex   # 指定智能体（--list 可查看可用项）
+bash install.sh       # 项目级：自动检测已存在的 .claude/.cursor/.codex 等 skills 目录
+bash install.sh --dir /path/to/skills
+```
+> 覆盖 17 类智能体，含国内 Trae / Qwen / Comate / CodeBuddy / Kimi。Windows 用户：装有 Git Bash 即可用；否则用方式三手动复制。
+
+### 方式三：手动复制
+把整个 yotta-humanize 文件夹复制到目标智能体的 skills 目录。常见位置（用户级；Windows 用 %USERPROFILE%，Linux/macOS 用 ~）：
+
+| 智能体 | 用户级目录 | 项目级目录 |
+|---|---|---|
+| Codex | %USERPROFILE%\.codex\skills\yotta-humanize\ | .codex\skills\ |
+| Claude Code | %USERPROFILE%\.claude\skills\yotta-humanize\ | .claude\skills\ |
+| Cursor | %USERPROFILE%\.cursor\skills\yotta-humanize\ | .cursor\skills\ |
+| Windsurf | %USERPROFILE%\.codeium\windsurf\skills\yotta-humanize\ | .windsurf\skills\ |
+| opencode | %USERPROFILE%\.config\opencode\skills\yotta-humanize\ | .opencode\skills\ |
+| Gemini | %USERPROFILE%\.gemini\skills\yotta-humanize\ | .gemini\skills\ |
+| Goose | %USERPROFILE%\.config\goose\skills\yotta-humanize\ | .goose\skills\ |
+| Amp | %USERPROFILE%\.config\agents\skills\yotta-humanize\ | .agents\skills\ |
+| Kiro | %USERPROFILE%\.kiro\skills\yotta-humanize\ | .kiro\skills\ |
+| WorkBuddy | %USERPROFILE%\.workbuddy\skills\yotta-humanize\ | .workbuddy\skills\ |
+| Trae Code CLI | %USERPROFILE%\.traecli\skills\yotta-humanize\ | .traecli\skills\ |
+| Trae IDE（国内） | %USERPROFILE%\.trae-cn\skills\yotta-humanize\ | .trae\skills\ |
+| Qwen Code | %USERPROFILE%\.qwen\skills\yotta-humanize\ | .qwen\skills\ |
+| Comate | %USERPROFILE%\.comate\skills\yotta-humanize\ | .comate\skills\ |
+| CodeBuddy | %USERPROFILE%\.codebuddy\skills\yotta-humanize\ | .codebuddy\skills\ |
+| Kimi | %USERPROFILE%\.kimi\skills\yotta-humanize\ | .kimi\skills\ |
+| 通用 AGENTS.md | %USERPROFILE%\.agents\skills\yotta-humanize\ | .agents\skills\ |
+
+> Codex 默认目录若设置了环境变量 CODEX_HOME，以该变量为准；opencode 若设置 XDG_CONFIG_HOME 同理。.agents\skills 并非通用目录，仅 OpenCode / Cursor / Cline / Amp / Kimi / Gemini CLI / GitHub Copilot 等会读取，Claude Code 与 Codex 默认不读。不确定时用 --dir 指定，或让该智能体自行安装。
+
+## 使用示例（AI 智能体）
+
+1. 将本仓库的 SKILL.md 接入任意 AI 智能体的技能/规则系统（见上方安装）。
+2. 收到一段 AI 味很重的文稿时，先跑一次检测：
+   ```bash
+   python3 scripts/yotta_humanize.py analyze -f draft.md
+   ```
+   看评分与命中规则（空泛升华 / 黑话 / 套话 / 聊天残渣等）。
+3. 无歧义的部分直接机械改写：
+   ```bash
+   python3 scripts/yotta_humanize.py rewrite -f draft.md
+   ```
+   对照修复清单确认，把改写后文本落回稿件。
+4. 需要判断的部分（排比拆句、模糊归因补来源、绝对化软化）按 suggest 的建议手工润色。
+5. 改写完再 score 一次，确认评分下降、原意未破坏。
+
+## 开发与校验
+
+- 测试：python scripts/test_yotta_humanize.py（155 项）
+- 基础校验：python tools/validate-skill.py yotta-humanize（在仓库根目录运行）
+- 规则目录：references/patterns.md；评分公式：references/scoring.md；改写规则：references/rewriting.md
+
+## 许可证
+
+MIT © YottaMeta —— 详见 [LICENSE](./LICENSE)。

package/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: yotta-humanize
+version: 0.1.0
+description: 元真 —— 去 AI 味的中文写作编辑技能：检测器引擎（24 类规则 + 词表 + 统计突发性）识别并改写 AI 腔文本，让中文写作更自然、更像人写的。触发：编辑 / 润色文本、去 AI 味、让文章 / 文案 / 回复更像人写、发现文本充斥着 AI 常用词与句式（赋能 / 闭环 / 值得注意的是 / 综上所述 / 希望对你有所帮助 等）、给 AI 生成的中文稿件做检测与改写。边界：只处理文本，不生成新内容；不改写事实 / 数据 / 专有名词；不破坏作者原意；改写为确定性规则，不依赖模型。
+license: MIT
+---
+
+# 元真（yotta-humanize）
+
+去 AI 味的中文写作编辑技能：**检测器引擎（24 类规则 + 词表 + 统计突发性）**识别 AI 腔文本并给出**确定性改写**，让中文写作更自然。
+
+零依赖（Python 3.8+ 标准库），Windows + Linux + macOS 通用；Claude Code / Cursor / Codex / 通用 Agent 均可调用。
+
+## 何时使用
+
+- 编辑 / 润色文本，去掉 AI 味，让文章、文案、回复更像人写的；
+- 给 AI 生成的中文稿件做检测（评分 0-100）与改写；
+- 发现文本充斥着 AI 常用词与句式：赋能、闭环、抓手、综上所述、未来可期、值得注意的是、希望对你有所帮助 等。
+
+**Do NOT trigger**：
+
+- 只处理文本，不生成新内容、不补写缺失信息；
+- 不改写事实 / 数据 / 专有名词 / 引文；
+- 不破坏作者原意与个人语气（正式 / 随意 / 技术向由作者定）；
+- 改写是确定性规则（替换 + 删除），需要判断的改写以建议形式给出，不强行自动改。
+
+## 快速使用
+
+Windows 用 python，Linux/macOS 用 python3。
+
+```bash
+# 评分（0-100，越高越像 AI 写的）
+python3 scripts/yotta_humanize.py score -f article.md
+
+# 详细检测报告
+python3 scripts/yotta_humanize.py analyze -f article.md
+
+# Markdown 报告
+python3 scripts/yotta_humanize.py report -f article.md > report.md
+
+# 按优先级分组的改写建议
+python3 scripts/yotta_humanize.py suggest -f article.md
+
+# 确定性改写（替换/删除 AI 腔，输出改写后文本 + 修复清单）
+python3 scripts/yotta_humanize.py rewrite -f article.md
+
+# 管道输入
+cat article.md | python3 scripts/yotta_humanize.py score --stdin
+
+# CI 拦截：评分 >= 阈值时退出码 1
+python3 scripts/yotta_humanize.py score -f article.md --gate --threshold 45
+```
+
+退出码（与元安 / 元审 / 元盾家族一致）：0 = 成功；1 = score --gate 且评分达到阈值；4 = 用法错误 / 致命异常。
+
+## 工作流程（AI 智能体编辑文本时）
+
+1. **先检测**：把待编辑文本交给元真 score 或 analyze，看评分与命中规则；
+2. **看命中**：analyze / report 给出命中规则与上下文片段；suggest 按优先级给改写建议；
+3. **机械改写**：无歧义的 AI 腔（套话、黑话、聊天残渣、同义堆叠等）用 rewrite 直接改；
+4. **人工润色**：需要判断的（排比拆句、模糊归因补来源、绝对化软化）按建议手工处理；
+5. **复核**：改写后再次 score 对比评分，确认不破坏原意。
+
+## 能力
+
+- **24 类检测规则**：空泛升华 / 套话开头结尾 / 模糊归因 / AI 黑话 / 同义堆叠 / 「我们」滥用 / 排比三连 / 机械列举 / 破折号与感叹号滥用 / 聊天残渣 / 奉承讨好 / 免责回避 / 废话填充 / 重复声明 等（五组：内容 / 语言 / 句式 / 沟通 / 废话），详见 references/patterns.md；
+- **统计突发性**：句长均匀度（CV）、突发性、词汇多样性（双字 TTR）、逗号密度，补充规则检测不到的节奏问题，详见 references/scoring.md；
+- **确定性改写**：词表替换（赋能→支持、抓手→切入点、闭环→流程…）、套话删除、聊天残渣清理、标点限流，改写后输出修复清单与前后评分，详见 references/rewriting.md；
+- **机器可读**：--json 输出纯净 JSON；score --gate 适合接入 CI / 发布前检查。
+
+## 参考文档
+
+- references/patterns.md — 24 类规则目录与命中示例
+- references/scoring.md — 评分公式与统计量说明
+- references/rewriting.md — 确定性改写规则与 CLI 协议
+
+## 责任声明
+
+本技能只做文本层面的风格编辑，不改写事实与数据；改写结果请作者复核。检测评分仅供参考，不构成对文本来源的绝对判定。

package/bin/install.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+/**
+ * yotta-humanize 跨平台安装器（YottaSkills）
+ * 用法:
+ *   npx -y @yottameta/yotta-humanize --agent <name>  # 按智能体默认用户级目录安装（推荐）
+ *   npx -y @yottameta/yotta-humanize --dir PATH      # 装到指定目录（用户改了目录的智能体）
+ *   npx -y @yottameta/yotta-humanize -g              # 安装到全部已知智能体用户级目录
+ *   npx -y @yottameta/yotta-humanize                 # 安装到检测到的项目级目录
+ *   npx -y @yottameta/yotta-humanize --list          # 列出智能体 -> 默认目录
+ */
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const SKILL_NAME = 'yotta-humanize';
+const PKG_ROOT = path.join(__dirname, '..');
+
+// 智能体 -> 用户级默认技能目录（dirs 按优先级排列；--agent 装到第一个）
+// 依据官方文档：.agents/skills 并非通用目录，被 OpenCode / Cursor / Cline / Amp /
+// Kimi / Gemini CLI / GitHub Copilot 等读取；Claude Code 与 Codex 默认不读 .agents。
+const AGENT_DIRS = {
+  claude:    { label: 'Claude Code',      dirs: ['.claude/skills'] },
+  cursor:    { label: 'Cursor',           dirs: ['.cursor/skills', '.agents/skills'] },
+  codex:     { label: 'Codex',            dirs: ['.codex/skills'] }, // 特判：$CODEX_HOME/skills
+  gemini:    { label: 'Gemini CLI',       dirs: ['.gemini/skills', '.agents/skills'] },
+  goose:     { label: 'Goose',            dirs: ['.config/goose/skills', '.agents/skills'] },
+  amp:       { label: 'Amp',              dirs: ['.config/agents/skills', '.agents/skills'] },
+  opencode:  { label: 'OpenCode',         dirs: ['.config/opencode/skills'] }, // 特判：$XDG_CONFIG_HOME
+  windsurf:  { label: 'Windsurf',         dirs: ['.codeium/windsurf/skills'] },
+  workbuddy: { label: 'WorkBuddy',        dirs: ['.workbuddy/skills'] },
+  kiro:      { label: 'Kiro',             dirs: ['.kiro/skills'] },
+  trae:      { label: 'Trae Code CLI',    dirs: ['.traecli/skills'] },
+  'trae-cn': { label: 'Trae IDE（国内）',  dirs: ['.trae-cn/skills'] },
+  qwen:      { label: 'Qwen Code',        dirs: ['.qwen/skills'] },
+  comate:    { label: 'Comate 文心快码',   dirs: ['.comate/skills'] },
+  codebuddy: { label: 'CodeBuddy Code',   dirs: ['.codebuddy/skills'] },
+  kimi:      { label: 'Kimi Code CLI',    dirs: ['.kimi/skills'] },
+  agents:    { label: '通用 AGENTS.md',    dirs: ['.agents/skills'] },
+};
+
+// Codex 用户级目录特判：优先 $CODEX_HOME/skills，否则 ~/.codex/skills
+function codexUserDir() {
+  const base = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+  return path.join(base, 'skills');
+}
+
+// OpenCode 用户级目录特判：优先 $XDG_CONFIG_HOME/opencode/skills，否则 ~/.config/opencode/skills
+function opencodeUserDir() {
+  const base = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
+  return path.join(base, 'opencode', 'skills');
+}
+
+function resolveUserDir(rel) {
+  if (rel === '.codex/skills') return codexUserDir();
+  if (rel === '.config/opencode/skills') return opencodeUserDir();
+  return path.join(os.homedir(), rel);
+}
+
+function installTo(dest) {
+  const target = path.join(dest, SKILL_NAME);
+  fs.mkdirSync(target, { recursive: true });
+  copyDir(PKG_ROOT, target, new Set(['package.json', 'bin', 'node_modules', '.git']));
+  console.log('installed -> ' + target);
+}
+
+function copyDir(src, dst, skip) {
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (skip.has(entry.name)) continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dst, entry.name);
+    if (entry.isDirectory()) {
+      fs.mkdirSync(d, { recursive: true });
+      copyDir(s, d, skip);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+function displayDir(rel) {
+  if (process.platform === 'win32') return '%USERPROFILE%\\' + rel.replace(/\//g, '\\');
+  return '~/' + rel;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const isGlobal = args.includes('-g') || args.includes('--global');
+  const list = args.includes('--list') || args.includes('-l');
+  let explicitDir = null;
+  const di = args.indexOf('--dir');
+  if (di !== -1 && args[di + 1]) explicitDir = args[di + 1];
+  let agent = null;
+  const ai = args.indexOf('--agent');
+  if (ai !== -1 && args[ai + 1]) agent = String(args[ai + 1]).toLowerCase();
+
+  if (list) {
+    console.log('智能体 -> 默认技能目录（--agent <name> 装到第一个，用户级）:');
+    for (const [key, v] of Object.entries(AGENT_DIRS)) {
+      const resolved = v.dirs.map(displayDir);
+      console.log('  ' + key.padEnd(10) + v.label.padEnd(18) + resolved.join('、'));
+    }
+    console.log('\n说明：Windows 用 %USERPROFILE%，Linux/macOS 用 ~；仅收录有官方默认目录的智能体。');
+    console.log('改了目录的请用 --dir <路径>，不要依赖默认位置；若设置了 CODEX_HOME / XDG_CONFIG_HOME，安装自动以该变量为准。');
+    return;
+  }
+
+  if (explicitDir) { installTo(explicitDir); return; }
+
+  if (agent) {
+    const info = AGENT_DIRS[agent];
+    if (!info) {
+      console.log('未收录智能体: ' + agent + '。请用 --dir <路径> 指定技能目录。');
+      console.log('可用: ' + Object.keys(AGENT_DIRS).join(', '));
+      return;
+    }
+    installTo(resolveUserDir(info.dirs[0]));
+    console.log('完成。');
+    return;
+  }
+
+  if (isGlobal) {
+    const seen = new Set();
+    for (const v of Object.values(AGENT_DIRS)) {
+      for (const d of v.dirs) {
+        if (seen.has(d)) continue;
+        seen.add(d);
+        installTo(resolveUserDir(d));
+      }
+    }
+    console.log('完成。');
+    return;
+  }
+
+  const PROJECT_DIRS = [
+    '.claude/skills',
+    '.cursor/skills',
+    '.codex/skills',
+    '.config/goose/skills',
+    '.config/agents/skills',
+    '.opencode/skills',
+    '.codeium/windsurf/skills',
+    '.workbuddy/skills',
+    '.kiro/skills',
+    '.traecli/skills',
+    '.gemini/skills',
+    '.trae-cn/skills',
+    '.qwen/skills',
+    '.comate/skills',
+    '.codebuddy/skills',
+    '.kimi/skills',
+    '.agents/skills',
+  ];
+  let installedAny = false;
+  for (const d of PROJECT_DIRS) {
+    if (fs.existsSync(d)) { installTo(d); installedAny = true; }
+  }
+  if (!installedAny) {
+    console.log('未检测到项目级智能体目录。可手动复制，或用 --agent <name> / -g 装到用户级。');
+  }
+}
+
+main();

package/install.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# yotta-humanize 多智能体安装脚本（YottaSkills 模板）
+# 用法:
+#   bash install.sh --agent <name>  # 按智能体默认用户级目录安装
+#   bash install.sh --dir <path>    # 装到指定目录（用户改过目录的智能体）
+#   bash install.sh -g              # 装到全部已知智能体用户级目录
+#   bash install.sh                  # 检测并安装到已存在的项目级目录
+#   bash install.sh --list          # 列出智能体 -> 默认目录
+set -euo pipefail
+
+SKILL_NAME="yotta-humanize"
+SOURCE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+case "$(uname -s)" in
+  MINGW*|MSYS*)
+    SOURCE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -W)"
+    ;;
+esac
+
+# 智能体 -> 用户级默认目录（--agent 装到第一个）
+# .agents/skills 并非通用目录：OpenCode / Cursor / Cline / Amp / Kimi / Gemini CLI / GitHub Copilot 读取。
+# 判断当前环境：Windows Git Bash 用 %USERPROFILE%，Unix 用 ~
+_IS_WINDOWS=0
+case "$(uname -s)" in
+  MINGW*|MSYS*|CYGWIN*) _IS_WINDOWS=1 ;;
+esac
+dirs_for() {
+  case "$1" in
+    claude)     echo ".claude/skills" ;;
+    cursor)     echo ".cursor/skills .agents/skills" ;;
+    codex)      echo "__CODEX__" ;;
+    gemini)     echo ".gemini/skills .agents/skills" ;;
+    goose)      echo ".config/goose/skills .agents/skills" ;;
+    amp)        echo ".config/agents/skills .agents/skills" ;;
+    opencode)   echo "__OPENCODE__" ;;
+    windsurf)   echo ".codeium/windsurf/skills" ;;
+    workbuddy)  echo ".workbuddy/skills" ;;
+    kiro)       echo ".kiro/skills" ;;
+    trae)       echo ".traecli/skills" ;;
+    trae-cn)    echo ".trae-cn/skills" ;;
+    qwen)       echo ".qwen/skills" ;;
+    comate)     echo ".comate/skills" ;;
+    codebuddy)  echo ".codebuddy/skills" ;;
+    kimi)       echo ".kimi/skills" ;;
+    agents)     echo ".agents/skills" ;;
+    *)          return 1 ;;
+  esac
+}
+
+codex_dir() {
+  if [ -n "${CODEX_HOME:-}" ]; then printf '%s' "$CODEX_HOME/skills"; else printf '%s' "$HOME/.codex/skills"; fi
+}
+opencode_dir() {
+  if [ -n "${XDG_CONFIG_HOME:-}" ]; then printf '%s' "$XDG_CONFIG_HOME/opencode/skills"; else printf '%s' "$HOME/.config/opencode/skills"; fi
+}
+resolve_user() {
+  case "$1" in
+    __CODEX__)    codex_dir ;;
+    __OPENCODE__) opencode_dir ;;
+    *)            printf '%s' "$HOME/$1" ;;
+  esac
+}
+
+install_to() {
+  mkdir -p "$1/$SKILL_NAME"
+  cp -r "$SOURCE_DIR/." "$1/$SKILL_NAME/"
+  rm -rf "$1/$SKILL_NAME/.git"
+  echo "installed -> $1/$SKILL_NAME"
+}
+
+list() {
+  echo "智能体 -> 默认技能目录（--agent <name> 装到第一个，用户级）:"
+  for a in claude cursor codex gemini goose amp opencode windsurf workbuddy kiro trae trae-cn qwen comate codebuddy kimi agents; do
+    local dirs first
+    dirs="$(dirs_for "$a")"
+    first="${dirs%% *}"
+    case "$first" in
+      __CODEX__)    first=".codex/skills" ;;
+      __OPENCODE__) first=".config/opencode/skills" ;;
+    esac
+    if [ "$_IS_WINDOWS" = "1" ]; then
+      first="%USERPROFILE%\\${first//\//\\}"
+    else
+      first="~/$first"
+    fi
+    printf '  %-10s %s\n' "$a" "$first"
+  done
+  echo '说明：Windows 用 %USERPROFILE%，Linux/macOS 用 ~；仅收录有官方默认目录的智能体。'
+  echo '改了目录的请用 --dir <路径>，不要依赖默认位置；若设置了 CODEX_HOME / XDG_CONFIG_HOME，安装自动以该变量为准。'
+}
+
+main() {
+  local agent="" dir="" global=0 show_list=0
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --agent) shift; agent="${1:-}" ;;
+      --dir)   shift; dir="${1:-}" ;;
+      -g|--global) global=1 ;;
+      --list|-l) show_list=1 ;;
+      *) echo "未知参数: $1" >&2; exit 2 ;;
+    esac
+    shift
+  done
+
+  if [ "$show_list" = "1" ]; then list; return; fi
+  if [ -n "$dir" ]; then install_to "$dir"; echo "完成。"; return; fi
+  if [ -n "$agent" ]; then
+    local dirs first
+    if ! dirs="$(dirs_for "$agent")"; then
+      echo "未收录智能体: $agent。请用 --dir <路径> 指定技能目录。" >&2; exit 2
+    fi
+    first="${dirs%% *}"
+    install_to "$(resolve_user "$first")"; echo "完成。"; return
+  fi
+  if [ "$global" = "1" ]; then
+    echo "安装到全部已知智能体用户级目录..."
+    local dirs rel
+    for a in claude cursor codex gemini goose amp opencode windsurf workbuddy kiro trae trae-cn qwen comate codebuddy kimi agents; do
+      dirs="$(dirs_for "$a")"
+      for rel in $dirs; do install_to "$(resolve_user "$rel")"; done
+    done
+    echo "完成。"; return
+  fi
+  local installed=0 d
+  for d in .claude/skills .cursor/skills .codex/skills .config/goose/skills .config/agents/skills .opencode/skills .codeium/windsurf/skills .workbuddy/skills .kiro/skills .traecli/skills .gemini/skills .trae-cn/skills .qwen/skills .comate/skills .codebuddy/skills .kimi/skills .agents/skills; do
+    if [ -d "$d" ]; then install_to "$d"; installed=1; fi
+  done
+  if [ "$installed" = "0" ]; then
+    echo "未检测到项目级智能体目录。可用 --agent <name> / -g 装到用户级，或 --dir 指定。"
+  fi
+}
+
+main "$@"

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@yottameta/yotta-humanize",
+  "version": "0.1.0",
+  "description": "元真 —— 去 AI 味的中文写作编辑技能：检测器引擎（24 类 + 词表 + 统计突发性）识别并改写 AI 腔文本，让中文写作更自然。触发：编辑/润色文本、去掉 AI 味、让文案更像人写时。边界：只处理文本，不生成新内容。",
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "yotta-humanize"
+  ],
+  "files": [
+    "SKILL.md",
+    "LICENSE",
+    "README.md",
+    "install.sh",
+    "references",
+    "scripts",
+    "assets",
+    "bin",
+    "NOTICE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YottaMeta/yotta-humanize.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "yotta-humanize": "bin/install.js"
+  }
+}