convez.ai
MCP ServerAutomaçãoAvançado
dhslegen

Digital Delivery Team

dhslegen/digital-delivery-team

Equipe digital autônoma com decisões humanas: do briefing à produção

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que simula uma equipe digital completa para entrega end-to-end de produtos. Orquestra 9 agentes especializados (produto, PM, arquiteto, backend, frontend, QA, DevOps, revisor, integração) através de um fluxo de 6 fases com decisões humanas em pontos críticos, checkpoints automáticos, validação contínua e rastreabilidade total.

Instalação

$npx convez-ai dhslegen/digital-delivery-team

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
v0.9.20
Issues abertas
0
Contribuidores
1

Casos de uso

  • Entrega completa de aplicações full-stack com auditoria em cada fase
  • Automação de fluxo de desenvolvimento com validação contínua e checkpoints
  • Continuidade entre sessões via relay cross-session com histórico preservado

Veredito

Ferramenta ambiciosa que redefine a colaboração AI-humano em delivery de software, implementando rigor de processo (contract-first, decision-gates, validation-loops) raramente visto em plugins. Produção robusta com 548 testes passando, mas exige adoção de paradigma específico e Node 22+.

README

A tradução para o português deste README ainda está na fila.

digital-delivery-team

一人一队 · 全栈工程师的 AI 数字员工交付插件

为 Claude Code 提供 契约先行(Contract-First)+ 数字员工分工(Agent-Owned)+ 自动度量(Hooks-Driven)+ 人机协作(Decision-Gated) 的端到端交付工作流。一句话:从产品需求到上线交付,由数字员工接力完成,每个关键节点你都能介入决策,每个阶段自动度量,每条产物可追溯。

9 数字员工 · 21 命令 · 13 技能 · 8 类 Hook · 5 套技术栈预设 · 3 套 AI-native UI 通道 · 6-phase 开发范式 · 决策门 · 进度状态机 · 跨会话接力 · Node 22+ 零 npm 依赖

Tests License

历史变更与每个特性的引入版本见 CHANGELOG.md。


安装

通过 Claude Code 插件市场(推荐,零配置):

/plugin marketplace add https://github.com/dhslegen/digital-delivery-team
/plugin install digital-delivery-team@digital-delivery-team
/reload-plugins

Claude Code v2.1+ 会自动加载 hooks,无需修改 ~/.claude/settings.json。

安装后先做一次自检:

/digital-delivery-team:doctor

应见各项全部 ✅。任一未通过按提示处理。


5 分钟上手

cd your-project/
echo "我要做一个任务清单 Web App,支持看板视图和标签管理" > project-brief.md

回到 Claude Code 会话内:

/kickoff                    # 默认 interactive 模式:每个 phase 落盘后暂停决策门
/impl                       # 串行 /build-api → 决策门 → /build-web,每文件 validation
/integrate                  # 编排前后端联调(docker compose + db migrate + smoke)
/verify                     # 测试 + 评审并行
/ship                       # 文档 + 效率报告 + 打包

如果想要"一键自动"体验:

/kickoff --auto             # 跳过所有决策门,按串行 chain 一气呵成

完成后产出全部位于项目目录:

docs/prd.md  docs/wbs.md  docs/risks.md
docs/arch.md  docs/api-contract.yaml  docs/data-model.md
docs/build-api-exploration.md  docs/build-api-plan.md  docs/build-api-summary.md
docs/build-web-exploration.md  docs/build-web-plan.md  docs/build-web-summary.md
docs/external-integration-audit.md  docs/schema-alignment-audit.md
web/...  server/...  tests/test-report.md
docs/review-report.md  docs/efficiency-report.md
README.md  docs/deploy.md  docs/demo-script.md
.ddt/progress.json  .ddt/tech-stack.json  .ddt/checkpoints.log  .ddt/decisions.jsonl
delivery-<project-id>-<timestamp>.tar.gz   ← 一键交付包

中途随时 /preview <phase> 看摘要、/resume 看进度、/relay 导出接力 prompt。


三大核心能力

1. 6-phase 开发范式(去 subagent 黑盒)

/build-api 与 /build-web 在 main thread 内流式执行 6-phase:

EXPLORE  →  PLAN  →  APPROVE  →  IMPLEMENT  →  VERIFY  →  SUMMARY
   ↓         ↓         ↓            ↓             ↓         ↓
扫现状    生 plan   决策门      逐步写+测      全量测   落 summary
落盘     落盘      用户批准    每step checkpoint  契约对齐

