zizi 952485a506 框架: 前期创作流程代码——细纲统一合同+字段覆盖门禁+文风/范式注入+取数端统一
修五个硬伤,让"前期准备"从文档纪律变成机械门禁,并补齐写作链上游注入:
- 细纲合同合一:新建 meta/schemas/fine_outline.yaml 作唯一字段权威(必填9+推荐7),
  统一此前 planning 产出形与 writer 装配消费形两套不相交字段;fine-outline 技能对齐。
- 落库字段覆盖门禁:persist_planning 按 schema 校验必填字段,缺必填失败关闭,
  「字段存疑」逃生口;只对声明「字段覆盖门禁:强制」的型生效(fine_outline 已强制)。
- 文风真注入:WriterContext 增可选 styleConstraints(空则省键、上下文逐字节不变),
  装配投影给 writer,不再写死为空。
- 范式规划期绑定:read-context load_confirmed_pattern_bindings 只读已确认 assembly 绑定
  (实验仓承载,确认即绑定,不改主仓表);生产脚本注入已绑定范式。
- 取数端统一:read-context 三个一等取数端(细纲/范式/文风),生产编排 step2 接线,
  已确认细纲不再人肉读库传参。
- harness:AGENTS.md 第9节新增「提交前必须独立子代理形而上四维审查」硬规则。
(writer_contract/retrieve 含上一会话 asOf=0 开篇冻结线改动,同属创作链修复,随本笔提交。)

测试:9 套全绿(合同6/门禁8/装配17/writer_contract21/检索11/统一3/细纲读取4/范式读取5/文风读取6)。
2026-08-02 02:17:14 +08:00

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 顺序

  1. 父仓 design-docs/:完整 Muse 产品、业务和总体架构。
  2. 本仓 .agent/docs/architecture/domains/:单用户、数据库为权威的领域边界。
  3. meta/:结构本体和功能链登记。
  4. .claude/agents/ 与 .claude/skills/:角色和可执行能力合同。
  5. docs/:单次任务过程、评测资料与执行证据,不覆盖稳定 SoT。

所有任务从 AGENTS.md 开始。

Description
No description provided
Readme 18 MiB
Languages
Python 72.7%
TypeScript 21.9%
PLpgSQL 4.8%
CSS 0.3%
Makefile 0.1%
Other 0.1%