56b81b14f2
- 质量与复利领域 SoT 在「现有实现承认」段补入父仓专题-09 五技能先行验证链与 humanization 共享资产层；同步记下 v2 在 agent-example 落地的几条新机制 （Canonical 正文画像、载体 scope/mask、regex/handler/density 分层、 模态/时间锚点硬门、WriterContext 冻结前置合同、案例生命周期、holdout 激活门）与研究追踪矩阵 humanization/research/20-project-skill-coverage.yaml。 - humanization README 增补通用日常文本 Skill（write-human-text）说明与 示例命令，明确该 Skill 可搬移、运行时不依赖 research/ 生产规则/数据库/ 模型客户端，且不登记为 agent-example 小说生产链 scenario——正式作品候选 仍走五技能与 Canonical 接受门，通用 Skill 不能绕过。 这两条都是人感体系登记/口径收尾，与本会话人感体系落地闭环对应。 提交范围只含上述两处改动。design-story-foundation、docs/write-chapter/ docs/design/ 等其它未提交改动归属另案处理。
57 lines
4.4 KiB
Markdown
57 lines
4.4 KiB
Markdown
# humanization · 去 AI 味与人感体系（agent-example 先行验证副本）
|
||
|
||
本目录是去 AI 味与人感体系的资产层与执行骨架，初始拷贝自父仓 [`muse-deai/`](../../muse-deai/)（提交 `92a88e86`，一级能力），自拷贝之日起由 agent-example 自治管理与演进。
|
||
|
||
## 权威与演进规则
|
||
|
||
- **验证期本目录自治**：合同、规则、样例、骨架的改动直接在本仓演进，Git 历史留痕；父仓 muse-deai 同主题暂停更新，不产生两套并行版本。
|
||
- **同步方向只有一条**：验证收敛、人感体系从 agent-example 升华进 Muse 时，把验证过的资产同步回父仓 muse-deai 并更新设计文档。升华之前不向父仓回填。
|
||
- 设计 SoT（概念定义、五技能合同、验收口径）归属父仓 [`design-docs/专题-09-去AI味与人感体系设计.md`](../../design-docs/专题-09-去AI味与人感体系设计.md)；本目录不重复定义概念，验证中发现合同级缺陷时向父仓提请修订。
|
||
- 案例卡的正式载体是 `muse-example` 库（见 `.claude/skills/capture-ai-flavor-cases`）；本目录 `cards/` 只存合成示例。`src/deai/cards.py` 保留早期离线 API 兼容层，但输出/读取已对齐 `ai-flavor-case-v1`，生产采集入口仍是 `capture_cases.py`。
|
||
|
||
## 目录
|
||
|
||
```text
|
||
contracts/ 数据合同：案例/规则/样例/发现/patch/审计 + voice_baseline/prevention
|
||
src/deai/ 执行骨架：规则装载与完整指纹、载体 scope/mask、五层诊断、基线画像、门禁、评测生命周期
|
||
rules/ 规则库 v0（26 条 active，覆盖 regex/handler/density/model_judgment 四类触发器）；active 必须配齐四类样例；其中 16 条为 2026-08-16 所有者决定跳过 holdout 激活，证据栏留痕。
|
||
这 16 条的 holdout 是欠账：升回父仓或申报专题-09 §12 一级验收前必须补齐，或提请父仓修订 SoT。
|
||
26 条超出专题-09 §10 一级「10–20 条」区间，验证期定位是机制覆盖先行，升华进 Muse 时对齐区间或提请修订
|
||
samples/ 样例库（sf / snf / boundary / regression），候选规则也必须先有四类夹具
|
||
cards/ 合成案例卡示例
|
||
research/ 20 项开源研究机制追踪矩阵 + 中文轻量去重人感规则目录（研究候选，不等于 active）
|
||
skills/ 从研究目录派生的可搬移标准 Skill；当前含日常中文人感写作与场景规则选择器
|
||
tests/ 合同负路测试：../.venv/bin/python -m unittest discover -s tests -v（在 humanization/ 下运行）
|
||
eval/ 判别试跑与回归探针：../.venv/bin/python eval/run_eval.py
|
||
config.yaml 模型角色分离配置（改写模型 ≠ 选择模型，代码强制）
|
||
```
|
||
|
||
## 通用日常文本 Skill
|
||
|
||
[`skills/write-human-text/`](skills/write-human-text/SKILL.md) 是可直接迁移的日常中文写作包，包含场景规则族、详细规则库和有限轮次复检清单，覆盖小说、新闻、公众号、短视频口播、技术设计、作品设定、工作汇报、内容讲解等写作与改稿场景。它按事实类型、写作目的、载体、受众和风险选择规则子集。
|
||
|
||
该 Skill 是可搬移的标准包，运行时不依赖本目录的 `research/`、生产规则、数据库或模型客户端；迁移时复制整个 `write-human-text/` 目录即可。它不登记为 `agent-example` 小说生产链的 scenario。正式作品候选仍走下方五技能和 Canonical 接受门，不能用通用 Skill 绕过。
|
||
|
||
```bash
|
||
../.venv/bin/python skills/write-human-text/scripts/select_profile.py --list-scenes
|
||
../.venv/bin/python skills/write-human-text/scripts/select_profile.py --scene technical-design --mode draft
|
||
../.venv/bin/python skills/write-human-text/scripts/test_select_profile.py
|
||
```
|
||
|
||
## 与五个技能 skill 的对应
|
||
|
||
| 技能 | skill | 消费本目录什么 |
|
||
|---|---|---|
|
||
| 1 定基线 | `establish-voice-baseline` | 产出声音账，供修订保护项与前置预防正样例 |
|
||
| 2 前置预防 | `prevent-ai-flavor` | `rules/` active 规则的负约束 |
|
||
| 3 诊断 | `diagnose-ai-flavor` | `src/deai/diagnose.py` + `rules/` |
|
||
| 4 修订 | `revise-ai-flavor` | `patch.py` / `gates.py` / `pairwise.py` / `report.py` |
|
||
| 5 挖掘 | `capture-ai-flavor-cases` | 案例卡 → `rules/` 候选（propose-rule 门） |
|
||
|
||
## 运行测试
|
||
|
||
```bash
|
||
cd agent-example/humanization
|
||
../.venv/bin/python -m unittest discover -s tests -v
|
||
```
|