AIDAWORK / ARCHITECTURE

数字员工与 Skill 边界

独立图页 ↗
机制说明(SoT)图是辅读 · 结论以说明与证据为准

/digital-employees 管理入口可按租户登记、启停岗位并做准备度排查,但不新建子 Agent。产品放行常量 DIGITAL_EMPLOYEE_RELEASE 当前 workerConnected=false、sourceWritesReleased=false,准备度合成 canExecute=false。写意图在 admitDigitalEmployeeTurn 上还会因 source_writes_not_released 失败;租户 writeEnabled 不能绕过产品门。

本页可直接往下读完整机制说明,不需要「演示 / 播放故事」。术语不熟先看 术语表。

先读机制说明,结论以说明与证据为准 · 基于固定代码版本核验 · 部署状态另行确认

机制说明(全文)

数字员工编制与 Skill 边界

管理面已有,执行放行未齐

/digital-employees 管理入口可按租户登记、启停岗位并做准备度排查,但不新建子 Agent。产品放行常量 DIGITAL_EMPLOYEE_RELEASE 当前 workerConnected=false、sourceWritesReleased=false,准备度合成 canExecute=false。写意图在 admitDigitalEmployeeTurn 上还会因 source_writes_not_released 失败;租户 writeEnabled 不能绕过产品门。

User Skill 与 Bundled Skill