关键约束:每写一个文件立即跑 build/lint/typecheck/test(skills/validation-loop);通过则 git commit checkpoint(skills/checkpoint-commit);失败立即停下让用户决策。

2. 决策门(去盲盒)

每个 phase 落盘后强制触发 AskUserQuestion 4 选项问卷:

  • 接受并继续 → 进入下一 phase
  • 修改某条具体内容 → 询问哪条 + 怎么改 → --refresh 增量
  • 新增内容 → 询问补什么 → --refresh
  • 重新生成 → 询问原因 → --refresh 重写

未传 --auto 时每个 phase 都暂停决策门——你不再是被动观察者,而是每个关键节点的决策者。

详见 skills/decision-gate/SKILL.md。

3. 跨会话接力(不失忆)

/relay                      # 输出 13 段式接力 prompt
                            # 自动注入 progress.json / tech-stack.json / git log / 关键产物路径

把屏幕输出整段复制到下一会话开头 → AI 读到完整背景 → 从 "Exact Next Step" 直接续作。同设备 / 不同设备 / 不同 AI 模型都能用。


命令矩阵

岗位命令(按角色,10 个)

岗位命令主要产物实现方式
产品/prddocs/prd.md(含 Given/When/Then 验收标准)product-agent
PM/wbsdocs/wbs.md + docs/risks.mdpm-agent
架构/designdocs/arch.md + docs/api-contract.yaml + docs/data-model.mdarchitect-agent
后端/build-apiserver/(含集成测试 + summary)main thread + 6-phase + skill
前端/build-webweb/(含 happy-path 测试 + summary)main thread + 6-phase + skill
测试/testtests/test-report.md(覆盖率 ≥ 70%)test-agent
评审/reviewdocs/review-report.md(阻塞/警告/建议三级)review-agent
修复/fixreview-report 条目逐条 patch(默认 dry-run)fix-agent
文档/packageREADME.md + docs/deploy.md + docs/demo-script.mddocs-agent
度量/reportdocs/efficiency-report.md(含洞察 + 优化建议)metrics-agent

/build-api /build-web 不再用 subagent 派发,改为 main thread 流式可见 + 每文件 validation。

编排命令(5 个)

命令等价于适用场景
/kickoff [--auto] [--preset]/prd → /wbs → /design新项目起手;默认 interactive
/impl [--web-only|--api-only] [--auto] [--module <name>]串行 /build-api → /build-web设计冻结后实现
/integrate [--reuse-stack] [--tear-down]docker compose up → db migrate → 启动 server/web → smoke前后端联调出包前一步
/verify/test ‖ /review(并行)实现完成后并行验收
/ship/package → /report + 打包 tar.gz交付出包

辅助命令(6 个)

命令用途
/fix [--severity blocker|warning|all] [--apply]按 review-report 修复,默认 dry-run
/design-brief从 PRD + 契约编译结构化 brief(10 字段 SSoT)
/design-execute --channel claude-design|figma|v0 [--bundle <path>|--url <share>]派发 brief 到外部 AI 设计工具,再摄取产物到 .ddt/design/<channel>/raw/
/preview <prd|wbs|design|impl|test|review|fix|package|report|all>输出指定 phase 关键摘要 + diff(决策门前快速扫一眼)
/resume显示当前进度 + 下一步建议(同会话恢复)
/relay [--out <path>]跨会话接力:13 段式 prompt 输出,复制到下一会话即可续作
/digital-delivery-team:doctor安装自检

技术栈选型

5 套预设(最快路径)

project-brief.md 中写 **技术栈预设**: <name>:

预设后端前端默认 AI 设计
java-modern ⭐Spring Boot 3.5 + MySQL 8 + Redis 7 + Maven + MyBatis-PlusReact 18 + Vite + Tailwind + shadcn-uiclaude-design
java-traditionalSpring Boot 2.7 + MySQL 5.7 + Maven + MyBatisVue 3 + Element Plusclaude-design
node-modernNest.js 10 + Postgres + PrismaNext.js 14 (App Router) + Tailwind + shadcn-uiv0
go-modernGin + Postgres + GORMReact 18 + Tailwind + shadcn-uiclaude-design
python-fastapiFastAPI + Postgres + SQLAlchemy + AlembicReact 18 + Tailwind + shadcn-uiclaude-design

Spring Initializr 等价问卷(推荐路径)

