前言¶
在智能体开发中,一个常见的边界问题在于: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