# devt：Claude Code的多智能体开发工作流插件

> devt是一个为Claude Code设计的轻量级多智能体开发工作流插件，通过10个专业智能体（程序员、测试员、代码审查员等）协同工作，实现自动复杂度检测、闭环学习、记忆层管理和架构健康扫描等功能。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-13T08:14:23.000Z
- 最近活动: 2026-05-13T08:24:22.537Z
- 热度: 136.8
- 关键词: Claude Code, 多智能体, 开发工作流, AI辅助编程, 记忆层, 代码审查, 架构决策, Graphify, RAG, 闭环学习
- 页面链接: https://www.zingnex.cn/forum/thread/devt-claude-code
- Canonical: https://www.zingnex.cn/forum/thread/devt-claude-code
- Markdown 来源: ingested_event

---

# devt：Claude Code的多智能体开发工作流插件

## 项目概述

**devt**（development team的缩写）是一个为Claude Code设计的**多智能体开发工作流插件**。它将传统的单一AI编程会话分解为协调的专业智能体团队：程序员编写代码、测试员验证、代码审查员审计、文档编写员更新文档、架构师把控设计、复盘员提取经验教训。

与单一大提示不同，devt采用**命令→工作流→智能体**的架构，每个智能体专注、无状态、可替换。项目规则存储在`.devt/rules/`中而非硬编码，使其成为语言无关的通用开发框架。

---

## 核心设计哲学：解决三大痛点

### 1. 会话间失忆问题

**问题**：单一会话提示在上下文窗口滚动后遗忘所有架构决策。

**devt方案**：永久记忆层位于`.devt/memory/`，包含：
- **ADR**（架构决策记录）："我们始终使用X，从不使用Y"
- **CON**（概念）："这里的'session'是指请求链"
- **FLOW**（流程）："生产部署：PR→smoke→canary→staged rollout→pagerduty hold"
- **REJ**（拒绝记录）："Server-Sent Events：已拒绝（原因：cors_workarounds, mobile_battery_drain）"
- **LES**（经验教训）："当集成测试首次失败时，检查fixture seed顺序"

所有智能体在工作流启动时预加载记忆，REJ tombstones阻止重新提出已拒绝的方案。

### 2. 表面理解，缺乏判断

**问题**：单提示要么过度工程化单行修复，要么对重构考虑不足。

**devt方案**：**自动复杂度分层**（TRIVIAL → SIMPLE → STANDARD → COMPLEX）：

| 层级 | 流水线 | 自动检测条件 |
|-----|-------|-------------|
| TRIVIAL | 内联执行 → 验证门 | ≤3文件，无需决策 |
| SIMPLE | 实现 → 测试 → 审查 | 单文件，已知模式 |
| STANDARD | 扫描 → 实现 → 测试 → 审查 → 验证 → 文档 → 复盘 → 自动技能 | 多文件，现有模式 |
| COMPLEX | 自动研究 → 自动规划 → 扫描 → 架构 → 实现 → 测试 → 审查 → 验证 → 文档 → 复盘 → 策划 → 自动技能 | 新模式，架构决策 |

用户从不选择层级，devt自动检测。

### 3. 经验无法积累

**问题**：即使在一个项目中，经验也会随会话结束而丢失。

**devt方案**：**闭环学习循环**：
1. **提取**：复盘智能体从完成的工作中提取课程（4-filter质量门）→ `.devt/state/lessons.yaml`
2. **策划**：策划智能体应用5-filter（特异性、持久性、非显而易见性、证据、可操作性）→ `.devt/memory/lessons/LES-NNNN-slug.md`
3. **索引**：`memory index`重建FTS5数据库
4. **查询**：预飞简报在工作流启动时查询所有文档类型
5. **注入**：简报中的"相关操作经验"被注入程序员/测试员/代码审查员的上下文

---

## 10个专业智能体

| 智能体 | 职责 | 默认技能 |
|-------|------|---------|
| programmer | 编写代码 | codebase-scan, scratchpad, api-docs-fetcher, strategic-analysis, tdd-patterns, verification-patterns |
| tester | 编写测试 | scratchpad, tdd-patterns |
| code-reviewer | 审计代码 | code-review-guide, codebase-scan, scratchpad |
| docs-writer | 更新文档 | scratchpad |
| architect | 架构决策 | codebase-scan, architecture-health-scanner, api-docs-fetcher, strategic-analysis, complexity-assessment |
| retro | 提取经验 | lesson-extraction, autoskill |
| curator | 管理记忆 | memory-curation, autoskill |
| verifier | 验证实现 | codebase-scan, verification-patterns |
| researcher | 技术研究 | codebase-scan, strategic-analysis |
| debugger | 系统调试 | codebase-scan |

可选的**devt-coordinator**作为主线程路由器，自动将devt形状的任务路由到相应命令，其他对话直接回答。

---

## 记忆层：三层真相来源

记忆层连接三个真相来源：

1. **代码实际存在什么**：函数、类、模块（Graphify AST）
2. **当前会话发生什么**：临时观察（claude-mem的🎯决策/💡发现标签）
3. **项目永久规则**：我们始终做什么、拒绝什么（Markdown + SQLite FTS5）

### 两层两生命周期

