muse-agent-example/docs/功能规格/技能身份中文化与作者创作入口.md

技能身份中文化与作者创作入口

1. 目标

本功能降低作者在创作过程中的命名、路由和系统概念负担，使作者能够直接用自然中文完成定故事、排故事、塑人物、续写、修改和诊断，同时把项目正式技能的业务身份统一为中文单名。

本功能同时满足两项要求：

1. 作者可见的入口、指令、问题、结果和决策动作使用自然中文。
2. 59 个正式技能的目录名、声明名称、索引名称、运行归属和当前登记值使用同一个中文名。

中文化不得改变 Shadow → Canonical 的主权边界，不得让作者入口绕过既有功能技能、角色合同、质量门禁、用户确认或数据库写入合同。

2. 概念与边界

2.1 概念

概念	定义
正式技能	muse/lifecycle/quality/harness/manifests/skills.json 登记且磁盘存在的 59 个项目技能
技能业务身份	作者、主代理、运行编排和当前业务数据用来指认一项技能的唯一名称
作者指令层	把作者自然语言意图路由到正式技能的轻量入口，不复制正式技能的能力合同
机器协议	为框架、代码、数据库和外部工具保持稳定的结构标识，如文件名、字段名、类名和参数名
历史标识	不可变运行回执、raw、审计记录和历史证据中真实出现过的旧英文技能名

2.2 纳入范围

• 59 个正式技能的叶子目录名。
• .agent/skills/ 下承载方法技能的分类目录名。
• 每份 SKILL.md 的 frontmatter name 与正文自称。
• 方法技能与编排技能的正式目录索引、链接文字和表头。
• skills.json 中的技能名称与路径。
• 角色合同、功能链、调度配置和提示词中的技能身份引用。
• 活跃代码中的技能身份字符串、当前技能归属值和当前数据库登记值。
• 测试目录、测试清单责任方、看板名称、筛选项和作者可见报告。
• 指向技能包的活跃合同、导读和相对链接。
• 作者指令层、作者场景目录和原生中文写作共同合同。

2.3 不纳入范围

• .agents.local/skills/my-skills/ 及其外部包内容。
• SKILL.md 文件名。
• frontmatter 键、manifest 字段名、数据库表名与列名。
• Python、TypeScript、SQL 等程序中的模块名、类名、函数名和普通变量名。
• 结构契约字段、命令行参数、协议版本、错误码和模型供应商真实名称。
• 不可变历史回执、raw、审计记录和历史证据中的旧英文技能名。
• 与技能身份无关的全仓中文化或程序协议迁移。

程序中的字符串只要承担“技能是谁”的业务身份，就属于迁移范围；只要承担数据结构、控制流或外部协议职责，就保持原标识。

3. 身份规则

3.1 中文单名

迁移后，每个正式技能必须满足：

中文叶子目录名
= SKILL.md frontmatter name
= manifest name
= 目录索引名称
= 角色与功能链引用名
= 新运行写入的技能归属值
= 当前数据库技能登记名

一个中文名只对应一个目录和一份 SKILL.md。正式运行时不得保留英文别名、旧目录、兼容技能或双份合同。

3.2 命名约束

稳定命名合同由 07-Agent 与 Skill 领域 §3.1 独家拥有；本节只登记本次中文迁移的选择条件。

• 59 个目标名必须逐项通过 §3.1 和机器迁移预检，规格表与机器映射完全一致。
• 本次目标名不使用内部阶段词或支架术语代替业务能力，不保留英文补充名。
• 分类目录只表达能力分区，不参与技能身份。

3.3 发现链

项目内正式技能发现只依赖渐进式目录，不依赖宿主自动扫描：

AGENTS.md
  → .agent/目录.md
    → .agent/skills/目录.md
    → muse/技能目录.md
      → <中文技能名>/SKILL.md

宿主若要求额外机读标识，该标识只能存在于生成产物或适配协议中，不得成为作者可见名称、项目正式别名或第二条技能发现路径。

4. 正式技能中文名称

以下映射是正式迁移表。旧名只用于识别迁移来源和历史记录，不具有迁移后的调用能力。

4.1 平台底座

旧名	中文单名
access-database	访问数据库
call-content-model	调用内容模型
dispatch-agent-task	派发智能体任务
execute-role-task	执行角色任务
metaphysical-diff-review	审查变更是否合理
record-run-evidence	记录运行证据
refresh-runtime-probe	验证角色运行能力

4.2 素材导入与拆解

