muse-agent-example/.agent/skills/confirm-knowledge-draft/SKILL.md

name, description

name	description
confirm-knowledge-draft	用户明确确认后把知识草稿翻成作品正式知识面，写入实体或关系、绑定知识库并迁移向量 owner。抽取或拆书产出的卡需要转正时使用；不处理正文候选、规划确认和冲突裁决。

确认知识草稿（知识轨的 Shadow→Canonical）

只在用户明确说"确认这张卡"之后执行，主会话与智能体不得自行发起。

与正文轨的分工：正文候选的接受、合并、丢弃归 decide-candidate，表集是 content_text 与归因、事实账本、投影登记；本 Skill 的表集是 muse_knowledge_draft / muse_knowledge_entity / muse_knowledge_relation 与向量 owner，两边完全不交。采纳正文 ≠ 确认知识。

输入

# 试跑单张草稿
.venv/bin/python .agent/skills/confirm-knowledge-draft/scripts/confirm_knowledge.py \
  --draft-id <id> --dry-run

# 批量必须显式点名范围
.venv/bin/python .agent/skills/confirm-knowledge-draft/scripts/confirm_knowledge.py \
  --all-entities <work_id>
.venv/bin/python .agent/skills/confirm-knowledge-draft/scripts/confirm_knowledge.py \
  --all-relations <work_id>

来源限于 chapter_extract、parse_book、upgrade_book 三类抽取草稿。

输出

逐草稿的确认回执：草稿 id、翻转后的状态、写入的实体或关系 id、知识库绑定结果与向量 owner 迁移结果。--dry-run 走完整事务再回滚，只报告将发生什么。

数据边界

单事务内完成四件事：muse_knowledge_draft 翻 confirmed、实体写 muse_knowledge_entity(active)（关系卡写 muse_knowledge_relation）、确保作品↔知识库绑定、迁移实体向量 owner。任一失败整体回滚，不留半确认的卡。不写正文表、不写事实账本、不写投影登记。

红线

• 未经用户明确确认不得执行；Agent 不得自行触发。
• 有冲突的卡必须先裁决再确认，不得靠批量确认掩盖冲突。
• 批量确认必须显式给出 --all-entities 或 --all-relations，不提供"确认全部草稿"的无范围入口。
• 不接受正文候选 id；正文轨走 decide-candidate。

复利合同

• 成功落库后经 record-run-evidence 的 propose_lesson_dedup 登记 example_lesson（绑 run_id / work_id）。
• 升格仍走人工评审，不自动把单次运行升为公共范式。