```
.devt/state/              第1层 — 临时（每工作流）
  decisions.md            DEC-xxx — 澄清/指定/研究用的scratchpad
  lessons.yaml            复盘草稿 → 策划员批准后转为LES
  deferred.md             DEF-NNN 跨工作流TODO队列（重置豁免）
  preflight-brief.md      主题预飞简报（自动触发）
  scratchpad.md           跨智能体交接（#KNOWLEDGE-CANDIDATE）

.devt/memory/             第2层 — 永久（规范知识）
  decisions/              ADR-xxx — 宪法级决策
  concepts/               CON-xxx — 持久心智模型
  flows/                  FLOW-xxx — 命名序列（认证、部署等）
  rejected/               REJ-xxx — 墓碑（我们考虑过X，这是拒绝原因）
  lessons/                LES-xxx — 操作经验（"当X发生时，做Y"）
  _suggestions.md         发现提案（仅策划员写入）
  index.db                FTS5统一索引（gitignored，可重建）
```

---

## 预飞协议：两层防护

### 第一层：主题简报（自动）

每个devt工作流在context_init时自动触发`/devt:preflight "<task>"`。6通道编排器写入`.devt/state/preflight-brief.md`：

- **A通道**：`affects_paths` glob匹配
- **B通道**：FTS5关键词扩展
- **C通道**：`affects_symbols` AST匹配（Graphify启用时）
- **D通道**：wiki链接传递闭包（深度2）来自A+B+C种子
- **E通道**：`search_keywords`上的REJ tombstones重叠
- **F通道**：过滤`doc_type='lesson'`的管理文档渲染LES条目

8个devt智能体预加载`devt:memory-pre-flight`并先读简报。

### 第二层：文件守卫（PreToolUse）

智能体在每次Edit/Write前追加`PREFLIGHT <ts> edit <path> :: <governing IDs>`到scratchpad。`hooks/pre-flight-guard.sh`检查该行。

`memory.preflight_mode`：`off` / `warn` / `block`（默认**block**）。

---

## 工作流命令参考

### 主要入口

| 命令 | 用途 |
|-----|------|
| `/devt:do` | 不知道用哪个命令？描述需求，devt自动路由 |
| `/devt:workflow` | 构建、修复或改进任何东西。支持`--autonomous`、`--tdd`、`--dry-run` |
| `/devt:specify` | 通过访谈和代码库分析定义功能，产出验证过的PRD |
| `/devt:debug` | 四阶段系统调试（症状→假设→测试→修复） |

### 流程控制

| 命令 | 用途 |
|-----|------|
| `/devt:next` | 自动检测当前状态并执行下一步逻辑 |
| `/devt:ship` | 工作流完成后创建PR |
| `/devt:pause` / `/devt:resume` | 暂停和恢复工作流 |
| `/devt:defer` | 捕获TODO而不中断当前流程 |

### 决策支持

| 命令 | 用途 |
|-----|------|
| `/devt:council` | 5顾问并行压力测试高 stakes 决策 |
| `/devt:arch-health` | 架构健康扫描，检测跨会话的结构漂移 |

---

## 顾问团：对抗偏见

`/devt:council`召集5个并行顾问，每个有不同思考风格：

| 顾问 | 视角 | 提问示例 |
|-----|------|---------|
| Contrarian | 最坏情况？ | "负载下会崩溃什么？这个失败时的on-call成本是多少？" |
| First Principles | 问题实际要求什么？ | "剥离当前方案——我们真正想做什么？有更简单的原语吗？" |
| Generalizer | 什么潜在价值或模式适用？ | "其他团队解决过这个吗？能成为可重用模式吗？" |
| Newcomer | 什么显而易见但被忽略了？ | "这个为什么需要存在？初级开发者会假设什么？" |
| Pragmatist | 最小的具体下一步是什么？ | "即使计划完美，明天早上实际做什么？30分钟能实验什么来降低风险？" |

响应匿名化并**同行评审**（顾问不知道谁说了什么）。主席综合为：共识、冲突、盲点、建议、具体下一步。

---

## Graphify深度集成

对于安装Graphify的用户，表面级收益对比：

| 表面 | 无Graphify | 有Graphify |
|-----|-----------|-------------|
| 预飞简报C通道（符号解析） | grep `affects_symbols`文本字段 | 树解析器AST解析——知道`User`类与`User`类型别名不同 |
| `blast_radius()` MCP工具 | 回退到文件名匹配 | 通过`getNeighbors()`遍历实际导入图进行真实影响分析 |
| `memory validate`陈旧符号检查 | 无法检测——在重构后保留`affects_symbols: [renamedFn]` | 标记内存中不再存在的符号 |
| 代码搜索智能体（6个） | grep + 路径模式 | Graphify优先协议，代码搜索约节省10倍token |

---

## 安装与配置

### 通过Claude Code插件市场（推荐）

```
/plugin marketplace add emrecdr/devt
/plugin install devt
```

### 快速开始

```bash
/devt:init
```

脚手架生成`.devt/rules/`和`.devt/config.json`。devt自动检测你的技术栈并选择匹配模板。

**第一个工作流**：
```bash
/devt:workflow "add a health check endpoint at GET /health returning 200"
```

---

## 项目意义

devt代表了AI辅助开发的演进方向：

1. **从单一会话到持续学习**：经验跨会话积累，形成组织知识
2. **从通用提示到专业分工**：不同任务由最适合的智能体处理
3. **从被动响应到主动防护**：预飞协议防止错误决策进入代码库
4. **从个人工具到团队协作**：记忆层支持多开发者共享项目规范

对于希望系统性地引入AI辅助开发、同时保持代码质量和架构一致性的团队，devt提供了一个可落地、可扩展的框架。