zizi 56b81b14f2 docs(deai): 人感体系 v2 登记补完——质量领域一句话 + humanization README
- 质量与复利领域 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/ 等其它未提交改动归属另案处理。
2026-08-19 21:01:47 +08:00

4.4 KiB
Raw Blame History

humanization · 去 AI 味与人感体系(agent-example 先行验证副本)

本目录是去 AI 味与人感体系的资产层与执行骨架,初始拷贝自父仓 muse-deai/(提交 92a88e86,一级能力),自拷贝之日起由 agent-example 自治管理与演进。

权威与演进规则

  • 验证期本目录自治:合同、规则、样例、骨架的改动直接在本仓演进,Git 历史留痕;父仓 muse-deai 同主题暂停更新,不产生两套并行版本。
  • 同步方向只有一条:验证收敛、人感体系从 agent-example 升华进 Muse 时,把验证过的资产同步回父仓 muse-deai 并更新设计文档。升华之前不向父仓回填。
  • 设计 SoT(概念定义、五技能合同、验收口径)归属父仓 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。

目录

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/ 是可直接迁移的日常中文写作包,包含场景规则族、详细规则库和有限轮次复检清单,覆盖小说、新闻、公众号、短视频口播、技术设计、作品设定、工作汇报、内容讲解等写作与改稿场景。它按事实类型、写作目的、载体、受众和风险选择规则子集。

该 Skill 是可搬移的标准包,运行时不依赖本目录的 research/、生产规则、数据库或模型客户端;迁移时复制整个 write-human-text/ 目录即可。它不登记为 agent-example 小说生产链的 scenario。正式作品候选仍走下方五技能和 Canonical 接受门,不能用通用 Skill 绕过。

../.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 门)

运行测试

cd agent-example/humanization
../.venv/bin/python -m unittest discover -s tests -v