智能体交接审议 wbj0256/dsh-agent-handoff-deliberation

DSH 智能体交接与审议

面向 DeepSeek Harness 集成的隐私优先协调原语。

1. 跨智能体任务交接：限定接收方的 queued → accepted → completed|blocked 状态流转，附带审计事件轨迹。
2. 多智能体审议 / 分歧：独立立场、直接反驳，以及拒绝虚假共识的决策门。

独立生态项目，并非 DeepSeek 官方产品。它遵循 DeepSeek Harness 的指引，以 dsh-plugin 话题发布生态项目。

范围

包含：有状态交接、独立立场、反驳、决策门、递归凭据脱敏、单元测试和 CI。

明确排除：互相教学、调度 / cron / 进程派生 / 自主派发、凭据存储或传输，以及服务商特定的模型调用。

安装

npm install @wbj0256/dsh-agent-handoff-deliberation

用法

import { HandoffLedger, DeliberationRoom } from '@wbj0256/dsh-agent-handoff-deliberation'

const handoffs = new HandoffLedger()
handoffs.create({ id: 'design-7', from: 'planner', to: 'builder', task: 'Implement the validated API contract.' })
handoffs.accept('design-7', 'builder')
handoffs.complete('design-7', 'builder', { artifact: 'commit reference' })

const debate = new DeliberationRoom()
debate.open('release-1', 'Release now?', ['builder', 'reviewer', 'lead'])
debate.position('release-1', 'builder', 'Release after tests.', ['unit tests passed'])
debate.position('release-1', 'reviewer', 'Hold for the abuse-case test.', ['threat model'])
debate.rebut('release-1', 'builder', 'reviewer', 'The boundary test covers this case.')
debate.decide('release-1', 'lead', 'Release only with boundary evidence recorded.')

Harness 适配器

apply(host) 针对一个极小的 host.tools.register() 接缝注册中立的工具定义。这样策略核心保持可测试，也避免耦合到不稳定的内部 API。部署适配器可以把这些定义映射到已安装的 DeepSeek Harness Cordis 和 defineTool 版本。

工具：handoff_create、handoff_accept、handoff_complete、deliberation_open、deliberation_position、deliberation_rebut 和 deliberation_decide。

安全

脱敏发生在载荷进入交接记录或审议记录之前。这是纵深防御，不是密钥管理：不要把凭据交给智能体或日志。本包默认不持久化任何内容。

开发

npm install
npm run check

MIT 许可。