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