旧名	中文单名
backup-work-extraction	备份作品抽取结果
clean-book-text	清理书稿文本
deconstruct-book	拆解书稿
extract-work-knowledge	抽取作品知识
import-book	导入书稿
inspect-parse-health	检查拆书结果
repair-work-extraction	修复作品抽取结果
reset-work-extraction	重置作品抽取结果

4.3 知识与上下文

旧名	中文单名
assemble-context	准备任务上下文
embed-knowledge	生成知识向量
extract-chapter-knowledge	抽取章节知识
freeze-context	固定任务上下文
review-knowledge-cards	审核知识卡
search-knowledge	检索知识

4.4 概念设计

旧名	中文单名
concept-design	提炼故事概念
design-story-foundation	完善故事基础设定
merge-story-candidates	合并故事方案

4.5 结构规划

旧名	中文单名
foreshadow-payoff	铺设并回收伏笔
narrative-momentum	增强叙事动力
story-ending	设计故事结尾
story-planning	搭建故事蓝图
story-structure	搭建故事结构
plan-chapter	规划下一章
plan-story	制定作品规划

4.6 正文写作

旧名	中文单名
character-design	设计人物
character-presentation	呈现人物
dialogue-craft	打磨人物对话
narration-pov	选择叙述视角
prose-craft	打磨小说语言
scene-craft	打磨小说场景
show-and-omission	运用展示与留白
theme-and-stance	表达主题与立场
expand-scene	扩写场景
polish-prose	润色正文
rewrite-selection	重写选段
write-next-chapter	写下一章

4.7 检测、评分与诊断

旧名	中文单名
adjudicate-quality-gate	判定质量是否合格
check-content-consistency	核对内容一致性
evaluate-frozen-replay	回放评估细纲质量
load-replay-reference-work	准备正文回放数据
optimize-content-quality	分析质量短板
replay-writer-gate	回放评估正文质量
score-content-quality	评估内容质量
novel-diagnosis	诊断作品问题

4.8 中文人感

旧名	中文单名
capture-ai-flavor-cases	记录机器味案例
diagnose-ai-flavor	诊断机器味
establish-voice-baseline	建立作品声音档案
prevent-ai-flavor	预防机器味
promote-ai-flavor-rule	建立机器味规则
revise-ai-flavor	修正正文机器味

4.9 候选主权

旧名	中文单名
confirm-knowledge-draft	确认知识草稿
decide-candidate	决定正文候选去留

5. 作者指令层

5.1 定位

作者指令层只回答“作者现在要做什么”，不承载数据库写入、模型策略、质量裁决或正式内容合同。它根据自然语言选择正式技能，并把正式技能的结果翻译成作者可理解的交互。

目标结构：

.agent/作者/
├── 目录.md
├── 指令.md
├── 原生中文写作.md
└── 场景/
    ├── 定故事.md
    ├── 排故事.md
    ├── 塑人物.md
    ├── 写下一章.md
    ├── 改正文.md
    └── 查作品.md

作者入口 是 指令.md 提供的自然语言路由能力，不登记为正式技能。六个场景文件只描述意图识别、必要问题、交付物和交接关系，不复制下层 SKILL.md 的业务合同。

5.2 场景路由

作者场景	作者意图	正式技能范围	交付边界
定故事	把点子、素材或模糊方向变成可比较的长篇方案	提炼故事概念、完善故事基础设定、必要时 合并故事方案	只交付候选，不代替作者选择故事主心骨
排故事	做作品规划、结构、节拍、伏笔、结尾或单章细纲	搭建故事蓝图、搭建故事结构、增强叙事动力、铺设并回收伏笔、设计故事结尾、制定作品规划、规划下一章	规划先进入草稿态，确认后才能成为后续写作依据
塑人物	创建人物、补动机关系、区分人物声音和呈现方式	设计人物、呈现人物、打磨人物对话、选择叙述视角	不替作者决定人物命运、主题立场或重大关系转折
写下一章	按当前作品状态继续生成整章正文	预防机器味、准备任务上下文、固定任务上下文、写下一章、核对内容一致性、诊断机器味	产物始终是正文候选，必须经审查和作者确认才能进入正式正文
改正文	重写选段、加厚场景、修表达或按诊断修正机器味	在 重写选段、扩写场景、润色正文、修正正文机器味 中选择一个主修改入口，按需加载方法技能	只改作者指定范围；修改后仍是候选，原正式正文不被覆盖
查作品	定位结构、人物、事实、文字或机器味问题	诊断作品问题、核对内容一致性、评估内容质量、分析质量短板、诊断机器味	只诊断和分流，不自动修改正文或设定

