机制说明(全文)
数字员工编制与 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