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
羽毛球分组比赛记分
小程序二维码

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

小夜