5.3 交互合同

1. 作者可以直接说自然中文，不要求记忆入口名或正式技能名。
2. 系统优先从当前作品、已确认规划和历史决策中取事实，不让作者重复填写可查询信息。
3. 缺少关键决策时，一轮只问一个问题；非关键缺口使用明确假设并标注。
4. 路由不确定时，只给二至三个中文选项，不展示完整技能清单。
5. 输出先给作者请求的内容，再给必要且简短的状态说明。
6. 普通交互不展示运行编号、哈希、模型参数、数据库字段、内部英文标识或门禁实现细节。
7. 候选内容统一提供 采用、修改、丢弃 三个作者动作；具体写入仍由对应主权技能执行。
8. 诊断请求默认只查不改；修改请求不得顺带改动未授权范围。
9. 作者没有明确确认时，正文、规划和知识产物保持 Shadow，不进入 Canonical。
10. 作者要求“只给正文”时，只交付正文，不展示内部分析、路由过程或检查清单。

6. 原生中文写作合同

所有生成和修改正文的场景共同遵守：

• 按中文语序、信息重心和段落节奏组织文字，不把外语句法逐句替换成中文词语。
• 具体名词、动作和关系优先，抽象判断只在确有叙事功能时出现。
• 作者声音、叙述者声音和角色声音分别受约束，不用一套通用文风覆盖全书。
• 正式、口语、克制、夸张等语体由题材、人物、场景和已确认声音基线决定。
• 不凭空增加作者经历、人物背景、关键事实、固定口癖、感官细节或笑点。
• 不为模拟真人而随机加入错别字、残句、网络用语、口头禅和无功能的语病。
• 外国人名、作品内专有名词、模型名和必要外文可以保留；“全中文”约束作者交互与项目技能业务身份，不改写真实专名。
• 润色不得偷改情节事实，扩写不得新开场景或改变落点，重写不得越过作者指定范围。
• 去机器味必须建立在精确诊断上，不能把删连接词、强制短句或随机口语化当作统一修法。

7. 当前数据与历史数据

7.1 当前身份迁移

当前配置和可变业务数据中的技能身份必须迁为中文，包括技能登记、活动归属、当前角色绑定、当前链路配置和新运行默认值。

数据库迁移必须满足：

• 在事务内完成，任一冲突整体回滚。
• 迁移前检查 59 个目标名称无重名。
• 重跑不产生重复登记或二次改写。
• 迁移后旧英文名不能继续作为当前可调用身份。
• 行数、唯一约束、外键和当前绑定关系迁移前后可机械对账。

7.2 历史事实保留

不可变运行回执、raw、审计记录和历史证据保留当时真实写入的英文标识。看板可把它们显示为“历史标识”，但不得把历史值注册为运行时别名。

旧名到中文名的映射只允许存在于：

• 本规格的正式迁移表。
• 一次性数据迁移程序及其测试夹具。
• 不可变历史记录、raw 和审计证据。
• 明确登记的历史归档目录。

8. 实施顺序

8.1 校验支架

先让技能扫描、frontmatter 校验、索引生成、登记同步和评测加载支持中文单名，并把目录名与 name 一致性变成失败关闭的机械门禁。

skills.json.skill_name_policy 在迁移期间固定为 transitional；原子切换批次把它改为 chinese_only。静态支架、目录生成器和数据库登记同步必须读取同一个字段，任何一路仍接受英文活动身份都视为切换失败。

8.2 方法技能

迁移 15 个方法技能及其分类目录，更新方法目录索引、角色引用、方法间交接和 references/ 链接。包内文件名继续使用 SKILL.md。

8.3 编排技能

按平台底座、素材导入、知识上下文、概念规划、正文写作、质量人感和候选主权分批迁移 44 个编排技能。每批同时更新 manifest、功能链、脚本身份字符串、测试责任方和活跃合同链接。

8.4 当前数据

代码、文件路径和配置变更先构建并验证，但不在旧数据上单独启用。发布时进入停写窗口，在同一发布单元中先执行幂等数据迁移和混合状态预检，再启动只认中文名的新版本；任一步失败即回滚数据事务并恢复旧版本。不可变历史数据不参与更新。

8.5 作者指令层

建立作者目录、路由指令、六个场景文件和原生中文写作共同合同。作者层只引用迁移后的正式中文名。