project-brief.md 中写 **技术栈预设**: interactive,跑 /kickoff 时 LLM 主动调用 AskUserQuestion 4 步问卷:

  1. 主语言栈(Java SpringBoot 3 / Node TS / Python FastAPI / Go)
  2. 数据库 + 缓存(PostgreSQL+Redis / MySQL+Redis / SQLite / MongoDB)
  3. 前端框架(React+Vite / Next.js 14 / Vue 3 / Angular 19)
  4. UI 组件库(动态:根据前端选项展示 tailwind+shadcn / antd / element-plus 等)

每个选项含 preview 字段展示完整 stack 摘要。

完整 22 分组 200+ 组件清单见 templates/tech-stack-options.yaml(吸收 https://start.spring.io 实测数据)。

优先级链

CLI flag → project-brief.md:技术栈预设字段 → 已存在的 .ddt/tech-stack.json → manifest 自动检测(pom.xml/package.json/go.mod/pyproject.toml)→ 默认 java-modern。

.ddt/tech-stack.json 是技术栈 SSoT,仅 bin/resolve-tech-stack.mjs 可写入;agent / LLM 直接编辑会被 PreToolUse hook 硬拦截。


AI-native UI 通道

工作流分两步:

/design-brief                                    # 从 PRD + 契约编译 10 字段 brief
/design-execute --channel <type> [...]           # 派发 brief 到外部工具 + 摄取产物
通道适用场景工作流要点
claude-design ⭐首选默认;用户已订阅 Claude,零成本零网络外发brief → claude.ai/design 迭代 → --bundle <zip> 摄取 → main thread 按 SKILL §7 改写
figma设计稿驱动brief → figma MCP 引导清单 → main thread 调 get_design_context → 转 React + Tailwind
v0Next.js 现代化 UIbrief → --url <share> → 解析 v0 share URL → npx shadcn add → 接 OpenAPI client

详细工作流见 skills/ai-native-design/SKILL.md。


架构概览

project-brief.md
    └─ /kickoff ────── product-agent   ──► docs/prd.md                   (决策门 ✅)
                  ├─── pm-agent        ──► docs/wbs.md + docs/risks.md   (决策门 ✅)
                  └─── architect-agent ──► docs/arch.md + docs/api-contract.yaml + docs/data-model.md
                                            (契约 lint 通过 + 决策门 ✅)

    └─ /impl ────── 【串行】
        ├─ /build-api  EXPLORE → PLAN → APPROVE → IMPLEMENT → VERIFY → SUMMARY
        │              (main thread + skills/backend-development)
        │              (每文件 validation-loop + checkpoint-commit)
        │              (VERIFY 阶段调 audit-external-integration:扫 brief §11 vs server 实际 client 类)
        │
        └─ /build-web  EXPLORE → PLAN → APPROVE → IMPLEMENT → VERIFY → SUMMARY
                       (main thread + skills/frontend-development)
                       (ai_design.type 决定 UI 来源;强制跑 generate-api-client 生成 types.ts)

    └─ /integrate ──── 启动 docker compose + db migrate + server + web + smoke
                       (编排前后端联调出包前一步)

    └─ /verify ─────── test-agent      ──► tests/test-report.md          (并行)
                  └─── review-agent    ──► docs/review-report.md         (并行)

    └─ /fix ────────── fix-agent       ──► 源码 patch + Fix Log

    └─ /ship ───────── docs-agent      ──► README.md + docs/deploy.md + docs/demo-script.md
                  └─── metrics-agent   ──► docs/efficiency-report.md
                                            + delivery-<id>-<ts>.tar.gz

插件目录

目录内容
agents/9 个数字员工子代理(product / pm / architect / design-brief / test / review / fix / docs / metrics)
commands/21 个命令(10 岗位 + 5 编排 + 6 辅助)
skills/13 个领域知识 + 范式包
hooks/8 类事件注册 + handlers + lib/
bin/36 个脚本(aggregate / report / progress / resume / relay / preview / emit-phase / emit-decision / doctor / generate-api-client / generate-external-client / audit-* / integrate-up / ...)
templates/模板(含 tech-stack-presets + tech-stack-options Spring Initializr 等价清单 + docker-compose 预设)
contexts/delivery.md全局交付上下文(agent 必读)
rules/delivery/Global Invariants 权威定义
tests/60 个测试文件(548 用例)
baseline/历史项目基准数据 + 估算规则

13 个 skill

Skill用途
acceptance-criteriaGiven/When/Then 验收标准写法
api-contract-firstOpenAPI 3.0 契约设计规范
efficiency-metrics度量基线 + 效率报告
delivery-packageREADME/deploy/demo 模板
ai-native-design3 套 AI 设计源工作流(claude-design / figma / v0)
backend-development后端实现知识包(替代 backend-agent)
frontend-development前端实现知识包(替代 frontend-agent)
validation-loop每文件 build/lint/test,失败立即停
checkpoint-commit每 step git commit + .ddt/checkpoints.log
decision-gate标准 4 选项决策门模板
relay跨会话接力 13 段式 prompt
ddt-brief-builderbrief 第零步:从原始需求文档构建结构化 brief
ddt-baseline-sync工时基线 baseline.locked.json 同步规则

度量与效率追踪

8 类自动 hook(零侵入,无需手动触发):

Hook 事件触发时机采集内容
SessionStart会话开始session_id / Node 版本 / 持久化 plugin-root marker / 自动 bootstrap project_id / progress 推断 / 注入 additionalContext
SessionEnd会话结束token 消耗 + 释放本会话 advisory lock
UserPromptSubmit用户输入抓 slash command 作 phase 标签 → 写 phase_start 事件
PreToolUse工具调用前工具名 / 文件路径 / Bash 头 / Task 时写 subagent_start + advisory lock + tech-stack.json 硬拦截 deny
PostToolUse工具调用后成功/失败 / 耗时 / 自动捕获 test-report.md 与 review-report.md 中的质量指标
PostToolUseFailure工具调用失败失败工具事件(与 PostToolUse 共享 handler)
SubagentStop子代理完成通过 lookback join 反查 PreToolUse 记录的 subagent_start,重建真实 name + duration
Stop每个 turn 结束关闭未闭合 phase + 后台触发 metrics 聚合 + progress.json infer

数据链路(watermark 增量 ingest):

hooks → ~/.claude/delivery-metrics/events.jsonl
    └─→ bin/aggregate.mjs (watermark 增量) → metrics.db
        └─ sessions / tool_calls / subagent_runs / phase_runs / quality_metrics
        └─ ingest_watermark / decisions
        └─→ bin/report.mjs → docs/efficiency-report.raw.md
            └─→ metrics-agent → docs/efficiency-report.md
                                 (工时缺失时严格判定"不可证明",禁止用 WBS 预估替代)

Baseline 文件(baseline/baseline.locked.json)首次 /report 自动封盘,封盘后不可变。


进度状态机与跨会话恢复

每个 DDT 项目在 .ddt/progress.json 维护一份状态机:

{
  "schema_version": 1,
  "project_id": "proj-xxx",
  "current_phase": "design",
  "last_activity_at": "2026-04-29T07:55:00Z",
  "phases": {
    "prd":     { "status": "completed",   "started_at": "...", "completed_at": "..." },
    "design":  { "status": "in_progress", "started_at": "...", "completed_at": null  },
    ...
  }
}

由 hook 全自动维护:

  • SessionStart:根据 docs/* 文件存在性 infer 状态
  • UserPromptSubmit:检测到岗位 phase 命令时标 in_progress
  • Stop:每个 turn 结束 infer,artifact 出现则标 completed

两种续作机制:

命令用途输出
/resume同会话/同设备恢复屏幕(briefing)
/relay跨会话/跨设备/跨 AI 接力13 段式 prompt(用户复制)

/relay 自动注入项目背景:项目 ID / 当前 phase / 已完成 phase / 技术栈摘要 / 关键产物路径 / git log / 未提交改动 + 等 LLM 补充 9 段(What WORKED / What Did NOT Work / Decisions / Next Step ...)。


退出码约定

Code含义来源
0成功所有命令
1前置条件未满足(必读文件缺失 / DDT_PLUGIN_ROOT 未解析 / 参数错误)各命令 Phase 1
2存在未解决 blocker(docs/blockers.md 中 resolved_at: null)bin/check-blockers.sh
3契约对齐失败(/design-execute 摄取的代码或 main thread 改写引入禁用模式)bin/check-contract-alignment.mjs
4OpenAPI lint 失败(schema 错误 / security 未声明等)/design、/impl、/kickoff
5OpenAPI lint 工具缺失(npx 不可用 / @redocly/cli 未装)同上

OpenAPI 契约 lint 是硬门禁:lint 不通过禁止推进到 /build-web、/build-api 或 /ship。


数据与隐私

  • 所有度量数据落在本地 ~/.claude/delivery-metrics/,不上报任何外部服务
  • 项目本地数据落在 .ddt/:progress.json / tech-stack.json / decisions.jsonl / checkpoints.log / locks/ / relay-*.md
  • Bash 命令仅记录前 80 字符;工具事件仅记录度量必需字段
  • 度量数据库(metrics.db)为本地 SQLite,可随时删除
  • 清空数据:rm -rf ~/.claude/delivery-metrics/

环境要求

项要求
Node.js≥ 22.0.0(使用内置 node:sqlite,零 npm 依赖)
Claude Codev2.1+(hook 自动加载 + AskUserQuestion 工具支持)
操作系统macOS / Linux / Windows(建议 WSL2)
可选工具@redocly/cli(OpenAPI lint,命令首次运行时 npx 自动拉取)
/integrate 联调Docker(含 docker-compose v2 plugin 或 v1/v5 standalone)+ Colima/Docker Desktop

可选环境变量

变量默认说明
DDT_METRICS_DIR~/.claude/delivery-metrics/度量数据目录
DDT_PROJECT_ID自动从 .ddt/project-id 读取当前项目 ID
DDT_HOOK_PROFILEstandardHook 档位:minimal / standard / strict
DDT_DISABLED_HOOKS空禁用指定 hook id(CSV,例:ddt:pre-tool-use)

度量脚本与 hook 开关都使用独立 DDT_* 命名空间,不读取其他插件命名空间的环境变量,也不依赖 MCP server 或远程上报。


故障排查

优先做这一步:

/digital-delivery-team:doctor

自检覆盖:Node 版本 / 插件 root / SessionStart marker / hooks.json 8 个事件注册 / events.jsonl 可写 / metrics.db 完整 / @redocly/cli 可用 / check-blockers.sh 权限 / 关键脚本完整 / 技术栈预设与 ai-native-design skill / progress.json 写入路径。

常见问题:

现象处理
Node ≥ 22 ❌nvm install 22 && nvm use 22
SessionStart marker ❌重启 Claude Code 会话(marker 由 SessionStart hook 自动写入)
@redocly/cli ❌确认网络可达;首次执行命令时 npx --yes @redocly/cli 会自动安装
progress.json 状态错误手动校正:node "$DDT_PLUGIN_ROOT/bin/progress.mjs" --update <phase> <status>
跨会话忘记进度/resume(同会话)或 /relay(跨会话)
efficiency-report 工时膨胀跑 node bin/aggregate.mjs --project <id> --rebuild 重建
/integrate docker compose 找不到自动 fallback:依次尝试 docker compose / docker-compose / colima docker compose

Testing

cd plugins/digital-delivery-team
npm test                  # 全量(548 个测试用例 / 60 个文件)
npm run test:unit         # 仅 unit
npm run test:integration  # 仅 integration

测试套覆盖维度:

维度内容
frontmatter / 配置完整性agents/skills/commands frontmatter 必填、hooks.json 合法性、plugin manifest
度量 v3 语义metrics-integrity / contract-integrity / refresh 增量语义 / phase-detection
Hook 集成全链路 aggregate → baseline → report、blocker 门禁、subagent lookback join、并发 appendEvent
进度状态机progress.mjs / resume.mjs / additionalContext 注入 / marker 自愈
决策门emit-decision skill + 决策门 + preview
技术栈5 级优先级链解析 + tech-stack-options + AskUserQuestion 4 步问卷 + tech-stack hard gate
6-phase 范式6-phase 结构 / skill 替代 agent / impl 串行
AI-native UI3 通道 brief 编译 + design-execute / channel package / ingest channels
实战 hotfixgitignore 模板 / blocker soft-hard / brief quality / baseline init / integration source / react lock / integrate / api-client driven / schema audit & design-contract feed / contract summary from yaml / external integration audit & client gen

相关文档

  • USAGE.md — 场景化使用示例
  • CHANGELOG.md — 版本变更记录(每个特性的引入版本)
  • ROADMAP.md — 通向 v1.0 的演进路线图(M1 实战闭环 / M2 生产就绪 / M3 团队协作 / M4 行业落地)
  • 设计原则:契约先行 + 数字员工分工 + 自动度量 + 决策门 + 6-phase 范式(EXPLORE/PLAN/APPROVE/IMPLEMENT/VERIFY/SUMMARY)
  • 数据来源:Spring Initializr 22 分组 200+ 组件清单 + Claude Code AskUserQuestion 工具 schema

反馈与贡献

  • 问题反馈:GitHub Issues
  • 功能建议:欢迎提 PR 或在 Issues 讨论
  • 安全问题:请直接邮件 dhslegle@gmail.com(不要在 Issues 公开)

许可:MIT · 作者:@dhslegen · 变更记录:CHANGELOG.md

Ver o original no GitHub

Bom para

Relacionados