前言¶
在 DeepSeek Harness (DSH) 的插件生态中，工作流管理是提升智能体可靠性的关键。智能体往往倾向于在未完全达成目标时提前声明完成，导致产出不符合预期。goal-acceptance 插件通过引入验收标准驱动机制，在任务开始前锁定不可变的验收条件，并在执行过程中强制验证，从而避免这种“自卖自夸”的行为。
插件定位¶
goal-acceptance 是一个验收标准驱动的智能体目标完成工具，包含核心库、MCP 服务器和 DeepSeek Harness (DSH) 的 Cordis 插件。
- 核心价值：锁定不可变的验收标准，强制执行完成检查，支持依赖顺序与任务分解。
- 维护者：cckyros。
- 许可证：MIT。
核心能力¶
验收标准驱动¶
插件在智能体开始工作前锁定验收标准，并在工作过程中持续跟踪验证状态。它支持将验收标准与任务进度关联，并强制执行完成检查。
双重角色验证¶
插件提供 agent、reviewer、dual 三种角色配置。当使用 agent 角色时，智能体自行验证的标准会被标记为 selfClaimed=true，系统会阻止目标完成，直到有独立的评审者进行确认。这种机制打破了智能体既执行任务又自行评分的闭环。
类型化证据¶
插件支持四种类型的证据：command（命令执行结果）、file（文件内容）、url（链接内容）和 text（文本）。text 类型的证据会被标记为 lowConfidence=true，以便评审者快速识别主观性描述。
任务分解与依赖¶
智能体可以将目标分解为原子任务，每个任务包含明确的交付物。插件会验证任务 ID 的唯一性、描述的清晰度、交付物的非空性，以及依赖关系的有效性（无循环依赖、无未知依赖）。
跨平台兼容¶
该插件提供统一的安装入口，支持 22 个不同的智能体平台和运行时环境。对于 DSH 用户，它以 Cordis 插件形式运行。
事件溯源与持久化¶
所有状态变更采用事件溯源方式记录。如果配置了 PLUGIN_DATA 环境变量，状态将持久化到文件，支持跨重启恢复；否则状态仅存在于内存中。
安装与启用¶
前置要求¶
- Node.js 版本 >= 18。
安装命令¶
在 DSH 环境中安装该插件：
node dist/cli.js install --target dsh
使用方式¶
MCP 服务器模式¶
如果需要在其他 MCP 客户端中使用，可以启动 MCP 服务器：
# 内存模式（重启后丢失）
node dist/cli.js mcp
# 持久化模式
PLUGIN_DATA=/path/to/data node dist/cli.js mcp
设置验收标准¶
使用 set_acceptance_criteria 接口定义标准，需指定 role 参数：
// 示例：设置智能体自评标准
set_acceptance_criteria({ criteria: "...", role: "agent" })
设置任务计划¶
使用 set_task_plan 将目标分解为子任务列表。
注意事项¶
- 数据持久化：默认情况下，如果未设置环境变量
PLUGIN_DATA，插件状态仅在内存中运行，重启后丢失。 - 证据置信度：使用
text类型证据进行验证时，系统会自动标记lowConfidence=true。 - 运行机制：在 DSH 中，该插件通过
dist/dsh-plugin.js作为 Cordis 插件运行，利用agent.steer()强制控制流程。
总结¶
goal-acceptance 通过严格的验收标准锁定和证据驱动验证，为 DSH 插件生态中的工作流管理提供了底层保障。它将复杂的验证逻辑封装为零依赖的核心状态机，并与 MCP 标准和 Cordis 插件架构兼容。