8.6 残留收口

删除旧目录、旧索引和运行时兼容别名；安装旧英文技能名残留门禁。迁移表、历史归档和迁移测试夹具使用显式白名单，不接受模糊目录级放行。

8.7 替换覆盖与删除条件

删除只允许发生在新 owner 已落盘、入口可达且机械门通过之后。Git 历史只能追溯，不能代替当前运行期入口或门禁。

待替换内容	新 owner / 替代能力	删除前必须证明
创作周期与Skill导读.md 的手工 Skill 总表	.agent/skills/目录.md、muse/技能目录.md、skills.json 与各 SKILL.md	59 项名称、路径、生命周期、调用类型和说明均可从新 owner 重建，索引对账与链接门通过
导读中的 节点 × Skill 副本	muse/sot/domains/05-创作流程领域.md §2.4	规划、正文、章后三个节点的必用、可选和人授权入口均有唯一 owner
旧 .agent 根索引与 docs 跳转链	根 AGENTS.md、.agent/目录.md 及各一级目录的 目录.md	.agent 五个正式一级内容目录均有固定五列索引，旧索引活跃引用为零，Markdown 链接门通过
多处重复的技能命名规则	muse/sot/domains/07-Agent与Skill领域.md §3.1	功能规格和 .agent/规范 都指向唯一 owner，机械审查所需条款无遗漏，重复段落删除后语义不变
英文方法分类兼容项	.agent/skills/规划、.agent/skills/写作、.agent/skills/诊断	15 个方法技能、frontmatter、manifest、引用和分类索引全部迁为中文，旧分类目录零引用
一次性名称迁移器、数据库迁移盘点与迁移专用测试	中文-only 名称门、旧名残留门、正常 --check-db、迁移实现回顾	59 个活动身份与 source_ref 全为中文目标；旧名只存在于明确历史白名单；前后行数、哈希和不可变历史证明已写入 docs/实现回顾/

迁移工具的最后一行删除必须晚于实现回顾和永久门禁落盘；只完成目录改名或数据库同步，不构成删除授权。

9. 机械验收

9.1 身份与目录

• manifest 恰好登记 59 个正式技能，名称与路径均唯一。
• 59 个 name 与本规格中文映射逐项一致，无漏项、重名或额外项。
• 每个 SKILL.md 的父目录名等于 frontmatter name。
• 正式技能树仍只使用 SKILL.md，不存在 技能.md。
• .agents.local/skills/my-skills/ 不出现在本功能的变更中。
• .agent/skills/目录.md 与 muse/技能目录.md 的每个链接均可打开，并与 manifest 对账一致。

9.2 引用与运行

• 角色合同、功能链、调度配置和当前运行归属只引用中文技能名。
• 活跃代码和合同中不再出现旧英文技能身份；仅显式白名单位置可保留。
• 当前数据库技能登记和活动归属不存在旧英文名，新运行只写中文名。
• 不可变历史记录的数量、内容哈希和旧标识保持不变。
• 技能发现、调度和运行不依赖宿主原生技能自动扫描。

9.3 作者旅程

至少用一条机械化旅程验证：

自然中文点子
  → 定故事
  → 排故事
  → 写下一章
  → 查作品
  → 改正文
  → 采用或丢弃候选

旅程必须证明：

• 作者不使用内部技能名也能完成路由。
• 普通作者输出不出现旧英文技能名、结构字段和运行参数。
• 每轮最多提出一个关键问题。
• 查作品 不写正文，改正文 不越过指定范围。
• 未确认候选不进入 Canonical，采用动作仍经过正式主权技能。
• 正文默认满足原生中文写作合同。

9.4 工程验证

• 技能质量支架、索引对账、登记同步、架构测试和受影响技能测试通过。
• 数据迁移 dry-run 与正式迁移报告均可复核，并证明幂等。
• 旧名残留门禁能用故意注入的旧标识稳定报错。
• git diff --check 通过。

10. 失败与回退

• 任一批次出现名称冲突、断链、无法发现或数据对账失败时，该批不得进入下一批。
• 文件迁移与引用更新必须在同一变更批次完成，不允许主分支长期存在旧路径与新引用混合状态。
• 数据迁移失败时回滚事务，新版本不得启动，运行环境恢复到迁移前已验证的身份集合；不得写入半中文半英文的当前登记。
• 回退只能恢复完整批次，不能通过保留英文别名掩盖迁移缺口。
• 历史证据不得参与回退改写。