前言¶
DeepSeek Harness (DSH) 採用插件化架構。在使用 OpenSpec 工作流技能時，開發者需要在 DSH 的技能註冊表中手動配置。dsh-openspec 插件解決了這一集成問題，它將 OpenSpec 的 12 個核心工作流技能註冊到 DSH 環境中，並提供了一組命令別名，便於用戶直接調用。
插件定位¶
這是一個基於 Cordis 的插件，由 dragonTalon 維護。它將 OpenSpec 的工作流技能以標準 kebab-case 命名註冊，使得 /openspec-xxx 命令能夠通過 DSH 的技能工具和用戶調用注入機制直接工作。
核心功能¶
該插件提供以下能力：
1. 12 個規範技能：註冊爲 openspec-* 形式的技能，既支持模型調用，也支持用戶調用。
2. 12 個命令別名：提供 /opsx-* 形式的命令別名，內容與上述規範技能完全一致，但僅限用戶調用。
3. 無運行時狀態：技能通過 DSH 的技能註冊表管理，不依賴額外的運行時狀態。
安裝與啓用¶
插件依賴 DSH 的核心依賴庫：@deepseek-ai/cordis、@deepseek-ai/dsh-invariants 和 @deepseek-ai/dsh-skill。
安裝插件到指定 profile：
dsh plugin --profile <name> add github:dragonTalon/dsh-openspec
或者添加到普通 Node 項目：
npm install github:dragonTalon/dsh-openspec
注意：通過 Git 安裝時，插件會通過
prepare腳本自動構建。如果使用pnpm，默認情況下會阻止 Git 依賴的構建腳本。如果構建失敗，需要在 profile 的pnpm-workspace.yaml中添加包名到allowBuilds列表。
典型用法¶
安裝後，可以通過以下方式使用：
- 規範調用：
/openspec-new-change、/openspec-explore等。 - 別名調用：
/opsx-new、/opsx-explore等。
如果不需要命令別名，可以在配置中關閉：
import * as dshOpenspec from '@dragon-talon/dsh-openspec'
ctx.plugin(dshOpenspec, { aliases: false })
技能列表¶
插件包含以下 12 個技能及其對應的別名：
| 規範技能 | 命令別名 | 描述 |
|---|---|---|
openspec-explore |
/opsx-explore |
進入探索模式，輔助探索想法、調查問題。 |
openspec-new-change |
/opsx-new |
使用實驗性工件工作流開始新的 OpenSpec 變更。 |
openspec-continue-change |
/opsx-continue |
通過創建下一個工件繼續處理 OpenSpec 變更。 |
openspec-apply-change |
/opsx-apply |
執行 OpenSpec 變更中的任務。 |
openspec-update-change |
/opsx-update |
修訂變更的現有規劃工件並保持一致性。 |
openspec-ff-change |
/opsx-ff |
快進通過 OpenSpec 工件創建。 |
openspec-propose |
/opsx-propose |
提出新的變更，一次性生成所有工件。 |
openspec-sync-specs |
/opsx-sync |
將變更的增量規範同步到主規範。 |
openspec-archive-change |
/opsx-archive |
歸檔已完成的變更。 |
openspec-bulk-archive-change |
/opsx-bulk-archive |
一次性歸檔多個已完成的變更。 |
openspec-verify-change |
/opsx-verify |
驗證實現是否與變更工件匹配。 |
openspec-onboard |
/opsx-onboard |
OpenSpec 的引導式入職。 |
注意事項¶
- 技能內容生成自 OpenSpec 倉庫的
skills/*/SKILL.md文件，當前版本鎖定 OpenSpec 1.10.0。 - 技能內容遵循 MIT 許可證。
總結¶
該插件爲 DeepSeek Harness 提供了開箱即用的 OpenSpec 工作流支持，通過標準化技能註冊和便捷的命令別名，簡化了在 DSH 環境中實施 OpenSpec 工作流的過程。
