DeepSeek Harness 插件:Agent PM

前言

DeepSeek Harness(DSH)采用「一切皆插件」的架构,通过 ctx.skills 宿主层注册技能,让每个 agent preset 都能调用这些能力。但写一个 agent preset 时,设计是否清晰、边界是否明确、验收标准是否完备,往往只有开发者自己知道。已有的代码审查工具大多关注实现细节,对「写的人以为说清楚了但其实没有」的设计问题关注不足。

Agent PM 是一个产品经理视角的 agent 项目审查工具,它不审查实现代码,而是审查设计层面的缺陷。把这套能力做成 DSH 插件后,每个 agent preset 都能在技能目录里看到并使用它。

这是什么

dsh-agent-pm 是 Agent PM 的 DeepSeek Harness 插件版本,由维护者 lbyxunxunnini 发布。它把 agent-pm 技能注册到 DSH 的 ctx.skills 宿主层,让每个 agent preset 都能在技能目录里看到并使用它。

Agent PM 的核心约束是 Iron Law:NO ISSUE REPORT WITHOUT EXECUTION VERIFICATION FIRST。这意味着在提出问题之前,必须先验证该问题在执行层面确实存在,避免空泛的审查意见。

核心功能

技能注册与发现

安装后,插件通过 cordis.patch.yml 注入技能提供者,在 DSH 的 ctx.skills 中注册 agent-pm 技能。插件只注册一个 provider,并读取 skills/agent-pm/ 下的 SKILL.md 和 references/ 目录。

审查对象

Agent PM 不审查实现代码,而是审查设计文档和配置文件:

  • Claude Code SKILL.md / DSH <name>/SKILL.md
  • CLAUDE.md / AGENTS.md / 指令文件
  • MCP Server
  • DSH 插件(技能包 / 工具 / 事件)

审查模式

模式 作用
A:审阅 按 checklist 做技术审查,输出问题报告
B:修复 修复已确认的 accepted 问题
C:新 Skill 澄清 在生成 SKILL.md 之前闭环目标、边界、流程和验收
D:产品评审 / 评分 三方评估、维度评分、目标治理分析

DSH 专项检查

插件额外读取 skills/agent-pm/references/dsh-plugin-review.md,检查插件清单、ctx 注册、资源路径和版本兼容声明。

目录结构

dsh-agent-pm/
├── package.json          # dsh.bundle 清单
├── cordis.patch.yml      # 插入技能提供者
├── lib/index.js          # ctx.skills 提供者
├── skills/agent-pm/
│   ├── SKILL.md
│   └── references/       # 审查清单、模式、示例、DSH 专项清单
└── scripts/verify.mjs    # 静态 + provider 级检查

安装与启用

本地目录

dsh plugin --profile web add /absolute/path/to/dsh-agent-pm

npm(发布后)

dsh plugin --profile web add dsh-agent-pm

GitHub

dsh plugin --profile web add github:lbyxunxunnini/dsh-agent-pm

建议锁定标签,避免后续提交改变实际运行内容:

dsh plugin --profile web add 'github:lbyxunxunnini/dsh-agent-pm#v0.1.0'

安装后启动对应的 profile:

dsh --profile web

验证安装

npm run verify

该命令不会启动 DSH,而是用最小 ctx stub 调用插件注册的 provider,验证插件只注册一个 provider、skills/agent-pm/SKILL.md 能被发现、多行 description: |- 能被正确解析、get() 能加载正文并返回目录型 resourceBase。

真实 DSH 验证建议使用隔离的 DSH_HOME:

export DSH_HOME=/tmp/dsh-agent-pm-test
dsh plugin --profile test add /absolute/path/to/dsh-agent-pm
dsh --profile test --dump-config
dsh --profile test

确认技能目录出现 agent-pm 后,再卸载并确认技能消失。

典型用法

在 DSH 会话里直接说:

用 agent-pm 审查这个项目

也可以在技能目录中选择 agent-pm。如果宿主支持斜杠命令,可以使用:

/agent-pm [path] [--score]

常用组合:

  • 审查并评分 → 审查后进入产品评分
  • 只评分 → 直接进入产品评审
  • 修复后评分 → 先修复已确认问题,再评分
  • 创建新 skill → 进入需求澄清模式

适用场景与注意

适合在开发 agent preset 时使用,帮助发现设计层面的模糊和缺失。插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。

权限与外部服务

  • 不发起网络请求。
  • 不读取环境变量、凭据或工作区之外的业务文件。
  • 运行时只读取包内 skills/agent-pm/ 下的 SKILL.md 和 references/。
  • 安装阶段没有 prepare 构建脚本;插件代码在 DSH 启动加载时执行。
  • 代码只使用 Node 内置模块,要求 Node.js >= 18。macOS 已实测;Windows / Linux 未实测。

版本要求

插件面向 DSH 0.2.1-rc.2 编写。DSH 目前是开发者预览,后续版本可能有破坏性变更;安装前请先核对版本。

短结尾

Agent PM 提供了一个产品经理视角的审查框架,帮助在编写 agent preset 时提前发现设计问题。通过 DSH 插件的形式,它可以直接集成到现有的工作流中,让每个 agent preset 都能方便地调用审查能力。

  • 目录页:https://www.skillhub.cn/plugins/lbyxunxunnini/dsh-agent-pm
  • GitHub:https://github.com/lbyxunxunnini/dsh-agent-pm
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye