7f9114eca5
作者场景路由与指令、完善故事基础设定/合并故事方案/制定作品规划的技能中文化重构及其脚本、对应旧测试修改、SOT 导读、技能目录与实现回顾。此为 W13 阶段对已跟踪文件的改动，随批次按阶段整理补提交。
97 lines
18 KiB
Markdown
97 lines
18 KiB
Markdown
# Muse 编排技能目录
|
||
|
||
> **业务发现合同**：主代理与业务编排按“技能文件”读取对应 `SKILL.md`。编排技能不进入智能体框架的运行期目录；物理位置完全取自 manifest 的 `skill_path`。
|
||
|
||
本目录只登记技能名、技能文件和技能说明。分类字段与责任方仍以 [`lifecycle/quality/harness/manifests/skills.json`](lifecycle/quality/harness/manifests/skills.json) 为准，由 `muse/lifecycle/quality/harness` 机械校验。
|
||
|
||
本文件由 `muse/lifecycle/quality/harness/skills_index.py --write` 生成，手改会被覆盖；按生命周期分域，共 44 个编排技能。
|
||
|
||
## 0 平台底座
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 审查变更是否合理 | [SKILL.md](lifecycle/quality/skills/audit/审查变更是否合理/SKILL.md) | 对真实 git diff 做提交前四维形而上审查（逻辑完整性、一致性、合理性、可行性），产出带 file:line 证据的通过或阻断裁决。取得用户提交授权后、git add/commit 前使用；机械门（skill_harness、run_selected 等）未绿时先跑机械门，不找本技能。 |
|
||
| 执行角色任务 | [SKILL.md](platform/llm/skills/执行角色任务/SKILL.md) | 以冻结 RoleExecutionProfile 运行一次不经框架的直接 HTTP 角色调用，校验模型策略、期限、预算、结构和输入输出哈希并返回 RoleExecutionReceipt。writer、planner、extractor、detector 或 judge 的无工具批处理需要直接模型调用时使用；需要框架原生 ReAct/工具循环的子代理执行走 派发智能体任务；能力探针刷新交给 验证角色运行能力，本 Skill 不负责保存 raw、登记运行或裁决业务结果。 |
|
||
| 派发智能体任务 | [SKILL.md](lifecycle/dispatch/skills/派发智能体任务/SKILL.md) | 把冻结角色任务包派发给 Agent 框架子代理执行并自动留痕：注入角色 prompt 与输出 Schema、按白名单开放工具、归一框架事件流写入代理事件账本，结构化输出经 Draft 2020-12 校验后返回回执。当前生产入口使用 Pi；DSH headless 仅有独立的无工具 fresh 对照适配器，尚未接入本 Skill 的生产派发。执行 writer/planner/detector/judge/extractor 角色任务时使用；不经框架的直接 HTTP 批处理走 执行角色任务；本 Skill 不做补证、重写等业务决策。 |
|
||
| 记录运行证据 | [SKILL.md](authority/evidence/skills/记录运行证据/SKILL.md) | 记录模型调用、运行登记、不可变回执、CAS revision 和受控 raw 证据。执行器或业务 Skill 需要持久化一次运行、追加失败证据、补回执引用或管理 raw 备份时使用；不负责调用模型或裁决内容质量。 |
|
||
| 访问数据库 | [SKILL.md](authority/evidence/skills/访问数据库/SKILL.md) | 通过唯一受控入口查询或修改 muse-example PostgreSQL，并应用可审计 DDL。主会话或 Skill 需要通用数据库访问时使用；专用导入、嵌入和检索仍走各自 Skill，禁止裸连和一次性脚本。 |
|
||
| 调用内容模型 | [SKILL.md](platform/llm/skills/调用内容模型/SKILL.md) | 通过 New-API 的统一治理入口调用内容模型，执行额度窗口、模型降级、重试和 JSON 提取。清洗、拆书或知识审核需要 MiniMax 等内容模型时使用；不得裸调外部服务。 |
|
||
| 验证角色运行能力 | [SKILL.md](platform/llm/skills/验证角色运行能力/SKILL.md) | 通过 执行角色任务 用当前 writer 提示词、结构和档案实跑一次极小合成角色任务，刷新运行探针记录与自哈希并把完整配置写到新文件。角色合同或运行时、模型策略版本变化导致执行门失败时使用；不就地覆盖原配置，不把离线预览伪装成成功证明。 |
|
||
|
||
## 1 素材导入与拆解
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 修复作品抽取结果 | [SKILL.md](content/entity/skills/ingest/修复作品抽取结果/SKILL.md) | 对已有 upgrade_book 抽取结果做定向修复与存量迁移，包括 legacy failed 窗口恢复、单卡质量修复、presence 重复清理、存量窗口章号定位和存量回洗。需要修补个别窗口或行而不是重跑全书时使用；正常按窗抽取归 抽取作品知识，全量重置归 重置作品抽取结果，备份恢复归 备份作品抽取结果。 |
|
||
| 备份作品抽取结果 | [SKILL.md](content/entity/skills/ingest/备份作品抽取结果/SKILL.md) | 对单本作品的 upgrade_book 派生状态做七域一致性备份、离线复验、回滚演练与精确恢复。需要在重置或高危维护前留下可复验快照、或需要把作品抽取状态恢复到某个备份点时使用；不负责重置、定向修复和正常按窗抽取。 |
|
||
| 导入书稿 | [SKILL.md](content/entity/skills/ingest/导入书稿/SKILL.md) | 将参考书或用户旧稿 txt 确定性分章并写入作品、章节、正文 block 和来源档案。首次导入完整书稿或明确重导时使用；不调用模型、不改写正文。导入后散落广告/乱码/拉票等语义噪声归 清理书稿文本，本 Skill 不做 M3 探测删除。 |
|
||
| 抽取作品知识 | [SKILL.md](content/entity/skills/ingest/抽取作品知识/SKILL.md) | 将已完成拆解的作品正文按窗口抽取为 upgrade_book 实体、关系与演变草稿。作品完成拆书后需要建立本书知识面、续跑抽取窗口或查看抽取进度时使用；备份/恢复归 备份作品抽取结果，全量重置归 重置作品抽取结果，定向修复/迁移归 修复作品抽取结果，本 Skill 不负责这三类维护。 |
|
||
| 拆解书稿 | [SKILL.md](content/entity/skills/ingest/拆解书稿/SKILL.md) | 从完整存量作品逆向拆出章节细纲、阶段大纲、实体线索和脱敏写作范式。需要解析用户旧稿或参考书全书时使用；不负责把作品面知识按窗升格，也不确认产物。 |
|
||
| 检查拆书结果 | [SKILL.md](content/entity/skills/ingest/检查拆书结果/SKILL.md) | 只读体检拆书与升格两条管线的终态，并导出范式卡与升格实体卡样张。需要在一批跑完后机械核对章级细纲、窗级大纲、范式出卡和作品面升格四层健康度、或需要呈报样张时使用；不负责解析、抽取和任何修复动作。 |
|
||
| 清理书稿文本 | [SKILL.md](content/entity/skills/ingest/清理书稿文本/SKILL.md) | 识别并删除参考书或旧稿中的广告、水印、作者拉票和乱码噪声，同时保留逐段审计。静态导入后仍有语义垃圾时使用；模型只提候选，确定性守卫决定是否删除，绝不改写正文。首次 txt 分章落库归 导入书稿；本 Skill 只在已有 block 上做语义噪声清洗。 |
|
||
| 重置作品抽取结果 | [SKILL.md](content/entity/skills/ingest/重置作品抽取结果/SKILL.md) | 全量重抽前预览或清空单本作品的 upgrade_book 派生状态，把窗口退回 pending。需要对一本书重新跑一遍作品面抽取时使用；正常按窗抽取归 抽取作品知识，定向修复归 修复作品抽取结果，备份恢复归 备份作品抽取结果。 |
|
||
|
||
## 2 知识与上下文供给
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 准备任务上下文 | [SKILL.md](lifecycle/context/skills/准备任务上下文/SKILL.md) | 按冻结点从 PostgreSQL 读取可信来源，组装可审计上下文，并为 writer、detector、judge、planner 或 extractor 生成最小投影。创作或评测调用模型前需要受控上下文时使用。 |
|
||
| 固定任务上下文 | [SKILL.md](lifecycle/context/skills/固定任务上下文/SKILL.md) | 将截至指定章号的来源冻结为可重复清单，并校验授权、版本、未来信息泄漏和只读原文装载。上下文组装或回放评测需要稳定时间边界时使用；不调用模型、不写正式数据。 |
|
||
| 审核知识卡 | [SKILL.md](content/entity/skills/review/审核知识卡/SKILL.md) | 以三种编辑视角审核公共知识卡的成立性、创作可用性和跨书复用性，并写回 pass、revise 或 reject。拆书产出公共卡后使用；不负责生成卡或确认作品私有知识。 |
|
||
| 抽取章节知识 | [SKILL.md](content/entity/skills/extract/抽取章节知识/SKILL.md) | 从已接受章节抽取实体、关系、事件和叙事状态草稿，并提出既有知识更新。正文进入 Canonical 后需要章后增量知识时使用；只产草稿，不自动确认知识。 |
|
||
| 检索知识 | [SKILL.md](lifecycle/context/skills/检索知识/SKILL.md) | 将创作意图嵌入后从 pgvector 召回知识，并按绑定、状态和 aiContext 权限裁剪结果。管理审查或上下文组装需要知识候选时使用；不返回参考书全文，不绕过作品绑定。 |
|
||
| 生成知识向量 | [SKILL.md](lifecycle/context/skills/生成知识向量/SKILL.md) | 使用固定 Qwen3 嵌入模型将知识草稿或实体批量写入 pgvector，并按内容哈希幂等处理 owner 与版本。知识行需要建立或刷新检索向量时使用；不嵌入参考书全文。 |
|
||
|
||
## 3 概念与前期设计
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 合并故事方案 | [SKILL.md](lifecycle/flow/skills/book/合并故事方案/SKILL.md) | 作者明确要求结合几种已有故事设想时，按指定范围比较兼容性、解释取舍并形成合并建议。可合并局部片段或整稿，产物留在 .agents.local/草稿/；多轮探索归 完善故事基础设定，正式规划落库归 制定作品规划。 |
|
||
| 完善故事基础设定 | [SKILL.md](lifecycle/flow/skills/book/完善故事基础设定/SKILL.md) | 作者从点子、片段或已有设计继续构思作品时，用提示词引导多轮探索，在 .agents.local/草稿/ 逐步形成作品探索稿。按需发展素材、联系、中心与结构，整理交付时才校验格式；指定的多案合并归 合并故事方案，正式规划落库归 制定作品规划。 |
|
||
|
||
## 4 结构与规划
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 制定作品规划 | [SKILL.md](lifecycle/flow/skills/book/制定作品规划/SKILL.md) | 按正式 schema 生成或修订作品设定包、大纲、知识卡、状态和装配草稿。前期方向已由用户选定并进入正式规划，或续作需要调整规划时使用；不写正文，未确认产物不进入生成上下文。单章 fine_outline（含 writer 硬依赖字段）只归 规划下一章；本 Skill 不得写入 section_type=fine_outline。 |
|
||
| 规划下一章 | [SKILL.md](lifecycle/flow/skills/chapter/规划下一章/SKILL.md) | 根据已确认规划、叙事状态和冻结事实生成下一章结构细纲草稿。正文生成前需要明确章目标、事件因果、出场实体、伏笔动作和章末钩子时使用；不写正文、不读取目标章答案。书级设定/大纲/装配归 制定作品规划；本 Skill 是 section_type=fine_outline 的唯一写入方（经 persist_planning.py --owner-skill 规划下一章）。 |
|
||
|
||
## 5 正文写作与呈现
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 写下一章 | [SKILL.md](content/work/skills/generate/写下一章/SKILL.md) | 通过“白名单探索→确定性回放→无工具生成”两阶段写手，按已确认细纲、冻结事实和动态篇幅合同生成下一整章候选。作品需要续写下一章且输入合同完整时使用；不改规划、不把候选直接写入 Canonical。 |
|
||
| 扩写场景 | [SKILL.md](content/work/skills/generate/扩写场景/SKILL.md) | 在既有场景内补充动作链、对话潜台词、感官细节和环境互动。用户认为某个场景过薄并明确要求扩写时使用；不新开场景、不改落点、不夹带新设定。点名改情节/翻案归 重写选段；只修语病/标点/节奏归 润色正文；AI 味须先 诊断机器味，本槽不得绕过。 |
|
||
| 润色正文 | [SKILL.md](content/work/skills/generate/润色正文/SKILL.md) | 修正候选或既有正文的错字、语病、标点、节奏和角色声音指纹（非规则级去 AI 味）。用户只要求改善表达层时使用；不得改变情节事实、场景结构或对白语义。场景加厚归 扩写场景；点名改范围/翻案归 重写选段；AI 味检测与修订归 诊断机器味 → 修正正文机器味，本 Skill 不得自称去 AI 味入口。 |
|
||
| 重写选段 | [SKILL.md](content/work/skills/generate/重写选段/SKILL.md) | 按用户意见重写指定段落或场景，并校验范围、事实锚和版本。用户明确点名修改范围时使用；范围外原文不动，不顺手改规划或知识卡。场景过薄只加厚归 扩写场景；只修表达层归 润色正文；AI 味须先 诊断机器味，本槽不得绕过。 |
|
||
|
||
## 6 检测、评分与诊断
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 准备正文回放数据 | [SKILL.md](lifecycle/quality/skills/replay/准备正文回放数据/SKILL.md) | 在单个只读事务内从实验库装配正文回放的真实临时配置：来源证明、授权快照、目标 scaffold 拆分、冻结历史与预注册卡，写到仓库外临时文件。回放要从仓内合成夹具切到真实作品时使用；只 SELECT，不查询目标章正文，不把原书写进 Git。 |
|
||
| 分析质量短板 | [SKILL.md](lifecycle/quality/skills/judge/分析质量短板/SKILL.md) | 根据 评估内容质量 的独立评分，锁定最低质量维度并归因到 prompt、上下文或设定层，只出单变量改进建议。候选稳定不达标且需要定位改进来源时使用；不执行重生成、不改 rubric、不自行提交代码。 |
|
||
| 判定质量是否合格 | [SKILL.md](lifecycle/quality/skills/mechanical/判定质量是否合格/SKILL.md) | 从不可变逐层回执构建 Gate 输入，并按父仓专题-04 的固定顺序产出 Gate A/B 终态与可核验 receipt。回放评测收集完逐样本脱敏结果、需要一个不可协商的通过/不通过裁决时使用；不评分、不改样本、不放宽阈值。 |
|
||
| 回放评估正文质量 | [SKILL.md](lifecycle/quality/skills/replay/回放评估正文质量/SKILL.md) | 执行正文 A/B/C 三臂隔离回放：构造并校验三臂 WriterContext、跑写手与盲评、结算预算与 raw 租约，产出逐样本脱敏结果。需要用真实作品验证卡索引对正文质量是否有增益时使用；不产生 Gate 终态，不把原书正文写进仓库。 |
|
||
| 回放评估细纲质量 | [SKILL.md](lifecycle/quality/skills/replay/回放评估细纲质量/SKILL.md) | 编排细纲隔离回放：把参考作品冻结到 as_of 章号，跑三臂 planner、盲 detector 与双盲 judge，产出可审计的逐样本结果。需要验证知识或上下文方案对细纲质量是否有增益时使用；阻断未来信息、未授权来源和不可接受的候选流入生产。 |
|
||
| 核对内容一致性 | [SKILL.md](lifecycle/quality/skills/semantic/核对内容一致性/SKILL.md) | 检查正文或细纲候选的结构、事实、角色状态、能力代价、伏笔和证据缺口。候选进入用户决策或独立评分前使用；只产检测报告，不修改候选。 |
|
||
| 评估内容质量 | [SKILL.md](lifecycle/quality/skills/judge/评估内容质量/SKILL.md) | 按独立 rubric 评分在线正文、正文回放或细纲回放，产出逐维分数、引文证据与理由。候选交付用户前或回放实验需要独立质量判断时使用；只评分不裁决——集合级通过/不通过归 判定质量是否合格；不改候选、不放宽阈值。 |
|
||
|
||
## 7 去 AI 味与人感
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 修正正文机器味 | [SKILL.md](lifecycle/quality/humanization/skills/修正正文机器味/SKILL.md) | 技能 4 修订：在诊断产物与作者同意之上执行最小 patch，过硬门、复扫与成对选择校验，产出候选稿与审计报告。没诊断不启动；人不点头永远是候选。 |
|
||
| 建立作品声音档案 | [SKILL.md](lifecycle/quality/humanization/skills/建立作品声音档案/SKILL.md) | 技能 1 定基线：作品建立或新角色登场时，把已确认正文与作者样张产出的声音账做结构校验、grounding 门后版本化落库。不产正文；是修订门禁与前置预防的对照物。 |
|
||
| 建立机器味规则 | [SKILL.md](lifecycle/quality/humanization/skills/建立机器味规则/SKILL.md) | 把已标注的 AI 味案例卡沿 canonical→样例→规则候选→评测→激活的升格链推进，并负责降级。需要确认案例卡、投影四类样例、归纳规则候选、跑合同回放或审批激活时使用；不做案例采集与扫描，也不改正文。 |
|
||
| 记录机器味案例 | [SKILL.md](lifecycle/quality/humanization/skills/记录机器味案例/SKILL.md) | 从已有作品或创作反馈中抽取可复核的 AI 味案例卡，保留来源哈希与位置并做来源重验证。需要反向积累人感样例、记录一次写作事故或批量回填既有作品时使用；不做标注确认与规则升格，不直接修改正文、范式或生产规则。 |
|
||
| 诊断机器味 | [SKILL.md](lifecycle/quality/humanization/skills/诊断机器味/SKILL.md) | 技能 3 诊断：对目标正文跑 active 规则库，产出带精确片段与证据的发现清单，检测完成自动落库。只查不改；没有本产物，修正正文机器味 拒绝启动。 |
|
||
| 预防机器味 | [SKILL.md](lifecycle/quality/humanization/skills/预防机器味/SKILL.md) | 技能 2 前置预防：生成前组装写作上下文合同——active 规则的负约束（附反例）加声音账的正样例与保护项。不碰正文，只供上下文组装消费。 |
|
||
|
||
## 8 候选主权与落库
|
||
|
||
| 技能名 | 技能文件 | 技能说明 |
|
||
|---|---|---|
|
||
| 决定正文候选去留 | [SKILL.md](content/work/skills/sovereignty/决定正文候选去留/SKILL.md) | 据用户明确指令接受、合并或丢弃 Shadow 正文候选并更新 Canonical。仅主会话在用户决定后调用；知识卡归 确认知识草稿，规划归 制定作品规划。 |
|
||
| 确认知识草稿 | [SKILL.md](content/entity/skills/sovereignty/确认知识草稿/SKILL.md) | 用户明确确认后把知识草稿翻成作品正式知识面，写入实体或关系、绑定知识库并迁移向量 owner。抽取或拆书产出的卡需要转正时使用；不处理正文候选、规划确认和冲突裁决。 |
|