zizi-al/muse-agent-example
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
183 Commits 2 Branches 0 Tags
Commit Graph

5 Commits

Author SHA1 Message Date
zizi
6fe3fd0a10 框架: skill 分类改为按创作生命周期分域，取消 craft 二分 
Claude Code 只发现 .claude/skills/ 的直接子目录，不支持分类二级目录；
磁盘保持平铺，分类只在 _index.md 维护。

- _index.md 重写：47 个 skill 按创作生命周期分 9 域，条目形式为
  skill [中文注释]；取消 craft 标签与"运行时 vs 方法论参照"二分，
  novel-diagnosis 等归入检测评分域；新增跨阶段取用表
- AGENTS.md：合同责任方表由 32 个补齐至 47 个，参照 Skill 以 ° 标记；
  命名规则与 11.2 审查问题按两类分别限定适用范围；统一旧术语
- 07-Agent与Skill领域：合同九项、命名、Tool 合同与验收条件按实现性质
  限定，补掉取消 craft 豁免后"每个 Skill 输入产出都落库"字面覆盖
  纯文本 skill 的漏洞
- humanization/README：删除失联的 skills/write-human-text 整节，真包
  已在父仓技能库；同时清除三个未被跟踪的空目录
- README：.claude/skills 描述指向 _index.md，去掉已迁出的离线测试

两类的判据是产不产生系统事实，不是有没有 scripts/：plan-chapter、
expand-scene、polish-prose、rewrite-selection、optimize-content-quality
自身不带 Tool 但产生落库事实，仍是系统能力 Skill。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-08-19 22:55:11 +08:00
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
zizi
d80df3ed7c 治理: 剩余问题收口——humanization 规则/样例数据库权威 + PG 集成全通过 + 行为评测脚手架 + raw 冲突备忘录 
范围（不含 design-story-foundation、docs/design、docs/write-chapter、
craft/、humanization/README.md 等进行中改动）:

1. humanization 规则/样例运行时数据库权威
   - db/ddl/111：example_ai_flavor_rule / example_ai_flavor_sample /
     example_ai_flavor_rule_event（append-only 生命周期留痕），已应用到 muse-example
   - deai/load_db.py：数据库装载器，激活门/重复检测/指纹与文件装载器同源；
     数据库失败关闭，不静默回退 Git 文件资产
   - humanization/tools/seed_rules_db.py：YAML 种子单事务同步，幂等、
     变化留痕、--strict 对 db-only 行失败关闭；真实库已种入 26 规则/107 样例
   - prevent/diagnose/revise 生产路径切到数据库读取（--offline 显式读文件），
     落库前新鲜度检查与合同声明来源一致；四个 SKILL.md 数据库合同同步
   - 真实库验证：规则库指纹与文件种子一致（v-609bc40e21d0b5db），
     三个生产脚本端到端从库装载通过

2. PostgreSQL 集成：显式授权后 9/9 通过
   - 此前被依赖门阻断的 6 个 _db/smoke 测试全部通过
   - extract rollback 冒烟改为回滚事务内自给夹具（pending 窗/草稿缺失时自建），
     不再依赖瞬时生产状态；夹具残留核验为 0

3. Skill 行为评测脚手架（真实执行数量仍为 0）
   - harness/evals/skill_eval.py：场景合同、六类评测范畴、适配器和结构化裁决报告
   - diagnose-ai-flavor 参考场景 4 条 + 管道自测 7 项通过
   - 真实模型适配器未授权时以稳定码 EVAL_ADAPTER_UNAVAILABLE 失败关闭；
     清单登记 skill_behavior_eval 条目，默认被依赖门阻断

4. evaluate-frozen-replay raw 存储边界冲突
   - docs/2026-08-19 备忘录：平台 DB-first 合同（创始人批准）与回放链
     仓外 vault 强制的冲突事实、两个选项和裁决前约束；运行时合同未单方面改写

5. harness 自身修复
   - runner 对账语义：行为评测入口不参与测试资产双向等值，但登记文件必须存在；
     manifest 保留 skill_behavior_eval 布尔字段并校验类型
   - 新增 2 条对账回归用例

验证证据: harness 三组自测 15+15+7 通过；静态审计 32 Skill / 0 问题；
76 个非数据库条目通过；9 个 PostgreSQL 集成条目显式授权后通过；
行为评测条目默认阻断；py_compile 与 git diff --check 通过。
未调用真实模型、embedding 或额度；真实行为评测执行数量仍为 0。
 2026-08-19 02:41:25 +08:00
zizi
c9f69d9d6d 治理: Skill 测试治理第一阶段——harness 控制平面 + 实现测试迁出运行时目录 
范围（不含 design-story-foundation、docs/、humanization/README.md 等进行中改动）:

1. 新增 harness/ 控制平面
   - skill_harness.py 静态审计：32 个运行时 Skill 的 frontmatter/manifest/文档污染，当前 0 问题
   - run_selected.py 选择性执行器：manifest 与磁盘一一对账、依赖阻断、
     空跑与 skip-only 失败关闭、AST 测试形状门
   - manifests/skills.json：32 个 Skill 的合同责任方与协作领域登记
   - manifests/test-inventory.json：81 个测试资产登记
   - specs/skill-testing.md 与 README.md：测试分层、证据边界与 harness 职责

2. 实现测试从 .claude/skills/*/scripts/ 迁至 tests/skills/<skill>/
   - 71 个测试文件迁移并修复项目根与临时目录运行导入
   - 数据库触发器测试宽泛异常收窄为 psycopg.errors.RaiseException
   - 抽取离线大测试拆出真实 PG smoke（默认阻断，不计入离线通过）
   - 抽取 presence 去重边界拆出独立测试：493 + 78 = 571 项检查不变

3. 运行时文档清理
   - 13 个 SKILL.md 移除自测/离线验证段落、测试命令与测试文件事实源表述，
     只保留运行时合同；业务运行合同、额度、授权与离线模式均保留

4. SoT 同步
   - AGENTS.md：新增 Skill 领域索引（7 个合同责任方分组，覆盖 32 个运行时 Skill）
   - 领域 07：测试入口改由 harness/manifests/ 登记，SKILL.md 不承载测试命令
   - humanization 覆盖矩阵：活动测试路径同步迁移

验证证据: harness 自测 15 项 + runner 自测 13 项通过；静态审计 32 Skill / 0 问题；
73 个非数据库测试通过；8 个集成条目中 6 个 PostgreSQL 项被依赖门明确阻断；
py_compile 与 git diff --check 通过。未连接 PostgreSQL、网络、真实模型或额度。

已知边界: 真正 skill_behavior_eval 仍为 0，尚未验证任何 Skill 自然语言行为；
evaluate-frozen-replay 的 raw 存储边界冲突留待单独治理。
 2026-08-19 01:50:20 +08:00
zizi
476bb71da4 框架: 去AI味与人感资产层入库——humanization 规则库（26 条 active，其中 16 条经所有者留痕豁免 holdout 激活）与五技能先行验证副本 2026-08-16 03:04:12 +08:00