前言¶
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