b0bc7a8745
一、技能重组（动作-对象命名） - 旧目录 clean/confirm/continuation/db/detect/embed/… 重组为 clean-book-text/decide-candidate/write-next-chapter/access-database/ check-content-consistency/embed-knowledge/…（git 识别为 rename，内容保持） - agents/*.md、AGENTS.md/CLAUDE.md 收编、example_skill 登记表同步新名 二、先审后入创作闭环（本次核心） 正文接受从"机械门一过就写正典"改为"机械门+语义审查双通过+用户批准+单事务原子提交"， DB 级兜底，编排层跳步即被硬拒。 - candidate_cas.py + example_candidate_cas(109)：持久化 CAS 状态链 - fact_delta.py + example_fact_delta/example_fact_ledger(106)：结构化事实增量， 模型只提六型闭集增量+正文证据引文，仅用户批准的增量随正文同事务入账本 - projection_registry.py + example_projection_run(107)：投影登记与恢复 - acceptance_state.py：接受前置实时状态重读 - lesson_registry.py + example_lesson(108)：经验升格链，禁止自动升格 - DDL 105：example_candidate 增 semantic_status/semantic_report_sha256 - write_canonical.accept：语义兜底+同事务合并增量+登记投影； run_writer_pipeline/persist_writer_run/run_writer_semantic_detector/step2 接入全链 - claude_runtime：兼容新 CLI modelUsage 信息字段 三、审查修复（独立子代理四维审查后） - 事实增量 propose→approve 翻态正道，不撞唯一键 - 冻结配置探针重刷（CLI 2.1.211→2.1.231 漂移），profileSha256/adapterVersion 再登记 - 可视化合同悬空路径/五六空间矛盾、 SoT 旧技能名漂移、行尾空白清理 测试：离线 65 套 + 真实库集成 5 套（CAS/接受故障注入/事实增量/投影/经验升格）+ 回放 79 项全绿。 创作内容（docs/design、生成正文 artifacts）按"框架与创作分开"未入本提交。
agent-example
agent-example 的目标是成为 Muse 的单用户缩小版，以 PostgreSQL 为正式内容权威：ReAct Agent 通过角色 Agent、Skill 和确定性工具，完成长篇小说的作品管理、实体维护、范式复用、规划、写作、审核、用户决策和经验复利。代码与文档在 Git，正式内容在数据库。
本项目不包含管理员、多用户、租户、市场、计费和资产交易。完整 Muse 产品、业务和总体架构仍以父仓 ../design-docs/ 为准。
数据权威
核心合同是：
PostgreSQL（muse-example 库） = 正式内容权威（作品 / 章 / 正文 / 实体 / 范式 / 用户决策 / 运行回执 / raw）
Git = 代码 / Skill / 文档 / DDL 的权威，并可对作品信息与作品文本留痕（历史 / 备份）
库内向量索引 = 数据库一侧的检索加速，可从库重建
正式内容以库为准；Git 留痕不是权威，只读看板只读库，两者冲突时以库为准。可恢复性靠数据库备份，加上 Git 里的代码与 DDL 重建库结构。一切输入和产出都必须落库才能被看板看见。
三条正交轴
内容：作品 + 实体 + 范式
流程：上下文组装 -> 创作 -> 质量审核 -> 用户决策 -> 复利
能力：Agent + Skill + Tool + 数据库存储 + 只读看板
领域边界、数据权威和验收合同见 .agent/docs/architecture/domains/_index.md。该目录定义目标行为，不代表所有落库写入和只读看板已经完成实现。
当前工程入口
agent-example/
├── AGENTS.md # 项目工作入口与规则
├── CLAUDE.md # 只引用 AGENTS.md 的兼容入口
├── .agent/ # 跨任务长期知识与领域设计 SoT
├── .claude/agents/ # 角色 Agent
├── .claude/skills/ # Skill、确定性工具和离线测试
├── meta/schemas/ # 结构本体与本地字段合同
├── meta/chains/ # 功能链、场景、用途和角色槽位
├── knowledge/ # 现有参考资产
├── db/ # PostgreSQL（正式内容权威）的 DDL 与资料
└── docs/ # 单次任务资料、评测样张和历史执行证据
正式内容在 PostgreSQL，不在 content/ 文件目录。判断有没有某个内容，以库里能不能查到为准；不得把库外文件或临时快照说成正式内容。
正向创作
用户意图
-> 读取作品、实体和范式
-> 冻结角色上下文
-> 规划/写作 Agent 产生 Shadow 候选
-> 确定性检查、语义检测和质量审核
-> 用户原样接受、修改后合并或丢弃
-> 正式正文（写入库内正文块）
-> 实体草稿、范式观察和复利验证
Gate A/B 是开发期离线能力验收，不是正常用户写一章的生产主流程。评测候选固定不可进入 Canonical。
SoT 顺序
- 父仓
design-docs/：完整 Muse 产品、业务和总体架构。 - 本仓
.agent/docs/architecture/domains/：单用户、数据库为权威的领域边界。 meta/：结构本体和功能链登记。.claude/agents/与.claude/skills/：角色和可执行能力合同。docs/：单次任务过程、评测资料与执行证据，不覆盖稳定 SoT。
所有任务从 AGENTS.md 开始。