在 DSH 环境中进行智能体开发时,从概念到验证的实现往往需要严谨的流程约束。dsh-specify-lite 提供了一个精简的、插件化的方式来管理驱动开发。它独立于 GitHub Spec-Kit,专注于在本地模型上实现,无需复杂的子智能体编排或繁重的 Git 操作。
它是什么¶
dsh-specify-lite 是一个精简的 DSH 原生插件,用于驱动开发(SDD)。由 MarcSierszen 维护。它解决了在没有外部依赖或 Git 变更的情况下,结构化实现路径的需求。该插件通过一系列命令将开发过程分解为可验证的步骤。
核心功能¶
- 驱动开发工作流:通过命令行命令管理规范、计划、任务和实施。
- 三件套模型:维护规范、计划和任务作为独立工件。
- 单模型执行:在一个智能体会话中运行,不使用子智能体或并行任务执行。
- Git 不可变性:不修改 Git 状态(无分支、提交、合并或变基)。
- 宪法与规范:支持定义项目级原则和功能规范。
- 计划与任务:生成技术计划和排序的任务列表。
- 质量分析:执行只读的质量审查。
- 实施与验证:实施批准的任务并记录验证证据。
安装与启用¶
安装插件需要使用 DSH 的插件管理器。请确保你的环境满足依赖要求。
dsh plugin --profile web add git+https://github.com/MarcSierszen/dsh-specify-lite.git
典型用法¶
安装完成后,可以在 DSH 会话中按顺序执行工作流命令。
- 初始化项目:在项目根目录运行
/speckit init。 - 定义宪法:运行
/speckit-constitution,输入项目原则(例如:使用 Python,先设计 API 契约,遵循 RESTful 规范)。 - 定义功能规范:运行
/speckit-specify,输入具体功能描述(例如:“添加健康检查端点:GET /health 返回 HTTP 200 和 JSON {"status":"ok"}”)。 - 生成技术计划:运行
/speckit-plan,要求生成保持契约的最小实现方案。 - 生成任务列表:运行
/speckit-tasks,获取排序的任务列表。 - 实施与验证:运行
/speckit-implement,插件将逐项实施并记录验证结果。
适用场景与注意¶
- 环境要求:插件依赖 Node.js 20 或更高版本。最低测试的 DSH 版本为 0.1.1-rc.2。
- 运行模式:插件设计为单模型运行,不涉及子智能体或并行任务,适合本地模型环境。
- Git 权限:插件在写入文件前会请求显式确认,且绝不执行 Git 变更操作。
- 任务 ID:任务使用稳定的 T001 风格 ID。
- 版本迁移:Version 0.2.0 引入了基于三件套模型的破坏性重新设计。使用 0.2.0 之前版本的项目,需要手动迁移工件(将功能目录移至
specs/,重命名specify.md为spec.md等)。
总结¶
dsh-specify-lite 通过提供一套独立的命令集,将驱动开发流程标准化。它通过 Git 不可变性和单模型执行,降低了在 DSH 中进行复杂项目管理的复杂度。