前言¶
在智能體開發中,一個常見的邊界問題在於:Agent 在代碼、證據、文檔、發佈狀態和聲明範圍尚未完全一致時,就宣稱工作完成。oukeming64-tech/codex-skills 旨在解決這一問題,它提供了一套基於證據優先的 Agent 技能,用於交接審計和文檔同步。
這是什麼¶
這是一個社區維護的 Skill-only bundle,專門針對 DeepSeek Harness 開發者預覽版。該插件包由 oukeming64-tech 維護,核心理念是確保代碼、證據、文檔和發佈狀態在 Agent 宣稱完成前保持一致。
核心功能¶
該插件包含兩個指令型技能:
- handoff-auditor:在接收、合併或宣佈交接完成前,審計實現交接的聲明。它將聲明與當前代碼、驗證證據、文檔、發佈狀態以及人工驗收要求進行比對。
- docs-sync-guardian:保持倉庫文檔與代碼、配置、資產、發佈或工作流變更保持一致。變更發生後,它會將文檔視爲可疑對象,並基於實時實現證據進行更新,同時設置人工判斷的風險關卡。
安裝與啓用¶
適配版本爲 @deepseek-ai/dsh@0.1.0-rc.6,需要 Node.js 環境 ^22.19.0 || >=24.0.0。
安裝插件到 Web profile:
dsh plugin --profile web add 'github:oukeming64-tech/codex-skills#dsh-v0.1.0'
卸載:
dsh plugin --profile web remove @oukeming64-tech/codex-skills
通過指令調用:
Use the handoff-auditor skill to verify this completion claim before accepting it.
Use the docs-sync-guardian skill to check this change for documentation drift.
適用場景與注意¶
- 適用場景:需要驗證另一個 Agent 或貢獻者的交接聲明,或者需要在代碼變更後強制檢查文檔漂移。
- 技術實現:該插件僅通過 Harness 的常規文件系統 Skill 提供者註冊
skills/目錄,屬於指令型技能。它不添加 MCP 服務器、網絡客戶端、憑據處理、遙測、後臺服務或安裝鉤子。 - 免責聲明:這是社區提供的 Skill-only bundle,並非 DeepSeek 官方產品,也不代表 DeepSeek 的背書。
總結¶
該插件爲 DeepSeek Harness 提供了一套輕量級的證據驗證機制。通過集成 handoff-auditor 和 docs-sync-guardian,可以降低交接時的遺漏風險,確保文檔與代碼同步。源碼位於 GitHub,可查閱使用。
- Source:
github:oukeming64-tech/codex-skills