使用说明
流程控制
代理工作流的编排+可观察性-具有MCP跟踪的多代理工作流系统。
概述
工作流控制是一个统一的系统，它：
- 编排 多代理工作流（阶段、子代理、协调）
- 轨迹 一切通过MCP工具+SQLite（决策、进度、文件）
- 想象 实时工作流（WebUI仪表板）
建筑
Monorepo结构 （pnpm工作区）
workflow-control/
├── packages/
│ ├── shared/ # Prisma schema + Types (source of truth)
│ ├── mcp-server/ # MCP Server (tools for orchestration & tracking)
│ └── web-ui/ # Next.js Dashboard
├── workflow-system/ # Workflow orchestration docs & templates
│ ├── docs/ # Architecture, templates, profiles
│ └── agents/ # workflow-architect agent
├── scripts/ # Setup & installation scripts
└── .claude/ # Dev config for this project
安装
先决条件
- Node.js 20+ (下载)
- pnpm (
npm install -g pnpm) - 版本控制系统
自动设置
# Clone the repository
git clone <repository-url>
cd workflow-control
# Run the setup script
./scripts/setup.sh
安装脚本将：
- 检查先决条件（Node.js 20+、pnpm、git）
- 安装依赖项
- 生成Prisma客户端
- 运行数据库迁移
- 构建项目
- 在中创建符号链接
~/.claude/全球访问
手动设置
# Install dependencies
pnpm install
# Generate Prisma client
pnpm db:generate
# Run database migrations
pnpm db:migrate
# Build the project
pnpm build:all
配置
MCP服务器配置
将工作流控件添加到项目的 .mcp.json:
# Interactive mode
./scripts/generate-mcp-config.sh
# Or specify the project path
./scripts/generate-mcp-config.sh ~/my-project
# Or manually create .mcp.json:
{
"mcpServers": {
"workflow-control": {
"command": "node",
"args": ["/path/to/workflow-control/packages/mcp-server/dist/index.js"]
}
}
}
克劳德代码符号链接
安装脚本为全局访问创建符号链接：
~/.claude/docs/workflow-system/ -> Workflow System documentation
~/.claude/agents/workflow-architect.md -> Workflow Architect agent
要手动管理符号链接，请执行以下操作：
# Create symlinks
./scripts/symlink.sh
# Force overwrite existing
./scripts/symlink.sh --force
# Remove symlinks
./scripts/symlink.sh --remove
用法
启动Web UI
pnpm dev:ui
开放时间：http://localhost:3000
验证MCP服务器
./scripts/verify-mcp.sh
# With verbose output
./scripts/verify-mcp.sh --verbose
MCP工具可用
| 工具 | 说明 |
|---|---|
start_workflow |
创建具有阶段的新工作流 |
complete_workflow |
用摘要完成工作流程 |
start_task |
在工作流中启动任务 |
complete_task |
用结果完成任务 |
log_decision |
记录架构决策 |
log_issue |
报告问题或阻塞 |
log_milestone |
标记里程碑式的成就 |
get_context |
查询工作流状态和历史记录 |
脚本参考
| 脚本 | 描述 |
|---|---|
./scripts/setup.sh |
完整安装和设置 |
./scripts/symlink.sh |
管理Claude符号链接 |
./scripts/generate-mcp-config.sh |
生成.mcp.json配置 |
./scripts/verify-mcp.sh |
测试MCP服务器连接 |
脚本选项
# Setup
./scripts/setup.sh --help
./scripts/setup.sh --silent # Non-interactive mode
./scripts/setup.sh --skip-build # Skip building
./scripts/setup.sh --skip-symlinks # Skip symlink creation
# Symlinks
./scripts/symlink.sh --help
./scripts/symlink.sh --force # Overwrite existing
./scripts/symlink.sh --remove # Remove symlinks
# MCP Config
./scripts/generate-mcp-config.sh --help
./scripts/generate-mcp-config.sh --stdout # Print to stdout
./scripts/generate-mcp-config.sh --force # Overwrite existing
# Verify
./scripts/verify-mcp.sh --help
./scripts/verify-mcp.sh --verbose # Detailed output
./scripts/verify-mcp.sh --timeout 30 # Custom timeout
技术栈
- MCP服务器：Node.js+TypeScript+@modelcontextprotocol/sdk
- 数据库：SQLite（本地，不需要外部服务器）
- 对象关系映射：Prisma（带TypeScript类型安全枚举）
- Web用户界面：Next.js 15+Socket.io（实时更新）
- Git集成：简单的git（快照/差异）
文档
技术文件在 .claude/docs/:
- architecture.md -系统架构
- mcp-tools.md -MCP工具规格
- 数据库.md -Prisma架构引用
- 标准.md -规范标准
工作流系统文档位于 workflow-system/docs/:
- architecture.md -工作流编排模式
- 模板/ -工作流和代理模板
- 配置文件/ -简单、标准和复杂的工作流配置文件
故障排除
未找到MCP服务器
# Rebuild the project
pnpm build:all
# Verify the binary exists
ls -la packages/mcp-server/dist/index.js
数据库错误
# Regenerate Prisma client
pnpm db:generate
# Reset and migrate database
pnpm db:migrate
Symlink问题
# Force recreate symlinks
./scripts/symlink.sh --force
# Check symlink targets
ls -la ~/.claude/docs/workflow-system
ls -la ~/.claude/agents/workflow-architect.md
验证一切正常
./scripts/verify-mcp.sh --verbose
卸载
# Remove symlinks
./scripts/symlink.sh --remove
# Remove database
rm packages/shared/prisma/dev.db
# Remove node_modules
rm -rf node_modules packages/*/node_modules
许可证：MIT
