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

42 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 术语规范
全仓执行纯中文单名制,杜绝“中文名 + 英文 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、括号英文标注或未经统一度量衡的英文术语,静态门禁判定为阻断项,直接拒绝合并。