0260bcd8e2
- 新版设计各域 SoT 按本轮实现同步：总体架构、模块设计、接口契约、数据模型、功能规格、文件设计与决策记录。 - 接口契约生成物重新导出（openapi 与前端客户端随契约一致）。 - 实现回顾与专项检查台账保留历史结论；本轮收尾发现另见 .agents.local 下的收尾报告与审查处置。
56 lines
5.7 KiB
Markdown
56 lines
5.7 KiB
Markdown
<!-- 导航元信息: {"内容描述": "编排与能力资源", "使用场景": "设计、实现或评审对应主题", "使用要求": "与阅读指南的主题权威分工一致"} -->
|
||
# 编排与能力资源
|
||
|
||
## 各层职责
|
||
|
||
主会话理解作者意图、解释选择、发起已授权动作并关联任务。Skill 描述方法或操作，不保存业务账本。角色执行固定职责；工具执行受范围约束的确定性读取。编排决定步骤顺序，S02 负责可靠执行。正式内容由所属模块经 S01 写入。
|
||
|
||
## 五类角色
|
||
|
||
| 角色 | 输入 | 输出 | 工具 |
|
||
|------|------|------|------|
|
||
| 规划员 | 作者意图、允许事实、方法和规划结构 | 规划候选 | 任务许可的只读探索 |
|
||
| 写手 | 确认规划、固定上下文与正文任务 | 正文候选 | 探索阶段受限；生成阶段无工具 |
|
||
| 知识抽取员 | 固定来源、有效类型与字段结构 | 分析或事实增量提案 | 任务允许的证据回读 |
|
||
| 检测员 | 候选、固定证据与检查合同 | 具名问题、引文和不确定项 | 允许证据回读 |
|
||
| 评委 | 固定评价条件、匿名候选及可用证据 | 逐维判断、成对结果和分歧 | 不得读取被隔离身份与答案 |
|
||
|
||
规划与写手保持原单模型要求，评委使用[角色合同](../../../.agent/角色/角色合同.md)的独立精确白名单。允许模型、能力、回退条件、工具模式与预算在角色策略定义，任务固定实际版本。角色不可自行更换冻结模型或增开工具。
|
||
|
||
## 流程定义与开放槽位
|
||
|
||
流程定义记录 flow_id、version、步骤及依赖、处理器身份、角色槽位、输入输出合同、检查点、预算和允许的停止条件。模板在配置目录，已发布的流程版本和实际任务绑定持久化。
|
||
|
||
节点只能引用代码登记的处理器；槽位替换验证输出结构、工具许可、角色能力和失败语义。输入校验、来源裁剪、证据保存、正式提交与必要检查是保护节点，任何合法流程路径都必须经过适用保护，不能通过跳边绕过。
|
||
|
||
流程选择、角色替换和预算参数可以配置；新增业务行为要实现并登记处理器。S02 不动态执行来自文件路径或模型文本的任意脚本。
|
||
|
||
## 两阶段写手
|
||
|
||
B05 形成写作目标和保护范围，B09 预组装来源；探索阶段使用绑定任务身份的只读工具并记录真实消费。随后冻结与确定性回放，生成阶段仅使用固定文本和结构、关闭工具。输出保存为候选，再由适用检查和作者决定处理。
|
||
|
||
范围校验覆盖预组装、探索、回放、复核和采纳；不能让工具中的作品号或 as_of 参数扩大服务器范围。
|
||
|
||
## 资源声明与发布
|
||
|
||
Skill 的稳定身份、中文名称、分类和业务命令由其 frontmatter 声明；目录和发布清单从这一来源生成。角色提示只定义角色职责，业务提示模板放在所属模块。两者通过具名输入装配，不复制结构字段正文；动态字段合同从固定 Schema 渲染。
|
||
|
||
Git 中的 Skill、角色、模板、策略和内置结构属于构建输入。发布清单记录代码版本、资源身份、文件哈希、合同版本与构建身份。安装包包含必要资源，实际任务保存其发布身份。更新资源先形成可审具体变更，再评测同一版本；批准发布后才供新任务选择。
|
||
|
||
角色、Skill、流程与类型 ID 不依赖中文展示名或物理目录。移动 Skill 不改变 Python 导入；生产运行不读取 tests 或未审工作树。
|
||
|
||
能力声明使用 frontmatter 的 `id`、中文 `name`、`category`、`contract_version` 与 `description`；操作技能还声明实际公开入口的 `commands`。构建只读取资源登记中的能力文件，生成稳定身份到包内路径、正文哈希和命令的目录；未实现命令与重复身份阻止构建。角色显示名以角色资源为准，模型和工具权限仍只归角色策略配置。
|
||
|
||
发布清单中的可读发布标签不代替内容身份。`构建身份`覆盖代码哈希、资源哈希、包版本和合同版本；模型任务冻结该构建身份，执行器不使用另一个构建自动接续。角色正文按目录中的固定哈希读取，模板装配只取执行正文，不把frontmatter、历史记录或工作树路径作为模型指令。
|
||
|
||
Pi 宿主适配拆为 `src/muse/基础设施/宿主/Pi.py`、`Pi事件归一.py` 与 `Pi工具桥.ts`：分别管理进程、纯事件转换和工具注册转交。工具桥随运行资源发布，依赖匹配的受控宿主版本，通过已安装的具名工具入口调用后端，不把旧脚本绝对路径写入运行配置。宿主版本兼容由构建和环境预检核对，桥接 SDK 不成为前端工作台依赖。
|
||
|
||
要求工具的任务在桥接加载或工具登记失败时拒绝执行；明确禁用工具的生成阶段正常不注册工具。协议细节限于基础设施，标准执行请求、事件和结果由 S02 定义。具体边界见[基础设施文件设计](文件设计/后端-基础设施.md)。
|
||
|
||
## 失败与恢复
|
||
|
||
缺必需资源、哈希不一致、槽位不兼容或保护节点缺失时拒绝建立可执行版本。运行资源可以历史回查，但当前授权和停用策略仍生效。资源发布失败不能把提案标为已启用；模型调用失败按 S02 保留状态与证据。
|
||
|
||
|
||
Pi 的扩展生命周期通知不作为预算拒绝点。模型提供方由 S02 受控调用入口承接，Pi 与直接调用共用预留、外发许可、原文授权、终态与结算；Pi 工具桥只转交任务范围内的具名只读调用。宿主配置显式固定 Node/CLI 位置及版本，使用独立配置目录并关闭自动重试、自动压缩和资源自动发现，防止产生未登记模型调用。
|