Open Flow

OpenFlow-用于OpenCode的BMAD方法

备注 ：本项目实施了该方法 BMAD （建造更多，建筑师梦想）倾倒 开源代码 ❤️

配置存储库使用专门的代理、技能和MCP服务器实现BMAD方法，用于AI驱动的敏捷开发。

快速开始

# Clone the repository
git clone  ~/Projects/open-flow
cd ~/Projects/open-flow

# Install everything (agents, skills, MCP servers)
./install.sh

# Or install in a specific language
./install.sh install --lang=en   # English
./install.sh install --lang=fr   # French (default)

结构

open-flow/
├── agents/                          # Custom agents (i18n)
│   ├── fr/                          # French agents
│   │   ├── executeur.md
│   │   ├── quality.md
│   │   └── ...
│   └── en/                          # English agents
│       ├── executor.md
│       ├── quality.md
│       └── ...
├── skills/                          # Custom skills (i18n)
│   ├── fr/                          # French skills
│   │   └── /SKILL.md
│   └── en/                          # English skills
│       └── /SKILL.md
├── servers/                         # MCP servers
│   ├── notify/                      # Notification MCP server
│   │   ├── server.py                # MCP server (tool: ask_user)
│   │   ├── notifier.py              # PyObjC native notifications
│   │   └── configure.py             # Auto-configuration script
│   └── screenshot/                  # Screenshot MCP server
│       ├── server.py                # MCP server (tool: screenshot)
│       ├── screenshotter.py         # PyObjC screen capture
│       └── configure.py             # Auto-configuration script
├── roadmap/                         # Project roadmap
│   ├── README.md                    # Task tracking + methodology
│   └── plan-XX-*.md                 # Immutable implementation plans
├── maintenance/                     # Project health monitoring
│   ├── reports/                     # Generated health reports
│   ├── templates/                   # Report templates
│   └── metrics/                     # Metrics history (JSON)
├── install.sh                       # Installation script
├── AGENTS.fr.md                     # Global rules (French)
└── AGENTS.en.md                     # Global rules (English)

BMAD方法论（4个阶段）

BMAD =构建更多，建筑师梦想-人工智能驱动的敏捷开发方法

Phase 1: ANALYSIS (Optional)
    └─> Analyst → Product Brief, Research

Phase 2: PLANNING  
    └─> PM → PRD (Product Requirements Document)

Phase 3: SOLUTIONING
    ├─> UX Designer → UX Design
    ├─> Architect → Architecture Document
    └─> PM → Epics & User Stories

Phase 4: IMPLEMENTATION
    ├─> SM (Scrum Master) → Sprint Planning, Stories
    ├─> Dev (Developer) → Implementation (TDD)
    ├─> TEA (Test Architect) → Test Framework, Automation
    └─> Tech Writer → Documentation

QUICK FLOW (Alternative rapide)
    └─> Quick Flow → Tech Spec → Quick Dev → Code Review

BMAD生命周期

1. 分析 （可选）：头脑风暴、研究、产品简报
2. 规划 ：用户访谈→ PRD创建
3. 固溶 : UX → 建筑→ 史诗与故事
4. 实施 ：Sprint计划→ 故事创作→ TDD → 测试→ 审查
5. 快速流动 ：技术规格→ 实施→ 评论（倾倒娇小特征）

验证阶段

当Executeur完成实现时，它：

1. 启动应用程序(make run &)
2. 产生 测试场景 以具体行动
3. 向用户呈现验证清单
4. 通过以下方式通知 主控程序 ask_user
5. 迭代直到所有场景都通过

验证输出示例：

### Scenario 1 : [Main behavior]
1. Click on [element]
2. Enter [value] in field
3. **Expected** : [visible result]

### Scenario 2 : [Edge case]
1. [concrete action]
2. **Expected** : [expected behavior]

代理商BMAD

如何调用

# Analysis Phase
/analyst          # Business analysis, research, product brief

# Planning Phase
/pm               # Create PRD, epics & stories

# Solutioning Phase
/ux-designer      # UX design and wireframes
/architect        # Architecture document

# Implementation Phase
/sm               # Sprint planning, story creation
/dev              # TDD implementation
/tea              # Test framework, automation

# Documentation
/tech-writer      # Documentation, diagrams

# Quick Flow (alternative)
/quick-flow       # Rapid tech spec → implementation → review

# Orchestration
/bmad-master      # Guidance, task lists, workflow orchestration

MCP服务器

通知服务器（ask_user）

用于代理用户通信的本地macOS通知工具。

工具: ask_user

参数:

使用策略：仅在代理说明中明确指示时使用。

安装:

./install.sh mcp

这将：

1. 在中创建虚拟环境 servers/notify/.venv
2. 安装依赖项(mcp, pyobjc)
3. 配置 ~/.config/opencode/opencode.json

屏幕截图服务器

用于捕获屏幕和窗口的原生macOS屏幕截图工具。

工具: screenshot

参数:

需求：macOS屏幕录制权限。

技能BMAD

技能提供专业知识和通过以下方式加载的工作流程 /skill .

BMAD核心技能

OpenFlow基础架构技能

命令

安装路径

发展

改进代理

1. 编辑 .md 文件在 agents/
2. 跑 ./install.sh diff 查看更改
3. 跑 ./install.sh agents 安装
4. 在OpenCode中测试
5. 满意时承诺

提高技能

1. 编辑 SKILL.md 在 skills//
2. 跑 ./install.sh skills 安装
3. 测试用 /skill 在OpenCode中

改进MCP服务器

1. 编辑文件 servers/notify/
2. 跑 ./install.sh mcp 重新配置
3. 重新启动OpenCode以重新加载MCP服务器

备份系统

每次安装前都会自动创建备份：

~/.opencode-backups/
├── agents-YYYYMMDD_HHMMSS/
├── skills-YYYYMMDD_HHMMSS/
└── config-YYYYMMDD_HHMMSS/

最大备份大小：20MB（先删除最旧的）。

许可证

个性化配置-适应您的需求。