muse-agent-example/.agent/规范/术语规范.md

术语规范

全仓执行纯中文单名制，杜绝“中文名 + 英文 ID”双轨歧义。

1. 核心术语对照

原英文 / 混杂术语	标准中文术语	范畴说明
Agent	智能体	具备自主判断与行动能力的独立执行单元
Role	角色	智能体在创作体系中的分工身份（写手、规划、检测、裁判、抽取）
Skill	技能	封装具体能力的业务或方法单元
Prompt	提示词	注入智能体的身份、指令与上下文说明
Harness	校验支架	静态门禁与结构质量审计工具
Raw (prompt/response/supplier)	原始凭证 (输入/输出/供应商)	数据库内不可变的调用现场留存数据
Profile	执行档案	任务执行的冻结参数配置
Receipt	执行回执	任务执行后的状态与哈希记录
Schema	结构契约	数据结构、字段定义与校验规范
Trace / Provenance	留痕溯源	历史变更、依赖来源与审计链条
Shadow Candidate	影子候选	待审查、未进入正典的临时产物
Canonical	正典事实	用户已确认、入库生效的唯一权威数据
Oracle	标准参照	评测中作为对照基准的数据
CAS (Compare-And-Swap)	原子比对更新	基于版本哈希的并发防护机制
Stop Ladder	决策阶梯	遇到阻断条件立即停止、不越权脑补的因果阶梯

2. 三位一体单名制

1. 同名统一：目录名、配置元数据 name 与正文自称完全统一为中文，不设英文别名。
2. 角色单名：
   • 写手（禁止命名为 writer）
   • 规划（禁止命名为 planner）
   • 检测（禁止命名为 detector）
   • 裁判（禁止命名为 judge）
   • 抽取（禁止命名为 extractor）
3. 技能单名：
   • 引用技能时一律使用反引号单名（如 `章级细纲`、`生成下一章`、`一致性检测`）。
   • 禁止在指令正文中添加括号英文备注（如禁止写成 生成下一章 (write-next-chapter)）。

3. 命名纪律与违规后果

• 禁止英文缩写夹杂：正文表述禁止出现混杂英文名词（如“调用 LLM 生成 candidate”必须写为“调用内容模型生成正文候选”）。
• 违规判定：凡在提示词、指令集或正文文档中发现中英双轨 ID、括号英文标注或未经统一度量衡的英文术语，静态门禁判定为阻断项，直接拒绝合并。