前言¶
在 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 插件架構兼容。
