数字员工深度审计与修复计划
姊妹文档:数字员工问题排查清单 — 全量真跑通的逐项排查与演示编排建议;本文侧重审计结论与修复优先级。
审计时间:2026-08-24
审计方法:自动扫描YAML定义 + worker文件真实逻辑分析 + 调度/协同配置检查
审计脚本:audit-staff.js
一、审计结果总览
| 维度 | 通过数 | 占比 | 说明 |
|---|---|---|---|
| 符合标准(定义完整) | 77 | 100% | id/name/title/description/worker/enabled/capabilities/item_types/keywords/kpi 齐全 |
| 能完成全流程(worker有真实逻辑) | 37 | 48% | worker文件存在 + 有execute函数 + 有return + 有真实依赖 + >30行 |
| 可进化/修复(有调度+真实逻辑) | 16 | 21% | 有cron/loop/goal配置 + worker有真实执行逻辑 |
| 可协同(有collaboration配置) | 14 | 18% | YAML中配置了onComplete/onTrigger/peers |
| 四项全通过(真正可用) | 4 | 5% | DS-BIZ-001 / DS-STOCK-001 / DS-ECR-001 / DS-STAT-001 |
二、问题分类与数量
问题1:Worker文件不存在(17个)
YAML定义了worker名称但文件根本不存在,调用时会报 MODULE_NOT_FOUND。
| 员工ID | worker名 | YAML描述 | 严重度 |
|--------|----------|----------|--------|
| DS-PRODUCT-001 | product | 产品助手 | P0 |
| DS-MALL-001 | mall | 商城助手 | P1 |
| DS-SCSAI-001 | (空) | 万能对象创建工程师 | P0 |
| DS-KBPIPE-001 | kb-pipeline | 行业知识库管道员 | P2 |
| DS-DOC-001 | doc | 文档校验员 | P1 |
| DS-LOOP-001 | auto-loop | 自主循环执行员 | P1 |
| DS-CS-001 | customer-service | 客服数字员工 | P2 |
| DS-QCC-001 | qcc | 质量控制协调员 | P0 |
| DS-CAPA-001 | capa | 纠正措施协调员 | P0 |
| DS-NCR-001 | ncr | 不合格品处理员 | P0 |
| DS-FMEA-001 | fmea | FMEA分析员 | P1 |
| DS-AUDIT-001 | audit | 体系审核员 | P1 |
| DS-SPC-001 | spc | 统计过程控制员 | P1 |
| DS-SCCAPP-DESIGN-001 | sccapp-design | 工艺设计员 | P1 |
| DS-SCCAPP-OPT-001 | sccapp-optimize | 工艺优化员 | P1 |
| DS-SCCAPP-SYNC-001 | sccapp-sync | 工艺同步员 | P1 |
| DS-SCCAPP-QBRIDGE-001 | sccapp-quality-bridge | 工艺质量桥接员 | P1 |
问题2:Worker是41行空壳骨架(19个)
文件存在但只有41行模板代码,9处TODO,无真实依赖,success: false,implemented: 'skeleton'。
| 员工ID | worker名 | YAML描述 | 业务领域 |
|--------|----------|----------|----------|
| DS-ASSET-001 | asset | 资产管理师 | 固定资产 |
| DS-BOM-001 | bom | BOM管理师 | 核心业务 |
| DS-COMP-001 | compliance | 合规审查师 | 合规 |
| DS-CONTRACT-001 | contract | 合同审查师 | 合同 |
| DS-ENERGY-001 | energy | 能源管理师 | 能源 |
| DS-FIN-001 | finance | 财务分析师 | 财务 |
| DS-HR-001 | hr | HR管理师 | 人力资源 |
| DS-INVOICE-001 | invoice | 发票处理师 | 财务 |
| DS-LOG-001 | logistics | 物流追踪师 | 物流 |
| DS-MEET-001 | meeting | 会议助理 | 行政 |
| DS-PROC-PLAN-001 | proc-plan | 采购计划师 | 采购 |
| DS-PROD-001 | production | 生产排程师 | 核心业务 |
| DS-QUALITY-001 | quality | 质量检验师 | 核心业务 |
| DS-RISK-001 | risk | 风险评估师 | 风险 |
| DS-SAFETY-001 | safety | 安全检查师 | 安全 |
| DS-SUP-AUDIT-001 | sup-audit | 供应商审计师 | 采购 |
| DS-TRAIN-001 | training | 培训管理师 | 人力资源 |
| DS-TRAVEL-001 | travel | 差旅管理师 | 行政 |
| DS-WH-001 | warehouse | 仓储管理师 | 核心业务 |
问题3:无调度配置——不能自主运行(49个)
没有cron/loop/goal配置,只能通过手动 runStaffOnce 触发,不会自动执行任何任务。
问题4:无协同配置——孤岛员工(63个)
没有collaboration配置,不能和其他员工协作,无法参与业务闭环。
问题5:Worker有TODO/FIXME标记(21个)
- 19个骨架worker:每个9-10处TODO
- DS-STOCK-001:6处TODO
- DS-KNOWLEDGE-001:2处TODO
三、修复计划(按ROI排序)
P0:核心业务闭环(预计修复后四项全通过 4→15)
#### P0-1:补齐4个核心缺失worker(文件不存在)
| 序号 | 员工 | worker | 需要做的 | 参考模板 | 预计行数 |
|------|------|--------|----------|----------|----------|
| 1 | DS-PRODUCT-001 | product.js | 产品CRUD+查询SCSAI Product | procurement.js | ~300行 |
| 2 | DS-SCSAI-001 | SCSAI-creator.js(已存在) | YAML worker字段修正为已存在的worker名 | — | 改YAML |
| 3 | DS-QCC-001 | qcc-worker.js | 质量控制协调:查询QCC数据+判定+触发纠正 | ecr-worker.js | ~250行 |
| 4 | DS-CAPA-001 | capa-worker.js | 纠正措施管理:创建CAPA+跟踪+验证关闭 | ecr-worker.js | ~250行 |
| 5 | DS-NCR-001 | ncr-worker.js | 不合格品处理:创建NCR+隔离+处置决策 | ecr-worker.js | ~250行 |
#### P0-2:填充4个核心空壳worker(41行→真实逻辑)
| 序号 | 员工 | worker | 需要做的 | 参考模板 | 预计行数 |
|------|------|--------|----------|----------|----------|
| 6 | DS-BOM-001 | bom.js | BOM查询+校验+Where-Used | ecr-worker.js + SCSAI-client | ~300行 |
| 7 | DS-PROD-001 | production.js | 生产订单查询+排程+状态更新 | ecr-worker.js | ~280行 |
| 8 | DS-QUALITY-001 | quality.js | 质量检验记录+判定+触发NCR | ecr-worker.js | ~280行 |
| 9 | DS-WH-001 | warehouse.js | 库存查询+出入库+预警 | stock-manager.js | ~300行 |
#### P0-3:为核心员工加调度+协同配置
- 给上述9个员工加
cron配置(定时巡检/同步) - 给上述9个员工加
collaboration.onComplete配置(串联业务闭环) - 例如:DS-QUALITY-001发现不合格 → 触发DS-NCR-001创建NCR → 触发DS-CAPA-001创建纠正措施
P1:质量管理+工艺闭环(预计修复后四项全通过 15→25)
#### P1-1:补齐6个质量/工艺缺失worker
| 序号 | 员工 | worker | 需要做的 |
|------|------|--------|----------|
| 10 | DS-FMEA-001 | fmea-worker.js | FMEA分析:失效模式+风险优先数+建议 |
| 11 | DS-SPC-001 | spc-worker.js | SPC控制:过程数据+控制图+异常判定 |
| 12 | DS-AUDIT-001 | audit-worker.js | 体系审核:审核计划+检查单+不符合项 |
| 13 | DS-SCCAPP-DESIGN-001 | sccapp-design-worker.js | 工艺设计:工序+工步+参数 |
| 14 | DS-SCCAPP-OPT-001 | sccapp-optimize-worker.js | 工艺优化:参数优化+效率分析 |
| 15 | DS-SCCAPP-SYNC-001 | sccapp-sync-worker.js | 工艺同步:SCSAI↔SCCAPP数据同步 |
#### P1-2:补齐3个文档/客服缺失worker
| 序号 | 员工 | worker | 需要做的 |
|------|------|--------|----------|
| 16 | DS-DOC-001 | doc-worker.js(已存在) | YAML worker字段修正为 doc-worker |
| 17 | DS-LOOP-001 | auto-loop-worker.js(已存在) | YAML worker字段修正为 auto-loop-worker |
| 18 | DS-CS-001 | customer-service-worker.js(已存在) | YAML worker字段修正为 customer-service-worker |
P2:职能部门员工(预计修复后四项全通过 25→40)
#### P2-1:填充15个职能空壳worker
这些worker的业务逻辑相对简单(主要是CRUD+查询+报表),可以用统一模板批量生成:
| 序号 | 员工 | worker | 核心逻辑 |
|------|------|--------|----------|
| 19 | DS-PROC-PLAN-001 | proc-plan.js | 采购计划:需求汇总+供应商匹配+计划生成 |
| 20 | DS-SUP-AUDIT-001 | sup-audit.js | 供应商审计:审计计划+评分+整改跟踪 |
| 21 | DS-FIN-001 | finance.js | 财务分析:成本统计+预算对比+预警 |
| 22 | DS-INVOICE-001 | invoice.js | 发票处理:发票识别+校验+入账 |
| 23 | DS-HR-001 | hr.js | HR管理:人员信息+考勤+绩效 |
| 24 | DS-TRAIN-001 | training.js | 培训管理:培训计划+记录+证书跟踪 |
| 25 | DS-CONTRACT-001 | contract.js | 合同审查:合同录入+条款审查+到期预警 |
| 26 | DS-COMP-001 | compliance.js | 合规审查:合规检查+违规记录+整改 |
| 27 | DS-RISK-001 | risk.js | 风险评估:风险识别+评估+应对措施 |
| 28 | DS-SAFETY-001 | safety.js | 安全检查:安全巡检+隐患+整改 |
| 29 | DS-ENERGY-001 | energy.js | 能源管理:能耗统计+分析+节能建议 |
| 30 | DS-LOG-001 | logistics.js | 物流追踪:物流状态+时效+异常 |
| 31 | DS-MEET-001 | meeting.js | 会议助理:会议安排+纪要+待办跟踪 |
| 32 | DS-TRAVEL-001 | travel.js | 差旅管理:差旅申请+审批+报销 |
| 33 | DS-ASSET-001 | asset.js | 资产管理:台账+折旧+盘点 |
P3:基础能力+协同链路(预计修复后四项全通过 40→55)
#### P3-1:修复4个基础能力worker(无真实依赖)
| 序号 | 员工 | worker | 问题 |
|------|------|--------|------|
| 34 | DS-IDENTIFY-001 | identify.js | 97行但无真实依赖,需接入SCSAI查询 |
| 35 | DS-REPAIR-001 | repair.js | 87行但无真实依赖,需接入数据修复逻辑 |
| 36 | DS-COMPARE-001 | compare.js | 98行但无真实依赖,需接入数据比对 |
| 37 | DS-PROCESS-OPT-001 | process-optimizer.js | 91行但无真实依赖,需接入工艺优化 |
#### P3-2:给49个无调度员工加cron配置
按业务需求添加定时巡检/同步/报表生成cron表达式。
#### P3-3:给63个无协同员工加collaboration配置
按业务闭环串联:
- 采购闭环:PROC→VEN→COST→ECR
- 质量闭环:QUALITY→NCR→CAPA→FMEA
- 工艺闭环:SCCAPP-DESIGN→SCCAPP-OPT→SCCAPP-SYNC
- 生产闭环:PROD→QUALITY→LOG→WH
P4:行业扩展+边缘员工(预计修复后四项全通过 55→70+)
#### P4-1:补齐剩余缺失worker
| 序号 | 员工 | worker |
|------|------|--------|
| 34 | DS-MALL-001 | mall-worker.js(已存在) → YAML修正 |
| 35 | DS-KBPIPE-001 | kb-pipeline-worker.js(已存在) → YAML修正 |
| 36 | DS-SCCAPP-QBRIDGE-001 | sccapp-quality-bridge-worker.js(已存在) → YAML修正 |
四、修复策略
策略1:YAML worker名修正(零代码,最快见效)
6个员工的worker文件其实已存在,只是YAML中名字不对:
- DS-SCSAI-001: worker为空 → 改为
SCSAI-creator - DS-DOC-001:
doc→doc-worker - DS-LOOP-001:
auto-loop→auto-loop-worker - DS-CS-001:
customer-service→customer-service-worker - DS-MALL-001:
mall→mall-worker - DS-KBPIPE-001:
kb-pipeline→kb-pipeline-worker - DS-SCCAPP-QBRIDGE-001:
sccapp-quality-bridge→sccapp-quality-bridge-worker
策略2:空壳worker填充(中等代码量,高ROI)
19个空壳worker可用统一模板填充:
- require SCSAI-client 查询真实数据
- require sqlite-compat 读写本地DB
- 实现CRUD + 查询 + 报表生成
- 接入staffLog记录执行日志
- 返回结构化结果
策略3:缺失worker新建(高代码量,按业务优先级)
11个真正缺失的worker需要从零编写,按P0→P1→P2优先级逐步完成。
策略4:批量加调度+协同配置(低代码量,高覆盖)
- cron配置:按业务需求添加定时表达式
- collaboration配置:按业务闭环串联onComplete
五、预期效果
| 阶段 | 修复内容 | 四项全通过数 | 占比 |
|---|---|---|---|
| 当前 | — | 4 | 5% |
| P0完成 | 核心业务闭环 | ~15 | 19% |
| P1完成 | 质量管理闭环 | ~25 | 32% |
| P2完成 | 职能部门 | ~40 | 52% |
| P3完成 | 基础能力+协同 | ~55 | 71% |
| P4完成 | 行业扩展 | ~70+ | 90%+ |
六、风险与注意事项
- YAML是唯一定义源:所有修改改YAML重启即生效,不手改DB
- 空壳worker的"诚实化"原则:当前骨架返回
success: false,填充真实逻辑后改为success: true - SCSAI连接依赖:部分worker依赖SCSAI服务器(ylxt.chat),网络不通时会降级
- BOSS_SCHEDULER_CRON=off:当前环境cron关闭,加cron配置后需要改为on才自动执行
- 协同链路测试:加collaboration配置后需要端到端测试,确保onComplete触发正确
BossAgents