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）按"框架与创作分开"未入本提交。
3.4 KiB
3.4 KiB
name, description
| name | description |
|---|---|
| access-database | 通过唯一受控入口查询或修改 muse-example PostgreSQL，并应用可审计 DDL。主会话或 Skill 需要通用数据库访问时使用；专用导入、嵌入和检索仍走各自 Skill，禁止裸连和一次性脚本。 |
访问 muse-example 数据库
对应 muse API 面：数据访问层。连接事实与凭据见 db/连接信息.md（DSN 已锁死在脚本内，只连 muse-example）。
用法（仓库根目录执行，python 一律用 .venv/bin/python）
# 查询：卡片式打印（默认最多 50 行、长值截 160 字）
.venv/bin/python .claude/skills/access-database/scripts/db.py query "SELECT id,title FROM muse_content_work"
.venv/bin/python .claude/skills/access-database/scripts/db.py query "SELECT ..." --json # JSON 数组输出（给脚本消费）
.venv/bin/python .claude/skills/access-database/scripts/db.py query "SELECT ..." --full # 长值不截断
.venv/bin/python .claude/skills/access-database/scripts/db.py query "SELECT ..." --max 200 # 放宽行数
# 单条写操作（INSERT/UPDATE/DELETE/DDL）：报影响行数
.venv/bin/python .claude/skills/access-database/scripts/db.py exec "UPDATE ... WHERE ..."
# 参数化写操作：SQL 用 %s 占位，参数走服务端绑定（防注入；大内容不拼命令行）
.venv/bin/python .claude/skills/access-database/scripts/db.py execparams "INSERT INTO example_raw_content(kind,content_sha256,content) VALUES (%s,%s,%s)" --param response --param <sha> --param "短文本"
# 大对象（raw 全文）经 stdin 传 JSON 数组（避开 shell 转义 / ARG_MAX）：
.venv/bin/python .claude/skills/access-database/scripts/db.py execparams "INSERT ... VALUES (%s,%s)" --stdin < params.json # params.json = ["<sha>", "<完整全文>"]
# execparams 参数装载逻辑离线自测（不连库）
.venv/bin/python .claude/skills/access-database/scripts/test_db_params.py
# SQL 文件应用：整文件一个事务，失败全回滚
.venv/bin/python .claude/skills/access-database/scripts/db.py apply db/ddl/91-example实验私货.sql
# 表清单+活行数（deleted=FALSE 计数，无 deleted 列的表计全行）
.venv/bin/python .claude/skills/access-database/scripts/db.py tables
# A3 种子：23 型 YAML → meta 表行（幂等可重跑；字段改动=改 YAML 后重跑）
.venv/bin/python .claude/skills/access-database/scripts/seed_schemas.py
红线
- 只连
muse-example：DSN 硬编码锁库；严禁改造脚本去碰共享 PG 上的 muse_local / muse_slice_live / *_test。 - 软删约定照主仓：删除=UPDATE
deleted=TRUE，不物理删（example_* 表同样遵守）。 - 批量导入/嵌入等专用写路径由
import-book/embed-knowledgeSkill 封装（内部同走 psycopg 直连），本 Skill 承担通用查改与 DDL 应用。 - 建表/改表先落
db/ddl/文件再apply，不敲一次性 DDL——文件即审计。 - 大对象写入（raw 全文等）走
execparams参数化通道（大内容经 stdin JSON），不得把大内容拼进exec的 SQL 字符串（shell 转义 + ARG_MAX）；参数化绑定同时防 SQL 注入。
元数据驱动
库内 muse_meta_schema / muse_meta_field / muse_meta_visibility_policy 是 23 型结构本体的权威行（A3 起）；拆书与抽取的字段合同一律 query 读库取，不再读 meta/schemas/ YAML（YAML 退为设计稿与种子来源）。