前言¶
DeepSeek Harness（DSH）的核心哲学是“一切皆插件”。在智能体开发流程中，直接从代码入手容易导致需求模糊或实现偏离预期。DSH 插件 dsh-spec 提供了一套 Spec-Driven Development（SDD）技能，将开发顺序调整为先写规格，再写代码，最后验收。
插件简介¶
这个插件由 rongyishuaige7 维护，是一个单包三技能的组合。它不提供代码生成功能，而是提供将 Idea 收敛为可执行的 Spec，再将 Spec 转化为实现和验收标准的能力。
核心功能¶
插件包含三个独立技能，通过自然语言触发。
dsh-spec-new：从 Idea 到 Spec¶
当需要开始一个新项目或需求变更时，使用该技能。触发词包括“帮我做一个 X”、“开个新项目”、“先写规格”或“需求变了”。它会生成 specs/ 目录，并写入 requirements.md（包含 Given/When/Then 验收标准）、design.md（设计思路）和 tasks.md（有序执行的任务列表）。
dsh-spec-implement：从 Spec 到 Code¶
当规格确认后，使用该技能。触发词包括“开始实现”、“按 spec 做”或“继续实现”。它会读取 tasks.md，并按顺序执行任务，将实现进度写回 Spec。
dsh-spec-validate：从 Spec 到 Acceptance¶
当需要验证实现是否符合预期时，使用该技能。触发词包括“验收”、“测试一下”或“验证”。它会将验收标准转化为可运行的检查项，并生成 specs/validation.md。
安装与启用¶
安装前请确保环境满足依赖要求：
* Node.js >= 22
* @deepseek-ai/cordis (^4.0.1)
安装命令如下：
dsh plugin --profile <name> add @rongyi7/dsh-spec
注：如果是通过 Git 安装，仓库必须包含 prepare 构建脚本。
典型用法¶
在 DSH 中按照以下步骤操作：
- 定义需求：输入“帮我做一个文件分享网站”。插件会创建
specs/目录，并填充requirements.md、design.md和tasks.md。 - 执行实现：输入“开始实现”。插件会按照
tasks.md中的顺序生成代码。 - 执行验收：输入“验收”。插件会生成
specs/validation.md，用于对照验收标准进行校验。
适用场景与注意¶
该插件适合需要在开发前明确规格、希望保持单一数据源（Spec）的开发者。使用时请注意：
* 插件以当前 DSH 进程的权限运行。
* 安装前建议查看源码与许可证。
* 社区目录（如 skillhub.cn）是独立站点，与 DeepSeek 或幻方无官方从属关系。
结语¶
Spec-Driven Development（SDD）让智能体开发更可控。dsh-spec 通过维护 specs/ 目录下的三个文件，实现了从需求到验收的闭环。更多细节可查阅其 GitHub 仓库。