Bundled Skill 走 agents.skill_ids / SkillCache,进入 skill-context。钉点 Agent e2adc9a3c325 删除了 User Skill delegated-run(src/user-skills/ 只剩 canonical-hash / context-safety / skill-mention 三个文件)、workflow-runtime、/api/user-skills/interactions/* 与 attendance-rule-onboarding 垂直(ADR-0090 D2),独立的 user-skill-context 提示段随之删除;Desktop 侧 Full access / Trusted host User Skill 运行时也已删除,个人 Skill 只经 runSkillScript 执行。带旧绑定的历史 Work 结算时一次性停到 manual_recovery(RUNTIME_WORK_RETIRED_SKILL_BINDING)。记忆门控(memoryEnabled → strip recall/extractor)属于 Orchestrator 依赖装配,与数字员工放行门分开判断,不能把「记忆关闭」理解成 DE 已可写源系统。

个人 Skill 管理工具(2026-10-13 钉点)

四个工具 list_skills / inspect_skill / prepare_skill_change / apply_skill_change 定义在 tool-client(Desktop 为生成副本);Desktop 协议 v3 起不再有 desktop.user_skill_management.v1 capability token。Desktop Main 只有注册了 skillManagementToolHandler 才把四个 primitive 放进 supportedPrimitives;Agent 以 isDesktopSkillManagementAdvertised(四个都在)决定注册,remove 是否可用看 capabilities.skillManagement.changeKinds。prepare_skill_change 只产出预览与 changeId,不是批准;apply_skill_change 为受控写,须用户在 Desktop 对话框确认,安装回执才确立后续 Run 的活动版本,执行信任另由用户授予。

Skill 脚本契约(Agent ADR-0090 D3 / Desktop ADR-0086)

runSkillScript 是唯一脚本入口;入口 ABI 为 aida-json-file-v1 或 aida-argv-v1(Codex 风格无描述文件的包在安装时合成 argv 入口),catalog 条目带 abi 与 source: declared | synthesized,platforms 枚举加入 linux。

  • aida-agent · packages/tool-client/src/types/skill-script.ts L12–17 · SKILL_SCRIPT_ARGV_ABI · e2adc9a3c325
  • aida-agent · packages/tool-client/src/types/skill-script.ts L487–495 · synthesized · e2adc9a3c325
  • aida-agent · docs/adr/0090-desktop-protocol-v3-and-retired-local-primitives.md L21–27 · delegated-run · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/work/run-work-control.ts L3101–3127 · RUNTIME_WORK_RETIRED_SKILL_BINDING · e2adc9a3c325
  • aida-desktop · docs/adr/0086-codex-skill-scripts-run-through-an-argv-abi.md L19–23 · aida-argv-v1 · 4346d79eb364

证据与范围

  • aida-agent · docs/architecture/digital-employee-admin.md L1–29 · 77fe76838aa4(历史引用:该文档已在 aida-agent 44d63e20 退役,钉点 e2adc9a3c325 无此文件;见 ATLAS-DEBT)
  • aida-agent · packages/agent/src/digital-employee/readiness.ts L6–36 · DIGITAL_EMPLOYEE_RELEASE · e2adc9a3c325
  • aida-agent · packages/agent/src/digital-employee/admission.ts L90–120 · admitDigitalEmployeeTurn · e2adc9a3c325
  • aida-agent · docs/architecture/prompt-system.md L77–99 · 77fe76838aa4(历史引用:该文档已在 aida-agent 44d63e20 退役,钉点 e2adc9a3c325 无此文件;见 ATLAS-DEBT)
  • aida-agent · packages/agent/src/prompt/assembler.ts L27–50 · skill-context · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/orchestrator-runtime.ts L278–308 · composeDeps · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

  • aida-agent · packages/tool-client/src/types/skill-management.ts L3–18 · DESKTOP_SKILL_MANAGEMENT_TOOL_NAMES · e2adc9a3c325
  • aida-desktop · apps/desktop/electron/local-executor/local-execution-gateway.ts L368–397 · skillManagementToolHandler · 4346d79eb364
  • aida-agent · packages/agent/src/gateway/local-executor.ts L456–475 · apply_skill_change · e2adc9a3c325

机制说明

数字员工编制与 Skill 边界

管理面已有,执行放行未齐

/digital-employees 管理入口可按租户登记、启停岗位并做准备度排查,但不新建子 Agent。产品放行常量 DIGITAL_EMPLOYEE_RELEASE 当前 workerConnected=false、sourceWritesReleased=false,准备度合成 canExecute=false。写意图在 admitDigitalEmployeeTurn 上还会因 source_writes_not_released 失败;租户 writeEnabled 不能绕过产品门。

User Skill 与 Bundled Skill

Bundled Skill 走 agents.skill_ids / SkillCache,进入 skill-context。钉点 Agent e2adc9a3c325 删除了 User Skill delegated-run(src/user-skills/ 只剩 canonical-hash / context-safety / skill-mention 三个文件)、workflow-runtime、/api/user-skills/interactions/* 与 attendance-rule-onboarding 垂直(ADR-0090 D2),独立的 user-skill-context 提示段随之删除;Desktop 侧 Full access / Trusted host User Skill 运行时也已删除,个人 Skill 只经 runSkillScript 执行。带旧绑定的历史 Work 结算时一次性停到 manual_recovery(RUNTIME_WORK_RETIRED_SKILL_BINDING)。记忆门控(memoryEnabled → strip recall/extractor)属于 Orchestrator 依赖装配,与数字员工放行门分开判断,不能把「记忆关闭」理解成 DE 已可写源系统。

个人 Skill 管理工具(2026-10-13 钉点)

四个工具 list_skills / inspect_skill / prepare_skill_change / apply_skill_change 定义在 tool-client(Desktop 为生成副本);Desktop 协议 v3 起不再有 desktop.user_skill_management.v1 capability token。Desktop Main 只有注册了 skillManagementToolHandler 才把四个 primitive 放进 supportedPrimitives;Agent 以 isDesktopSkillManagementAdvertised(四个都在)决定注册,remove 是否可用看 capabilities.skillManagement.changeKinds。prepare_skill_change 只产出预览与 changeId,不是批准;apply_skill_change 为受控写,须用户在 Desktop 对话框确认,安装回执才确立后续 Run 的活动版本,执行信任另由用户授予。

Skill 脚本契约(Agent ADR-0090 D3 / Desktop ADR-0086)

runSkillScript 是唯一脚本入口;入口 ABI 为 aida-json-file-v1 或 aida-argv-v1(Codex 风格无描述文件的包在安装时合成 argv 入口),catalog 条目带 abi 与 source: declared | synthesized,platforms 枚举加入 linux。

  • aida-agent · packages/tool-client/src/types/skill-script.ts L12–17 · SKILL_SCRIPT_ARGV_ABI · e2adc9a3c325
  • aida-agent · packages/tool-client/src/types/skill-script.ts L487–495 · synthesized · e2adc9a3c325
  • aida-agent · docs/adr/0090-desktop-protocol-v3-and-retired-local-primitives.md L21–27 · delegated-run · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/work/run-work-control.ts L3101–3127 · RUNTIME_WORK_RETIRED_SKILL_BINDING · e2adc9a3c325
  • aida-desktop · docs/adr/0086-codex-skill-scripts-run-through-an-argv-abi.md L19–23 · aida-argv-v1 · 4346d79eb364

证据与范围

  • aida-agent · docs/architecture/digital-employee-admin.md L1–29 · 77fe76838aa4(历史引用:该文档已在 aida-agent 44d63e20 退役,钉点 e2adc9a3c325 无此文件;见 ATLAS-DEBT)
  • aida-agent · packages/agent/src/digital-employee/readiness.ts L6–36 · DIGITAL_EMPLOYEE_RELEASE · e2adc9a3c325
  • aida-agent · packages/agent/src/digital-employee/admission.ts L90–120 · admitDigitalEmployeeTurn · e2adc9a3c325
  • aida-agent · docs/architecture/prompt-system.md L77–99 · 77fe76838aa4(历史引用:该文档已在 aida-agent 44d63e20 退役,钉点 e2adc9a3c325 无此文件;见 ATLAS-DEBT)
  • aida-agent · packages/agent/src/prompt/assembler.ts L27–50 · skill-context · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/orchestrator-runtime.ts L278–308 · composeDeps · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

  • aida-agent · packages/tool-client/src/types/skill-management.ts L3–18 · DESKTOP_SKILL_MANAGEMENT_TOOL_NAMES · e2adc9a3c325
  • aida-desktop · apps/desktop/electron/local-executor/local-execution-gateway.ts L368–397 · skillManagementToolHandler · 4346d79eb364
  • aida-agent · packages/agent/src/gateway/local-executor.ts L456–475 · apply_skill_change · e2adc9a3c325

代码证据

引用核验检查固定 commit 的文件与范围;实现结论来自代码阅读。自动检查不证明生产环境已启用。

已核验实现

DIGITAL_EMPLOYEE_RELEASE 当前 workerConnected=false、sourceWritesReleased=false;准备度合成 canExecute=false,写意图会被 source_writes_not_released 拒绝。管理面存在不代表执行链路已放行。

aida-agentpackages/agent/src/digital-employee/readiness.ts:6–367f2e519936b57902d4907ed8026fe1ecdd146e82符号:DIGITAL_EMPLOYEE_RELEASE
aida-agentpackages/agent/src/digital-employee/admission.ts:118–1467f2e519936b57902d4907ed8026fe1ecdd146e82符号:sourceWritesReleased
aida-agentpackages/agent/src/digital-employee/readiness.ts:6–367f2e519936b57902d4907ed8026fe1ecdd146e82符号:DIGITAL_EMPLOYEE_RELEASE
已核验实现

Bundled Skill 走 agents.skill_ids/SkillCache 进入 skill-context;独立的 user-skill-context 段已随 User Skill delegated-run 一起删除,system prompt 只剩 agent-instructions / tool-behavior-guide / write-tool-catalog / skill-context / extra-system-message / runtime-info。

aida-agentpackages/agent/src/prompt/assembler.ts:27–507f2e519936b57902d4907ed8026fe1ecdd146e82符号:skill-context
aida-agentpackages/agent/src/prompt/assembler.ts:41–657f2e519936b57902d4907ed8026fe1ecdd146e82符号:assembleSystemPrompt
已核验实现

Orchestrator composeDeps 的 memoryEnabled 门控剥离 recall/extractor,与数字员工产品放行门分开;不能把记忆关闭路径等同于 DE 源系统写入已放行。

aida-agentpackages/agent/src/gateway/orchestrator-runtime.ts:320–3507f2e519936b57902d4907ed8026fe1ecdd146e82符号:composeDeps
已核验实现

普通 Skill 与业务任务受理的拆分仍在 run-work-admission,但 userSkillBinding 已删除:bindAdmittedWork 的 skill_bound 只看 continuation_context 是否含 businessTaskBinding;带旧 Full-access User Skill 绑定的历史 Work 在结算时一次性停到 manual_recovery(RUNTIME_WORK_RETIRED_SKILL_BINDING),不再重驱。

aida-agentpackages/agent/src/runtime/work/run-work-admission.ts:51–927f2e519936b57902d4907ed8026fe1ecdd146e82符号:skill_bound
aida-agentpackages/agent/src/runtime/work/run-work-control.ts:4749–47757f2e519936b57902d4907ed8026fe1ecdd146e82符号:RUNTIME_WORK_RETIRED_SKILL_BINDING
已核验实现

个人 Skill 管理:tool-client 定义 list_skills / inspect_skill / prepare_skill_change / apply_skill_change 四个工具(Desktop 为生成副本),不再有 desktop.user_skill_management.v1 capability token;Desktop Main 只在注册了 skillManagementToolHandler 时把四个 primitive 放进 supportedPrimitives,Agent 以 isDesktopSkillManagementAdvertised(四个都在)决定注册;apply_skill_change 为受控写,须 Desktop 对话框确认,安装回执才确立后续 Run 的活动版本。

aida-agentpackages/tool-client/src/types/skill-management.ts:7–227f2e519936b57902d4907ed8026fe1ecdd146e82符号:DESKTOP_SKILL_MANAGEMENT_TOOL_NAMES
aida-desktopapps/desktop/shared/generated/skill-management-contract.ts:4–94346d79eb36402355e51118df0edf1f98586880c符号:DESKTOP_SKILL_MANAGEMENT_TOOL_NAMES
aida-desktopapps/desktop/electron/local-executor/local-execution-gateway.ts:384–4134346d79eb36402355e51118df0edf1f98586880c符号:skillManagementToolHandler
aida-agentpackages/agent/src/gateway/local-executor.ts:494–5137f2e519936b57902d4907ed8026fe1ecdd146e82符号:apply_skill_change
aida-agentpackages/agent/src/gateway/local-executor-schemas.ts:32–377f2e519936b57902d4907ed8026fe1ecdd146e82符号:isDesktopSkillManagementAdvertised
已核验实现

Skill 脚本契约(ADR-0090 D3 / Desktop ADR-0086):入口 ABI 为 aida-json-file-v1 或 aida-argv-v1,catalog 条目带 abi 与 source(declared | synthesized),platforms 枚举加入 linux;User Skill delegated-run、workflow-runtime 与 attendance-rule-onboarding 垂直已在 Agent 删除(ADR-0090 D2)。

aida-agentpackages/tool-client/src/types/skill-script.ts:16–217f2e519936b57902d4907ed8026fe1ecdd146e82符号:SKILL_SCRIPT_ARGV_ABI
aida-agentpackages/tool-client/src/types/skill-script.ts:500–5087f2e519936b57902d4907ed8026fe1ecdd146e82符号:source: z.enum(["declared", "synthesized"])
aida-agentdocs/adr/0090-desktop-protocol-v3-and-retired-local-primitives.md:21–237f2e519936b57902d4907ed8026fe1ecdd146e82符号:delegated-run