软件开发生命周期流程 brunodantas/sdlc-harness

sdlc-harness

一个 DeepSeek Harness 捆绑包，针对你自己服务的模型运行一种工程实践、其技能和规则。它是一个捆绑包，而非分支：底层基座被固定且从不修改，而本仓库添加了一个补丁层，提供一个人设，外加一条命令，用于从各上游以固定版本安装该实践的技能。

该实践是一个固定的构建流程。每一步都是一个技能，通过其裸名称调用：

flowchart TB
subgraph spec ["Spec"]
direction LR
A["/grill-with-docs"] --> B["/to-spec"] --> C["/to-tickets"]
end
subgraph ticket ["Each ticket, in its own context"]
direction LR
D["/to-cases"] --> E["/to-tests"] --> F["/implement"] --> G["/code-review"]
end
subgraph ship ["Ship"]
I["/build-pr"]
end
spec --> ticket --> ship

快速开始

按顺序执行六个步骤。不假定你具备任何 Claude Code 经验。

1. 服务一个模型。 任何 OpenAI 兼容的端点，只要其聊天模板声明支持工具即可。底层基座始终发送原生 tools 字段，且没有文本解析回退方案，因此未声明工具的模型无法在此运行。

2. 安装底层基座和 pnpm。 需要 Node 22 或更新版本；pnpm 是必需的，因为 dsh plugin 会通过 shell 调用它。

npm i -g @deepseek-ai/dsh@0.1.0-rc.7 pnpm

版本是刻意固定的：本捆绑包已针对 rc.7 验证，当安装器发现任何其他版本时会发出警告。

3. 克隆本仓库并将其添加到浏览器配置文件。

git clone https://github.com/brunodantas/sdlc-harness.git ~/sdlc-harness

dsh plugin --profile web add file:$HOME/sdlc-harness

使用 web 配置文件（首次使用时创建），而不是自己构建：它已经组合好了浏览器界面，而该界面无法单独安装。

4. 安装该实践。

node ~/sdlc-harness/bin/install.js

这会将每个技能以其固定版本获取到 ~/.dsh/skills，将该实践的规则写入 ~/.dsh/AGENTS.md，并将它们的按需参考文件放在旁边，即 ~/.dsh/practice-reference.md，在 ~/.dsh/skills.lock.json 中记录它解析到的内容，并生成一个名为 SDLC Harness 的 agent 预设。

5. 启动。 即使是本地服务器也需要一个密钥，任何非空字符串都可以满足。

DEEPSEEK_API_KEY=local-none DEEPSEEK_BASE_URL=http://localhost:8080/v1 dsh --profile web --port 7777

6. 选择预设。 打开打印出的 URL，并在会话的模式菜单中，选择 SDLC Harness 以替代标准模式。这不会持久化：未选择它而启动的会话会运行底层基座自身的人设和规则，并且在 agent 的行为让你察觉之前看起来完全相同。

然后通过其裸名称调用一个技能，例如 /to-cases path/to/spec.md，并用发送按钮发送（当技能自动补全打开时，按 Enter 不会发送）。

安装了什么四十项技能，被扁平化到一个无命名空间的根目录中：

- brunodantas/skills 位于 v0.2.0（cc6da61）：build-pr、harden-tests、 ilities、to-cases、to-tests
- mattpocock/skills 位于 v1.2.3（6acc160）：35 项技能；完整清单见 skills.manifest.json

两个来源均采用 MIT 许可，且未经修改地安装。它们的许可证随技能一同提供，并适用于你的副本；本仓库自身的 MIT 许可证仅涵盖此捆绑包。

已知缺口

最大的缺口是判断力，而非结构。结构一应俱全：技能会加载，规则会被读取，流程按实践规定的顺序运行。但在验收运行中，一个本地部署的 24B 模型跑完了整条链路，却冻结了一个不包含任何断言的测试文件。在信任此测试框架无人值守产出的任何内容之前，请先阅读 docs/worked-example.md。

其余内容，包括验收运行发现的所有其他问题，都在 docs/dsh-parity-delta.md 中。要点如下：

- 技能工具限制不起作用。 frontmatter 解析器会静默丢弃 allowed-tools，因此每项技能都会以完整的工具集运行。
- 钩子桥接未被组合。 此处不会运行 PostToolUse 或类似的自动化。
- 权限行为就是配置文件的默认值。 没有 acceptEdits 的等价物，且计划模式是建议性的，而非强制执行的。

其余内容所在位置

| 词汇表 | CONTEXT.md |
| 按优先级排列的架构特征 | docs/architecture.md |
| 具有约束力的决策 | docs/adr/ |
| 逐功能对照表 | docs/dsh-parity-map.md |
| 实测缺口 | docs/dsh-parity-delta.md |
| 一个工单，从开始到结束 | docs/worked-example.md |

许可证

MIT。见 LICENSE。